文件AEM 6.5使用手冊

將Postscript轉換為PDF檔案 converting-postscript-to-pdf-documents

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用對象：
  • Experience Manager 6.5
  • 主題：

建立對象：

  • 開發人員

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。

關於Distiller服務 about-the-distiller-service

Distiller®服務可將PostScript®、封裝式PostScript (EPS)和PRN檔案轉換為透過網路的精簡、可靠且更安全的PDF檔案。 Distiller服務通常用於將大量列印檔案轉換為電子檔案，例如發票和結算單。 將檔案轉換為PDF也可讓企業向客戶傳送檔案的書面版本和電子版本。

NOTE
如需Distiller服務的詳細資訊，請參閱AEM Forms服務參考。

將PostScript轉換為PDF檔案 converting-postscript-to-pdf-documents-inner

本主題說明如何使用Distiller服務API （Java和Web服務）以程式設計方式將PostScript (PS)、封裝的PostScript (EPS)和PRN檔案轉換為PDF檔案。

NOTE
如需Distiller服務的詳細資訊，請參閱AEM Forms服務參考。
NOTE
若要將PostScript檔案轉換為PDF檔案，必須在託管AEM Forms的伺服器上安裝下列其中一項： Acrobat 9或Microsoft Visual C++ 2005可轉散發套件。

步驟摘要 summary-of-steps

若要將任何支援的型別轉換成PDF檔案，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立Distiller服務使用者端。
  3. 擷取要轉換的檔案。
  4. 叫用PDF建立作業。
  5. 儲存PDF檔案。

包含專案檔

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請務必包含Proxy檔案。

建立Distiller服務使用者端

您必須先建立Distiller服務使用者端，才能以程式設計方式執行Distiller服務作業。 如果您使用Java API，請建立DistillerServiceClient物件。 如果您使用網站服務API，請建立DistillerServiceService物件。

擷取要轉換的檔案

擷取您要轉換的檔案。 例如，若要將PS檔案轉換為PDF檔案，您必須擷取PS檔案。

叫用PDF建立作業

建立服務使用者端後，您可以叫用PDF建立作業。 此操作需要有關要轉換檔案的資訊，包括目標檔案的路徑。

儲存PDF檔案

您可以將PDF檔案儲存為PDF檔案。

另請參閱

使用Java API將PostScript檔案轉換為PDF

使用網站服務API將PostScript檔案轉換為PDF

包含AEM Forms Java程式庫檔案

設定連線屬性

輸出服務API快速啟動

使用Java API將PostScript檔案轉換為PDF convert-a-postscript-file-to-pdf-using-the-java-api

使用PostScript Service API (Java)將Distiller檔案轉換為PDF檔案：

  1. 包含專案檔案。

    在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-distiller-client.jar。

  2. 建立Distiller服務使用者端。

    • 建立包含連線屬性的ServiceClientFactory物件。
    • 使用它的建構函式並傳遞ServiceClientFactory物件來建立DistillerServiceClient物件。

  3. 擷取要轉換的檔案。

    • 建立一個java.io.FileInputStream物件，代表要轉換的檔案，使用它的建構函式並傳遞字串值來指定檔案的位置。
    • 使用它的建構函式並傳遞java.io.FileInputStream物件來建立com.adobe.idp.Document物件。

  4. 叫用PDF建立作業。

    叫用DistillerServiceClient物件的createPDF方法，並傳遞下列值：

    • 代表要轉換之PS、EPS或PRN檔案的com.adobe.idp.Document物件
    • 包含要轉換之檔案名稱的java.lang.String物件
    • 包含要使用的Adobe PDF設定名稱的java.lang.String物件
    • 包含要使用的安全性設定名稱的java.lang.String物件
    • 選擇性的com.adobe.idp.Document物件，其中包含產生PDF檔案時要套用的設定
    • 包含要套用至PDF檔案之中繼資料資訊的可選com.adobe.idp.Document物件

    createPDF方法傳回包含新PDF檔案及可產生的記錄檔的CreatePDFResult物件。 記錄檔通常包含轉換請求產生的錯誤或警告訊息。

  5. 儲存PDF檔案。

    若要取得新建立的PDF檔案，請執行下列動作：

    • 叫用CreatePDFResult物件的getCreatedDocument方法。 這會傳回com.adobe.idp.Document物件。
    • 叫用com.adobe.idp.Document物件的copyToFile方法來擷取PDF檔案。

    同樣地，若要取得日誌檔案，請執行下列動作。

    • 叫用CreatePDFResult物件的getLogDocument方法。 這會傳回com.adobe.idp.Document物件。
    • 叫用com.adobe.idp.Document物件的copyToFile方法來擷取記錄檔案。

