將Postscript轉換為PDF檔案

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

關於Distiller服務

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

將PostScript轉換為PDF檔案

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

步驟摘要

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

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

包含專案檔案

在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

建立Distiller服務客戶端

在以寫程式方式執行Distiller服務操作之前，必須建立Distiller服務客戶端。 如果您使用Java API，請建立DistillerServiceClient物件。 如果您使用web service API，請建立DistillerServiceService物件。

擷取要轉換的檔案

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

叫用PDF建立作業

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

儲存PDF檔案

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

另請參閱

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

使用web service API將PostScript檔案轉換為PDF

包含AEM FormsJava庫檔案

設定連接屬性

Output Service API快速入門

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

使用Distiller服務API(Java)將PostScript檔案轉換為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對象，包含要轉換的檔案名
   • java.lang.String物件，其中包含要使用的Adobe PDF設定名稱
   • java.lang.String物件，其中包含要使用的安全設定名稱
   • 可選com.adobe.idp.Document物件，包含在產生PDF檔案時要套用的設定
   • 可選com.adobe.idp.Document物件，包含要套用至PDF檔案的中繼資料資訊

   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 FormsJava庫檔案

設定連接屬性

使用web service API將PostScript檔案轉換為PDF

使用Distiller服務API(web service)將PostScript檔案轉換為PDF檔案：

1. 包含專案檔案。

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

   注意

   將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檔案時要套用的設定
   • 可選BLOB物件，包含要套用至PDF檔案的中繼資料資訊
   • 用於儲存PDF文檔的BLOB輸出參數
   • 用於儲存日誌的BLOB輸出參數

5. 儲存PDF檔案。

   • 通過調用System.IO.FileStream對象的建構子建立對象。 傳遞一個字串值，代表已簽署PDF檔案的檔案位置以及開啟檔案的模式。
   • 建立一個位元組陣列，用於儲存CreatePDF2方法（輸出參數）返回的BLOB對象的內容。 獲取BLOB對象MTOM資料成員的值，以填充位元組陣列。
   • 調用System.IO.BinaryWriter對象的建構子並傳遞System.IO.FileStream對象，以建立對象。
   • 調用System.IO.BinaryWriter物件的Write方法並傳遞位元組陣列，將位元組陣列的內容寫入PDF檔案。

另請參閱

步驟摘要

使用MTOM叫用AEM Forms

使用SwaRef叫用AEM Forms