組裝加密的PDF文檔

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

您可以使用組合器服務使用密碼加密PDF文檔。使用密碼加密PDF檔案後，使用者必須指定密碼才能檢視Adobe Reader或Acrobat中的PDF檔案。要使用密碼加密PDF文檔，DDX文檔必須包含加密PDF文檔所需的加密元素值。

在本討論中，假定使用了以下DDX文檔。

 <?xml version="1.0" encoding="UTF-8"?>
 <DDX xmlns="https://ns.adobe.com/DDX/1.0/">
        <PDF result="EncryptLoan.pdf" encryption="userProtect">
         <PDF source="inDoc" />
     </PDF>
     <PasswordEncryptionProfile name="userProtect" compatibilityLevel="Acrobat7">
         <OpenPassword>AdobeOpen</OpenPassword>
        </PasswordEncryptionProfile>
 </DDX>

在此DDX文檔中，請注意源屬性被分配了值 inDoc. 在只將一個輸入PDF文檔傳遞到組合器服務並返回一個PDF文檔的情況下，您將調用 invokeOneDocument 操作，指定值 inDoc 至PDF來源屬性。叫用 invokeOneDocument 操作， inDoc 值是必須在DDX文檔中指定的預定義鍵。

相反地，當將兩個或更多輸入PDF文檔傳遞到組合器服務時，可以調用 invokeDDX 操作。在此情況下，將輸入PDF文檔的檔案名分配給 source 屬性。

加密服務不必是AEM表單安裝的一部分，即可使用密碼加密PDF檔案。請參閱加密和解密PDF文檔.

注意

有關組合器服務的詳細資訊，請參見 AEM Forms服務參考.

注意

有關DDX文檔的詳細資訊，請參見組合器服務和DDX參考.

步驟摘要

要組合加密的PDF文檔，請執行以下步驟：

包含專案檔案。
建立PDF組合器客戶端。
參考現有的DDX文檔。
參考不安全的PDF檔案。
設定運行時選項。
加密文檔。
保存加密的PDF文檔。

包含項目檔案

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

必須將以下JAR檔案添加到項目的類路徑中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-assembler-client.jar
adobe-utilities.jar(若AEM Forms部署在JBoss上則為必要)
jbossall-client.jar(若AEM Forms部署在JBoss上則為必要)

如果AEM Forms部署在JBoss以外的受支援J2EE應用程式伺服器上，您必須將adobe-utilities.jar和jbossall-client.jar檔案取代為AEM Forms所部署之J2EE應用程式伺服器專屬的JAR檔案。如需所有AEM Forms JAR檔案位置的相關資訊，請參閱包含AEM Forms Java程式庫檔案.

建立組合器客戶端

在以寫程式方式執行組合器操作之前，必須建立組合器服務客戶端。

參考現有的DDX文檔

必須引用DDX文檔來組合PDF文檔。例如，請考量本節中引入的DDX檔案。要加密PDF文檔，DDX文檔必須包含 PasswordEncryptionProfile 元素。

參考不安全的PDF文檔

不安全的PDF文檔必須被引用並傳遞到組合器服務以加密。如果引用已加密的PDF文檔，則會引發異常。

設定運行時選項

您可以設定運行時選項，以控制組合器服務在執行作業時的行為。例如，您可以設定一個選項，指示組合器服務在遇到錯誤時繼續處理作業。如需可設定的執行階段選項相關資訊，請參閱 AssemblerOptionSpec 類引用 AEM Forms API參考.

加密文檔

建立組合器服務客戶端後，請參考包含加密資訊的DDX文檔、引用不安全的PDF文檔和設定運行時選項，可以調用 invokeOneDocument 操作。因為只有一個輸入PDF文檔被傳遞到組合器服務（並且返回一個文檔），所以可以使用 invokeOneDocument 操作，而非 invokeDDX 操作。

保存加密的PDF文檔

如果僅將單個PDF文檔傳遞到組合器服務，則組合器服務將返回單個文檔而不是集合對象。也就是說，叫用 invokeOneDocument 操作時，將返回單個文檔。由於本節中引用的DDX文檔包含加密資訊，因此組合器服務返回使用密碼加密的PDF文檔。

另請參閱

包含AEM Forms Java程式庫檔案

設定連接屬性

以寫程式方式組合PDF文檔

使用Java API組合加密的PDF檔案

包含專案檔案。