另請參閱

步驟摘要

快速入門(SOAP模式)：使用Java API將PostScript檔案轉換為PDF檔案

包含AEM Forms Java程式庫檔案

設定連線屬性

使用網站服務API將PostScript檔案轉換為PDF converting-a-postscript-file-to-pdf-using-the-web-service-api

使用PostScript服務API （Web服務）將Distiller檔案轉換為PDF檔案：

  1. 包含專案檔案。

    建立使用MTOM的Microsoft .NET專案。 確定您使用下列WSDL定義： http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1。

    note note
    NOTE
    將localhost取代為主控AEM Forms之伺服器的IP位址。

  2. 建立Distiller服務使用者端。

    • 使用預設建構函式建立DistillerServiceClient物件。

    • 使用System.ServiceModel.EndpointAddress建構函式建立DistillerServiceClient.Endpoint.Address物件。 將指定WSDL的字串值傳遞至AEM Forms服務（例如，http://localhost:8080/soap/services/DistillerService?blob=mtom）。 您不需要使用lc_version屬性。 當您建立服務參考時，會使用此屬性。 但是，請指定?blob=mtom以使用MTOM。

    • 取得DistillerServiceClient.Endpoint.Binding欄位的值，以建立System.ServiceModel.BasicHttpBinding物件。 將傳回值轉換為BasicHttpBinding。

    • 將System.ServiceModel.BasicHttpBinding物件的MessageEncoding欄位設為WSMessageEncoding.Mtom。 此值可確保使用MTOM。

    • 執行下列工作來啟用基本的HTTP驗證：

      • 將AEM表單使用者名稱指派給欄位DistillerServiceClient.ClientCredentials.UserName.UserName。
      • 將對應的密碼值指派給欄位DistillerServiceClient.ClientCredentials.UserName.Password。
      • 將常數值HttpClientCredentialType.Basic指派給欄位BasicHttpBindingSecurity.Transport.ClientCredentialType。
      • 將常數值BasicHttpSecurityMode.TransportCredentialOnly指派給欄位BasicHttpBindingSecurity.Security.Mode。

  3. 擷取要轉換的檔案。

    • 使用物件的建構函式建立BLOB物件。 此BLOB物件用來儲存要轉換成PDF檔案的檔案。
    • 建立System.IO.FileStream物件，方法為叫用其建構函式，並傳遞代表檔案位置和開啟檔案模式的字串值。
    • 建立位元組陣列以儲存System.IO.FileStream物件的內容。 您可以取得System.IO.FileStream物件的Length屬性來決定位元組陣列的大小。
    • 呼叫System.IO.FileStream物件的Read方法，並傳遞要讀取的位元組陣列、起始位置和資料流長度，以資料流資料填入位元組陣列。
    • 以位元組陣列的內容指派物件的MTOM屬性，填入BLOB物件。

  4. 叫用PDF建立作業。

    叫用DistillerServiceService物件的CreatePDF2方法，並傳遞下列必要值：

    • 代表要轉換之PS檔案的BLOB物件
    • 包含要轉換之檔案的路徑名稱的字串
    • 包含要使用的Adobe PDF設定的字串物件（例如，Standard）
    • 字串物件包含要使用的安全性設定（例如，No Security）
    • 選擇性的BLOB物件，其中包含產生PDF檔案時要套用的設定
    • 包含要套用至PDF檔案之中繼資料資訊的可選BLOB物件
    • 用來儲存PDF檔案的BLOB輸出引數
    • 用來儲存記錄檔的BLOB輸出引數

  5. 儲存PDF檔案。

    • 透過叫用它的建構函式來建立System.IO.FileStream物件。 傳遞代表已簽署PDF檔案的檔案位置以及開啟檔案的模式的字串值。
    • 建立位元組陣列，儲存CreatePDF2方法（輸出引數）傳回的BLOB物件的內容。 取得BLOB物件的MTOM資料成員的值，以填入位元組陣列。
    • 透過叫用它的建構函式並傳遞System.IO.FileStream物件來建立System.IO.BinaryWriter物件。
    • 呼叫System.IO.BinaryWriter物件的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入PDF檔案。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2