使用PDF公用程式

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

關於PDF公用程式服務

PDF公用程式服務可以在PDF和XDP檔案格式之間轉換、設定和擷取PDF檔案屬性，以及操作XMP中繼資料。 例如，在將PDF檔案轉換為另一種格式之前，檢查其屬性以決定要叫用哪個服務操作來進行轉換很有用。

您可以使用「PDF公用程式」服務完成這些工作：

• 將PDF檔案轉換為XDP檔案。
• 將XDP檔案轉換為PDF檔案。 (請參閱 將XDP檔案轉換為PDF檔案.)
• 擷取PDF檔案屬性。 (請參閱 正在擷取PDF檔案屬性.)
• 儲存PDF檔案並將其最佳化以快速檢視網頁。 (請參閱 設定PDF檔案儲存模式.)

將PDF檔案轉換為XDP檔案

您可以使用PDF公用程式Java和Web服務API，以程式設計方式將PDF檔案轉換為XDP檔案。

步驟摘要

若要將PDF檔案轉換為XDP檔案，請執行下列步驟：

1. 包含專案檔案。
2. 建立PDFUtilityService使用者端
3. 叫用PDF到XDP的轉換操作。

包含專案檔案

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

建立PDFUtilityService客戶端

您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可透過建立 PDFUtilityServiceClient 物件。 使用Web服務API時，這是透過使用 PDFUtilityServiceService 物件。

叫用PDF到XDP的轉換操作

建立服務使用者端後，您可以叫用PDF到XDP的轉換操作。

另請參閱

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

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

包含AEM Forms Java程式庫檔案

設定連線屬性

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

使用PDF公用程式API (Java)將PDF檔案轉換為XDP檔案：

1. 包含專案檔案

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

2. 建立PDFUtilityService客戶端

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

3. 叫用PDF到XDP的轉換操作

   若要執行轉換，請叫用 PDFUtilityServiceClient 物件的 convertPDFtoXDP 方法並傳入 com.adobe.idp.Document 代表PDF檔案的物件。 方法會傳回 com.adobe.idp.Document 物件，代表新建立的XDP檔案。

另請參閱

將PDF檔案轉換為XDP檔案

包含AEM Forms Java程式庫檔案

設定連線屬性

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

使用PDF公用程式API （Web服務）將PDF檔案轉換為XDP檔案：

1. 包含專案檔案

   • 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
   • 參考Microsoft .NET使用者端元件。

2. 建立PDFUtilityService客戶端

   建立 PDFUtilityServiceService 物件（使用proxy類別建構函式）。

3. 叫用PDF到XDP的轉換操作

   叫用 PDFUtilityServiceService 物件的 convertPDFtoXDP 方法並傳入 BLOB 代表PDF檔案的物件。 方法會傳回 BLOB 物件，代表新建立的XDP檔案。

另請參閱

將PDF檔案轉換為XDP檔案

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的.NET使用者端元件

將XDP檔案轉換為PDF檔案

您可以使用PDF公用程式Java和Web服務API，以程式設計方式將XDP檔案轉換為PDF檔案。

步驟摘要

若要將XDP檔案轉換為PDF檔案，請執行下列步驟：

1. 包含專案檔案。
2. 建立PDFUtilityService使用者端
3. 叫用XDP以PDF轉換作業。

包含專案檔案

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

建立PDFUtilityService客戶端

您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可透過建立 PDFUtilityServiceClient 物件。 使用Web服務API時，這是透過使用 PDFUtilityServiceService 物件。

叫用XDP以PDF轉換作業

建立服務使用者端後，您可以叫用XDP以PDF轉換作業。

另請參閱

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

使用Web服務API將XDP檔案轉換為PDF檔案

包含AEM Forms Java程式庫檔案

設定連線屬性

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

使用PDF公用程式API (Java)將XDP檔案轉換為PDF檔案：

1. 包含專案檔案

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

2. 建立PDFUtilityService客戶端

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

3. 叫用XDP以PDF轉換作業

   若要執行轉換，請叫用 PDFUtilityServiceClient 物件的 convertXDPtoPDF 方法並傳入 com.adobe.idp.Document 代表XDP檔案的物件。 方法會傳回 com.adobe.idp.Document 物件，代表新建立的PDF檔案。

