使用PDF公用程式 working-with-pdf-utilities
本檔案中的範例和範例僅適用於JEE環境上的AEM Forms。
關於PDF公用程式服務
PDF公用程式服務可以在PDF和XDP檔案格式之間轉換、設定和擷取PDF檔案屬性，以及操作XMP中繼資料。 例如，在將PDF檔案轉換為另一種格式之前，檢查其屬性以判斷要為轉換叫用的服務操作會很有用。
您可以使用「PDF公用程式」服務完成這些工作：
- 將PDF檔案轉換為XDP檔案。
- 將XDP檔案轉換為PDF檔案。 (請參閱將XDP檔案轉換為PDF檔案。)
- 擷取PDF檔案屬性。 (請參閱擷取PDF檔案內容。)
- 儲存PDF檔案並加以最佳化，以快速檢視網頁。 (請參閱設定PDF檔案儲存模式。)
將PDF檔案轉換為XDP檔案 converting-pdf-documents-into-xdp-documents
您可以使用PDF公用程式Java和Web服務API，以程式設計方式將PDF檔案轉換為XDP檔案。
步驟摘要 summary-of-steps
若要將PDF檔案轉換為XDP檔案，請執行下列步驟：
- 包含專案檔案。
- 建立PDFUtilityService使用者端
- 叫用PDF到XDP的轉換操作。
包含專案檔
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。
建立PDFUtilityService使用者端
您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可藉由建立PDFUtilityServiceClient物件來完成。 使用Web服務API時，可使用PDFUtilityServiceService物件來完成。
叫用PDF到XDP轉換作業
建立服務使用者端後，您可以叫用PDF到XDP的轉換作業。
另請參閱
使用Java API將PDF檔案轉換為XDP檔案 convert-pdf-documents-into-xdp-documents-using-the-java-api
使用PDF公用程式API (Java)將PDF檔案轉換為XDP檔案：
-
包含專案檔案
在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-pdfutility-client.jar。
-
建立PDFUtilityService客戶端
使用它的建構函式並傳遞包含連線屬性的
ServiceClientFactory物件來建立PDFUtilityServiceClient物件。 -
叫用PDF到XDP的轉換操作
若要執行轉換，請叫用
PDFUtilityServiceClient物件的convertPDFtoXDP方法，並傳入代表PDF檔案的com.adobe.idp.Document物件。 此方法會傳回代表新建立之XDP檔案的com.adobe.idp.Document物件。
另請參閱
使用網站服務API將PDF檔案轉換為XDP檔案 convert-pdf-documents-into-xdp-documents-using-the-web-service-api
使用PDF公用程式API （Web服務）將PDF檔案轉換為XDP檔案：
-
包含專案檔案
- 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
- 參考Microsoft .NET使用者端元件。
-
建立PDFUtilityService客戶端
使用您的Proxy類別建構函式建立
PDFUtilityServiceService物件。 -
叫用PDF到XDP的轉換操作
叫用
PDFUtilityServiceService物件的convertPDFtoXDP方法，並傳入代表PDF檔案的BLOB物件。 此方法會傳回代表新建立之XDP檔案的BLOB物件。
另請參閱
將XDP檔案轉換為PDF檔案 converting-xdp-documents-into-pdf-documents
您可以使用PDF公用程式Java和Web服務API，以程式設計方式將XDP檔案轉換為PDF檔案。
步驟摘要 summary_of_steps-1
若要將XDP檔案轉換為PDF檔案，請執行下列步驟：
- 包含專案檔案。
- 建立PDFUtilityService使用者端
- 叫用XDP以PDF轉換作業。
包含專案檔
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。
建立PDFUtilityService使用者端
您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可藉由建立PDFUtilityServiceClient物件來完成。 使用Web服務API時，可使用PDFUtilityServiceService物件來完成。
叫用XDP以PDF轉換作業
建立服務使用者端後，您可以叫用XDP以PDF轉換作業。
另請參閱
使用Java API將XDP檔案轉換為PDF檔案 convert-xdp-documents-into-pdf-documents-using-the-java-api
使用PDF公用程式API (Java)將XDP檔案轉換為PDF檔案：
-
包含專案檔案
在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-pdfutility-client.jar。
-
建立PDFUtilityService客戶端
使用它的建構函式並傳遞包含連線屬性的
ServiceClientFactory物件來建立PDFUtilityServiceClient物件。 -
叫用XDP以PDF轉換作業
若要執行轉換，請叫用
PDFUtilityServiceClient物件的convertXDPtoPDF方法，並傳入代表XDP檔案的com.adobe.idp.Document物件。 此方法會傳回代表新建立PDF檔案的com.adobe.idp.Document物件。
另請參閱
使用網站服務API將XDP檔案轉換為PDF檔案 converting-xdp-documents-into-pdf-documents-using-the-web-service-api
使用PDF公用程式API （Web服務API）將XDP檔案轉換為PDF檔案：
-
包含專案檔案
- 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
- 參考Microsoft .NET使用者端元件。
-
建立PDFUtilityService客戶端
使用您的Proxy類別建構函式建立
PDFUtilityServiceService物件。 -
叫用XDP以PDF轉換作業
若要執行轉換，請叫用
PDFUtilityServiceService物件的convertXDPtoPDF方法，並傳入代表XDP檔案的BLOB物件。 此方法會傳回代表新建立PDF檔案的BLOB物件。
另請參閱
正在擷取PDF檔案屬性 retrieving-pdf-document-properties
您可以使用PDF公用程式Java和Web服務API以程式設計方式擷取PDF檔案屬性，例如檔案是可填寫表單還是讀取檔案所需的最低Acrobat版本。
步驟摘要 summary_of_steps-2
若要擷取PDF檔案屬性，請執行下列步驟：
- 包含專案檔案。
- 建立PDFUtilityService使用者端
- 叫用屬性擷取作業。
包含專案檔
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。
建立PDFUtilityService使用者端
您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可藉由建立PDFUtilityServiceClient物件來完成。 使用Web服務API時，可使用PDFUtilityServiceService物件來完成。
叫用屬性擷取作業
建立服務使用者端之後，您可以叫用屬性擷取作業。
另請參閱
使用Java API擷取PDF檔案屬性 retrieve-pdf-document-properties-using-the-java-api
使用PDF公用程式API (Java)擷取PDF檔案屬性：
-
包含專案檔案
在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-pdfutility-client.jar。
-
建立PDFUtilityService客戶端
使用它的建構函式並傳遞包含連線屬性的
ServiceClientFactory物件來建立PDFUtilityServiceClient物件。 -
叫用屬性擷取作業
若要執行轉換，請叫用
PDFUtilityServiceClient物件的getPDFProperties方法，並傳入下列專案：- 代表PDF檔案的
com.adobe.idp.Document物件。 - 包含要評估之屬性的
PDFPropertiesOptionSpec物件。
方法傳回包含查詢結果的
PDFPropertiesResult物件。 - 代表PDF檔案的
另請參閱
使用Web服務API擷取PDF檔案屬性 retrieve-pdf-document-properties-using-the-web-service-api
使用PDF公用程式Web服務API擷取PDF檔案屬性：
-
包含專案檔案
- 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
- 參考Microsoft .NET使用者端元件。
-
建立PDFUtilityService客戶端
使用您的Proxy類別建構函式建立
PDFUtilityServiceService物件。 -
叫用屬性擷取作業
若要執行轉換，請叫用
PDFUtilityServiceService物件的getPDFProperties方法，並傳入下列專案：- 代表PDF檔案的
BLOB物件。 - 包含要評估之屬性的
PDFPropertiesOptionSpec物件。
方法傳回包含查詢結果的
PDFPropertiesResult物件。 - 代表PDF檔案的
另請參閱
設定PDF檔案儲存模式 setting-pdf-document-save-modes
您可以使用PDF公用程式服務Java和Web服務API，以程式設計方式設定PDF檔案的儲存模式。 使用「PDF公用程式」服務設定儲存模式時，「PDF公用程式」服務只會設定儲存模式，實際上並不會儲存PDF檔案。 當PDF檔案傳遞給另一個服務作業時會儲存該檔案。 例如，您可以使用「PDF公用程式」服務來設定特定的儲存模式，並將其傳遞給「加密」服務，以實際儲存和加密PDF檔案。
步驟摘要 summary_of_steps-3
若要設定PDF檔案的儲存選項，請執行下列步驟：
- 包含專案檔案。
- 建立PDFUtilityService使用者端
- 設定儲存模式。
- 叫用儲存作業。
- 將PDF檔案傳遞給另一個作業。
包含專案檔
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。 如果您使用Web服務，請確定您包含Proxy檔案。
建立PDFUtilityService使用者端
您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可藉由建立PDFUtilityServiceClient物件來完成。 使用Web服務API時，可使用PDFUtilityServiceService物件來完成。
設定儲存模式
您可以選擇下列其中一個儲存選項：
INCREMENTAL：若要遞增儲存，以減少儲存所需的時間FAST_WEB_VIEW：儲存以供快速網頁檢視FULL：若要使用完整儲存進行儲存（沒有最佳化）
叫用儲存樣式作業
建立服務使用者端之後，您可以叫用屬性擷取作業。
將PDF檔案傳遞給另一個AEM Forms作業
一旦「PDF公用程式」服務設定指定的「儲存」模式後，請將PDF檔案傳遞給另一個AEM Forms作業。 從操作返回後，PDF檔案會以指定模式儲存。 例如，如果您使用PDF公用程式服務設定FAST_WEB_VIEW模式，然後將PDF檔案傳遞給加密服務的encryptUsingPassword作業，則傳回的PDF檔案會以密碼加密，並儲存為FAST_WEB_VIEW模式。
FAST_WEB_VIEW模式，然後將PDF檔案傳遞給加密服務的encryptUsingPassword作業。另請參閱
使用Java API設定PDF檔案儲存選項 set-pdf-document-save-options-using-the-java-api
使用PDF公用程式API (Java)設定PDF檔案儲存選項：
-
包含專案檔案
在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-pdfutility-client.jar。
-
建立PDFUtilityService客戶端
使用它的建構函式並傳遞包含連線屬性的
ServiceClientFactory物件來建立PDFUtilityServiceClient物件。 -
設定儲存模式
- 使用物件的建構函式建立
PDFUtilitySaveMode物件。 - 透過叫用
PDFUtilitySaveMode物件的setSaveStyle方法並傳遞指定儲存模式的字串值來設定儲存模式。 例如，若要儲存以快速檢視網頁，請傳遞FAST_WEB_VIEW。
- 使用物件的建構函式建立
-
叫用儲存樣式作業
叫用
PDFUtilityServiceClient物件的setSaveMode方法，並傳遞下列值：- 代表PDF檔案的
com.adobe.idp.Document物件。 - 包含要使用的儲存樣式的
PDFUtilitySaveMode物件。 - Boolean值，用來決定是否覆寫先前的設定。
此方法會傳回使用指定儲存樣式格式化的
com.adobe.idp.Document物件。 - 代表PDF檔案的
-
將PDF檔案傳遞至另一個AEM Forms作業
- 將傳回的
com.adobe.idp.Document物件傳遞給另一個AEM Forms作業。
- 將傳回的
另請參閱
使用Web服務API設定PDF檔案儲存選項 set-pdf-document-save-options-using-the-web-service-api
使用PDF公用程式AP （Web服務）設定PDF檔案儲存選項：
-
包含專案檔案
- 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
- 參考Microsoft .NET使用者端元件。
-
建立PDFUtilityService客戶端
使用您的Proxy類別建構函式建立
PDFUtilityServiceService物件。 -
設定儲存模式
- 使用物件的建構函式建立
PDFUtilitySaveMode物件。 - 將字串值指派給
PDFUtilitySaveMode物件指定儲存模式的saveStyle方法，以設定儲存模式。 例如，若要儲存以快速檢視網頁，請指定FAST_WEB_VIEW。
- 使用物件的建構函式建立
-
叫用儲存樣式作業
叫用
PDFUtilityServiceService物件的setSaveMode方法，並傳遞下列值：- 代表PDF檔案的
BLOB物件。 - 包含要使用的儲存樣式的
PDFUtilitySaveMode物件。 - Boolean值，用來決定是否覆寫先前的設定。
此方法會傳回使用指定儲存樣式格式化的
BLOB物件。 然後您可以將該物件儲存為PDF檔案。 - 代表PDF檔案的
-
將PDF檔案傳遞至另一個Forms作業
- 將傳回的
BLOB物件傳遞給另一個AEM Forms作業。
- 將傳回的
另請參閱
清除PDF檔案 sanitizing-pdf-documents
您可以使用PDF公用程式Java API以程式設計方式將PDF檔案轉換為XDP檔案。
步驟摘要 summary_of_steps-4
若要處理PDF檔案，請執行下列步驟：
- 包含專案檔案。
- 建立PDFUtilityService使用者端
- 叫用清理作業。
包含專案檔
將必要的檔案納入您的開發專案中。 若要使用Java建立使用者端應用程式，請包含必要的JAR檔案。
建立PDFUtilityService使用者端
您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行清理作業。 使用Java API時，可藉由建立PDFUtilityServiceClient物件來完成。
叫用PDF到XDP轉換作業
建立服務使用者端後，您可以叫用清理作業。
另請參閱
使用Java API處理PDF檔案 sanitize-pdf-documents-using-the-java-api
使用PDF公用程式API (Java)整理檔案：
-
包含專案檔案
在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-pdfutility-client.jar。
-
建立PDFUtilityService客戶端
使用它的建構函式並傳遞包含連線屬性的
ServiceClientFactory物件來建立PDFUtilityServiceClient物件。 -
叫用PDF到XDP的轉換操作
若要執行轉換，請叫用
PDFUtilityServiceClient物件的convertPDFtoXDP方法，並傳入代表PDF檔案的com.adobe.idp.Document物件。 此方法會傳回代表新建立之XDP檔案的com.adobe.idp.Document物件。
另請參閱