在Java項目的類路徑中包含客戶端JAR檔案，如adobe-assembler-client.jar。
建立組合器客戶端。
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 AssemblerServiceClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
參考現有的DDX文檔。
- 建立 java.io.FileInputStream 表示DDX文檔的對象，方法是使用其建構子並傳遞指定DDX檔案位置的字串值。
- 建立 com.adobe.idp.Document 對象，使用其建構子並傳遞 java.io.FileInputStream 物件。
參考不安全的PDF檔案。
- 建立 java.io.FileInputStream 對象，方法是使用其建構子並傳遞不安全PDF文檔的位置。
- 建立 com.adobe.idp.Document 物件，並傳遞 java.io.FileInputStream 包含PDF文檔的對象。此 com.adobe.idp.Document 物件會傳遞至 invokeOneDocument 方法。
設定運行時選項。
- 建立 AssemblerOptionSpec 使用其建構子儲存執行時選項的物件。
- 通過調用屬於的方法來設定運行時選項以滿足您的業務需求 AssemblerOptionSpec 物件。例如，要指示組合器服務在發生錯誤時繼續處理作業，請調用 AssemblerOptionSpec 物件 setFailOnError 方法和傳遞 false.
加密文檔。

叫用 AssemblerServiceClient 物件 invokeOneDocument 方法，並傳遞下列值：
- A com.adobe.idp.Document 表示DDX文檔的對象。確保此DDX文檔包含值 inDoc (針對PDF來源元素)。
- A com.adobe.idp.Document 包含不安全PDF文檔的對象。
- A com.adobe.livecycle.assembler.client.AssemblerOptionSpec 指定運行時選項的對象，包括預設字型和作業日誌級別。
此 invokeOneDocument 方法傳回 com.adobe.idp.Document 包含密碼加密PDF文檔的對象。
保存加密的PDF文檔。
- 建立 java.io.File 物件，並確定副檔名為.pdf。
- 叫用 Document 物件 copyToFile 複製內容的方法 Document 物件。請確定您使用 Document 物件 invokeOneDocument 方法傳回。

另請參閱

快速入門（SOAP模式）:使用Java API組裝加密的PDF檔案

使用Web服務API組合加密的PDF文檔

包含專案檔案。

建立使用MTOM的Microsoft .NET專案。在設定服務引用時，請確保使用以下WSDL定義： http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

注意

取代 localhost 和托管AEM Forms之伺服器的IP位址。
建立組合器客戶端。
- 建立 AssemblerServiceClient 物件，使用其預設建構函式。
- 建立 AssemblerServiceClient.Endpoint.Address 物件，使用 System.ServiceModel.EndpointAddress 建構子。將指定WSDL的字串值傳遞至AEM Forms服務(例如 http://localhost:8080/soap/services/AssemblerService?blob=mtom)。您不需要使用 lc_version 屬性。建立服務參考時，會使用此屬性。
- 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 AssemblerServiceClient.Endpoint.Binding 欄位。將傳回值轉換為 BasicHttpBinding.
- 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。
- 通過執行以下任務來啟用基本HTTP身份驗證：
  - 將AEM表單使用者名稱指派給欄位 AssemblerServiceClient.ClientCredentials.UserName.UserName.
  - 為欄位分配相應的密碼值 AssemblerServiceClient.ClientCredentials.UserName.Password.
  - 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.
參考現有的DDX文檔。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存DDX文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示DDX文檔的檔案位置以及在中開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
參考不安全的PDF檔案。
- 建立 BLOB 物件，使用其建構子。此 BLOB 對象用於儲存輸入PDF文檔。此 BLOB 物件會傳遞至 invokeOneDocument 作為引數。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示輸入PDF文檔的檔案位置以及在中開啟檔案的模式。
- 建立位元組陣列，用於儲存 System.IO.FileStream 物件。您可以取得 System.IO.FileStream 物件 Length 屬性。
- 叫用 System.IO.FileStream 物件 Read 方法，並傳遞位元組陣列、起始位置及流長度以讀取。
- 填入 BLOB 對象，通過賦值 MTOM 位元組陣列內容的欄位。
設定運行時選項。
- 建立 AssemblerOptionSpec 使用其建構子儲存執行時選項的物件。
- 為屬於的資料成員指定值，以設定運行時選項以滿足您的業務需求 AssemblerOptionSpec 物件。例如，要指示組合器服務在發生錯誤時繼續處理作業，請分配 false 到 AssemblerOptionSpec 物件 failOnError 資料成員。
加密文檔。

叫用 AssemblerServiceClient 物件 invokeOneDocument 方法，並傳遞下列值：
- A BLOB 表示DDX文檔的對象
- A BLOB 表示不安全PDF文檔的對象
- 安 AssemblerOptionSpec 指定運行時選項的對象
此 invokeOneDocument 方法傳回 BLOB 包含加密PDF文檔的對象。
保存加密的PDF文檔。
- 建立 System.IO.FileStream 對象，方法是調用其建構子並傳遞一個字串值，該字串值表示加密PDF文檔的檔案位置以及在中開啟檔案的模式。
- 建立位元組陣列，用於儲存 BLOB 物件 invokeOneDocument 方法傳回。取得 BLOB 物件 MTOM 資料成員。
- 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
- 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。