另請參閱

將XDP檔案轉換為PDF檔案

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API將XDP檔案轉換為PDF檔案

使用PDF公用程式API （Web服務API）將XDP檔案轉換為PDF檔案：

1. 包含專案檔案

   • 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
   • 參考Microsoft .NET使用者端元件。

2. 建立PDFUtilityService客戶端

   建立 PDFUtilityServiceService 物件（使用proxy類別建構函式）。

3. 叫用XDP以PDF轉換作業

   若要執行轉換，請叫用 PDFUtilityServiceService 物件的 convertXDPtoPDF 方法並傳入 BLOB 代表XDP檔案的物件。 方法會傳回 BLOB 物件，代表新建立的PDF檔案。

另請參閱

將XDP檔案轉換為PDF檔案

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的.NET使用者端元件

正在擷取PDF檔案屬性

您可以使用PDF公用程式Java和Web服務API以程式設計方式擷取PDF檔案屬性，例如檔案是可填寫的表單還是讀取檔案所需的最低Acrobat版本。

步驟摘要

若要擷取PDF檔案屬性，請執行下列步驟：

1. 包含專案檔案。
2. 建立PDFUtilityService使用者端
3. 叫用屬性擷取作業。

包含專案檔案

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

建立PDFUtilityService客戶端

您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行「PDF公用程式」作業。 使用Java API時，可透過建立 PDFUtilityServiceClient 物件。 使用Web服務API時，可使用 PDFUtilityServiceService 物件。

叫用屬性擷取作業

建立服務使用者端後，您可以叫用屬性擷取作業。

另請參閱

使用Java API擷取PDF檔案屬性

使用Web服務API擷取PDF檔案屬性

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Java API擷取PDF檔案屬性

使用PDF公用程式API (Java)擷取PDF檔案屬性：

1. 包含專案檔案

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

2. 建立PDFUtilityService客戶端

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

3. 叫用屬性擷取作業

   若要執行轉換，請叫用 PDFUtilityServiceClient 物件的 getPDFProperties 方法並傳遞下列專案：

   • A com.adobe.idp.Document 代表PDF檔案的物件。
   • A PDFPropertiesOptionSpec 包含要評估之屬性的物件。

   方法會傳回 PDFPropertiesResult 包含查詢結果的物件。

另請參閱

正在擷取PDF檔案屬性

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API擷取PDF檔案屬性

使用PDF公用程式Web服務API擷取PDF檔案屬性：

1. 包含專案檔案

   • 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
   • 參考Microsoft .NET使用者端元件。

2. 建立PDFUtilityService客戶端

   建立 PDFUtilityServiceService 物件（使用proxy類別建構函式）。

3. 叫用屬性擷取作業

   若要執行轉換，請叫用 PDFUtilityServiceService 物件的 getPDFProperties 方法並傳遞下列專案：

   • A BLOB 代表PDF檔案的物件。
   • A PDFPropertiesOptionSpec 包含要評估之屬性的物件。

   方法會傳回 PDFPropertiesResult 包含查詢結果的物件。

另請參閱

正在擷取PDF檔案屬性

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的.NET使用者端元件

設定PDF檔案儲存模式

您可以使用PDF公用程式服務Java和Web服務API，以程式設計方式設定PDF檔案的儲存模式。 使用「PDF公用程式」服務設定儲存模式時，「PDF公用程式」服務只會設定儲存模式，而不會實際儲存PDF檔案。 當PDF檔案傳遞至另一個服務作業時，就會儲存該檔案。 例如，您可以使用「PDF公用程式」服務來設定特定的儲存模式，並將其傳遞給「加密」服務，以實際儲存並加密PDF檔案。

步驟摘要

若要設定PDF檔案的儲存選項，請執行下列步驟：

1. 包含專案檔案。
2. 建立PDFUtilityService使用者端
3. 設定儲存模式。
4. 叫用儲存作業。
5. 將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 模式。

另請參閱

使用Java API設定PDF檔案儲存選項

使用Web服務API設定PDF檔案儲存選項

包含AEM Forms Java程式庫檔案

設定連線屬性

使用密碼加密PDF檔案

