本檔案中的範例和範例僅適用於JEE環境上的AEM Forms 。
Distiller®服務可透過網路將PostScript®、Encapsulated PostScript (EPS)和PRN檔案轉換為緊湊、可靠且更安全的PDF檔案。 Distiller服務通常用於將大量列印檔案轉換為電子檔案,例如發票和結算單。 將檔案轉換為PDF也可讓企業向客戶傳送檔案的書面版本和電子版本。
如需Distiller服務的詳細資訊,請參閱 AEM Forms的服務參考.
本主題說明如何使用Distiller服務API (Java和Web服務)以程式設計方式將PostScript (PS)、Encapsulated PostScript (EPS)和PRN檔案轉換為PDF檔案。
如需Distiller服務的詳細資訊,請參閱 AEM Forms的服務參考.
若要將PostScript檔案轉換成PDF檔案,必須在託管AEM Forms的伺服器上安裝下列其中一項功能: Acrobat 9或Microsoft Visual C++ 2005可轉散發套件。
若要將任何支援的型別轉換為PDF檔案,請執行下列步驟:
包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
建立Distiller服務使用者端
您必須先建立Distiller服務使用者端,才能以程式設計方式執行Distiller服務操作。 如果您使用Java API,請建立 DistillerServiceClient
物件。 如果您使用Web服務API,請建立 DistillerServiceService
物件。
擷取要轉換的檔案
您必須擷取要轉換的檔案。 例如,若要將PS檔案轉換為PDF檔案,您必須擷取PS檔案。
叫用PDF建立作業
建立服務使用者端後,您可以叫用PDF建立作業。 此操作將需要有關要轉換檔案的資訊,包括目標檔案的路徑。
儲存PDF檔案
您可以將PDF檔案儲存為PDF檔案。
另請參閱
使用Distiller Service API (Java)將PostScript檔案轉換為PDF檔案:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-distiller-client.jar。
建立Distiller服務使用者端。
ServiceClientFactory
包含連線屬性的物件。DistillerServiceClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。擷取要轉換的檔案。
java.io.FileInputStream
物件,代表要轉換的檔案,使用它的建構函式並傳遞字串值,指定檔案的位置。com.adobe.idp.Document
物件,使用它的建構函式並傳遞 java.io.FileInputStream
物件。叫用PDF建立作業。
叫用 DistillerServiceClient
物件的 createPDF
方法並傳遞下列值:
com.adobe.idp.Document
代表要轉換之PS、EPS或PRN檔案的物件java.lang.String
包含要轉換之檔案名稱的物件java.lang.String
包含要使用的Adobe PDF設定名稱的物件java.lang.String
包含要使用的安全性設定名稱的物件com.adobe.idp.Document
包含產生PDF檔案時要套用之設定的物件com.adobe.idp.Document
包含要套用至PDF檔案之中繼資料資訊的物件此 createPDF
方法傳回 CreatePDFResult
包含新PDF檔案和可能產生的記錄檔的物件。 記錄檔通常包含轉換請求產生的錯誤或警告訊息。
儲存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檔案
使用Distiller服務API (Web服務)將PostScript檔案轉換為PDF檔案:
包含專案檔案。
建立使用MTOM的Microsoft .NET專案。 請確定您使用下列WSDL定義: http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.
Replace localhost
搭配裝載AEM Forms之伺服器的IP位址。
建立Distiller服務使用者端。
建立 DistillerServiceClient
物件(使用其預設建構函式)。
建立 DistillerServiceClient.Endpoint.Address
物件,使用 System.ServiceModel.EndpointAddress
建構函式。 將指定WSDL的字串值傳遞至AEM Forms服務(例如, http://localhost:8080/soap/services/DistillerService?blob=mtom
.) 您不需要使用 lc_version
屬性。 當您建立服務參考時,會使用此屬性。 不過,請指定 ?blob=mtom
以使用MTOM。
建立 System.ServiceModel.BasicHttpBinding
物件,方法是取得 DistillerServiceClient.Endpoint.Binding
欄位。 將傳回值轉換為 BasicHttpBinding
.
設定 System.ServiceModel.BasicHttpBinding
物件的 MessageEncoding
欄位至 WSMessageEncoding.Mtom
. 此值可確保使用MTOM。
執行下列工作來啟用基本HTTP驗證:
DistillerServiceClient.ClientCredentials.UserName.UserName
.DistillerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
至欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
至欄位 BasicHttpBindingSecurity.Security.Mode
.擷取要轉換的檔案。
BLOB
物件(使用其建構函式)。 此 BLOB
物件可用來儲存要轉換成PDF檔案的檔案。System.IO.FileStream
物件,方法是叫用其建構函式,並傳遞代表檔案位置和開啟檔案模式的字串值。System.IO.FileStream
物件。 您可以取得 System.IO.FileStream
物件的 Length
屬性。System.IO.FileStream
物件的 Read
方法,並傳遞位元組陣列、起始位置以及要讀取的資料流長度。BLOB
物件,透過指派其 MTOM
具有位元組陣列內容的屬性。叫用PDF建立作業。
叫用 DistillerServiceService
物件的 CreatePDF2
方法並傳遞下列必要值:
BLOB
代表要轉換之PS檔案的物件Standard
)No Securit
y)BLOB
包含產生PDF檔案時要套用之設定的物件BLOB
包含要套用至PDF檔案之中繼資料資訊的物件BLOB
用來儲存PDF檔案的輸出引數BLOB
用來儲存記錄檔的輸出引數儲存PDF檔案。
System.IO.FileStream
物件(透過叫用其建構函式)。 傳遞代表已簽署PDF檔案的檔案位置和開啟檔案的模式的字串值。BLOB
物件,由 CreatePDF2
方法(輸出引數)。 透過取得 BLOB
物件的 MTOM
資料成員。System.IO.BinaryWriter
物件,方法是叫用其建構函式並傳遞 System.IO.FileStream
物件。System.IO.BinaryWriter
物件的 Write
方法並傳遞位元組陣列。另請參閱