使用Java API設定PDF檔案儲存選項

使用PDF公用程式API (Java)設定PDF檔案儲存選項：

1. 包含專案檔案

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

2. 建立PDFUtilityService客戶端

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

3. 設定儲存模式

   • 建立 PDFUtilitySaveMode 物件（使用其建構函式）。
   • 透過叫用 PDFUtilitySaveMode 物件的 setSaveStyle 方法並傳遞字串值，以指定儲存模式。 例如，若要儲存以快速檢視Web，請傳遞 FAST_WEB_VIEW.

4. 叫用儲存樣式作業

   叫用 PDFUtilityServiceClient 物件的 setSaveMode 方法並傳遞下列值：

   • A com.adobe.idp.Document 代表PDF檔案的物件。
   • A PDFUtilitySaveMode 包含要使用的儲存樣式的物件。
   • Boolean值，用來決定是否覆寫先前的設定。

   方法會傳回 com.adobe.idp.Document 使用指定的儲存樣式格式化物件。

5. 將PDF檔案傳遞至另一個AEM Forms作業

   • 傳遞傳回的 com.adobe.idp.Document 物件至另一個AEM Forms作業。

另請參閱

設定PDF檔案儲存模式

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Web服務API設定PDF檔案儲存選項

使用PDF公用程式AP （Web服務）設定PDF檔案儲存選項：

1. 包含專案檔案

   • 建立使用PDF公用程式服務WSDL檔案的Microsoft .NET使用者端元件。
   • 參考Microsoft .NET使用者端元件。

2. 建立PDFUtilityService客戶端

   建立 PDFUtilityServiceService 物件（使用proxy類別建構函式）。

3. 設定儲存模式

   • 建立 PDFUtilitySaveMode 物件（使用其建構函式）。
   • 將字串值指派給，以設定儲存模式 PDFUtilitySaveMode 物件的 saveStyle 指定儲存模式的方法。 例如，若要儲存以快速檢視Web，請指定 FAST_WEB_VIEW.

4. 叫用儲存樣式作業

   叫用 PDFUtilityServiceService 物件的 setSaveMode 方法並傳遞下列值：

   • A BLOB 代表PDF檔案的物件。
   • A PDFUtilitySaveMode 包含要使用的儲存樣式的物件。
   • Boolean值，用來決定是否覆寫先前的設定。

   方法會傳回 BLOB 使用指定的儲存樣式格式化物件。 然後您可以將該物件儲存為PDF檔案。

5. 將PDF檔案傳遞至另一個Forms作業

   • 傳遞傳回的 BLOB 物件至另一個AEM Forms作業。

另請參閱

設定PDF檔案儲存模式

使用Base64編碼叫用AEM Forms

建立使用Base64編碼的.NET使用者端元件

清除PDF檔案

您可以使用PDF公用程式Java API以程式設計方式將PDF檔案轉換為XDP檔案。

步驟摘要

若要處理PDF檔案，請執行下列步驟：

1. 包含專案檔案。
2. 建立PDFUtilityService使用者端
3. 叫用清理作業。

包含專案檔案

將必要的檔案納入您的開發專案中。 若要使用Java建立使用者端應用程式，請包含必要的JAR檔案。

建立PDFUtilityService客戶端

您必須先建立PDFUtilityService使用者端，才能以程式設計方式執行清理作業。 使用Java API時，可透過建立 PDFUtilityServiceClient 物件。

叫用PDF到XDP的轉換操作

建立服務使用者端後，您可以叫用清理作業。

另請參閱

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

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

包含AEM Forms Java程式庫檔案

設定連線屬性

使用Java API處理PDF檔案

使用PDF公用程式API (Java)整理檔案：

1. 包含專案檔案

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

2. 建立PDFUtilityService客戶端

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

3. 叫用PDF到XDP的轉換操作

   若要執行轉換，請叫用 PDFUtilityServiceClient 物件的 convertPDFtoXDP 方法並傳入 com.adobe.idp.Document 代表PDF檔案的物件。 方法會傳回 com.adobe.idp.Document 物件，代表新建立的XDP檔案。

另請參閱

清除PDF檔案

包含AEM Forms Java程式庫檔案

設定連線屬性