使用Web服務API拆解PDF文檔

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

使用組合器服務API（web服務）拆解PDF文檔：

1. 包含專案檔案。

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

   注意

   將localhost取代為托管AEM Forms之伺服器的IP位址。

2. 建立PDF組合器客戶端。

   • 使用其預設建構子建立AssemblerServiceClient物件。

   • 使用System.ServiceModel.EndpointAddress建構子建立AssemblerServiceClient.Endpoint.Address物件。 將指定WSDL的字串值傳遞到AEM Forms服務（例如http://localhost:8080/soap/services/AssemblerService?blob=mtom）。 您不需要使用lc_version屬性。 建立服務參考時，會使用此屬性。

   • 獲取AssemblerServiceClient.Endpoint.Binding欄位的值，建立System.ServiceModel.BasicHttpBinding對象。 將傳回值轉換為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。

3. 參考現有的DDX文檔。

   • 使用其建構子建立BLOB物件。 BLOB對象用於儲存DDX文檔。
   • 調用System.IO.FileStream對象的建構子以建立對象。 傳遞一個字串值，該字串值表示DDX文檔的檔案位置以及開啟檔案的模式。
   • 建立儲存System.IO.FileStream對象內容的位元組陣列。 通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
   • 調用System.IO.FileStream對象的Read方法並傳遞要讀取的位元組陣列、啟動位置和流長度，以流資料填充位元組陣列。
   • 為MTOM物件指派包含位元組陣列內容的屬性，以填入BLOB物件。

4. 參考要拆卸的PDF文檔。

   • 使用其建構子建立BLOB物件。 BLOB對象用於儲存輸入的PDF文檔。 此BLOB物件會以引數的形式傳遞至invokeOneDocument。
   • 通過調用其建構子並傳遞一個字串值來建立System.IO.FileStream對象，該字串值表示輸入PDF文檔的檔案位置以及開啟檔案的模式。
   • 建立儲存System.IO.FileStream對象內容的位元組陣列。 通過獲取System.IO.FileStream對象的Length屬性，可以確定位元組陣列的大小。
   • 調用System.IO.FileStream對象的Read方法並傳遞要讀取的位元組陣列、啟動位置和流長度，以流資料填充位元組陣列。
   • 為MTOM欄位指定位元組陣列的內容，以填入BLOB物件。
   • 建立MyMapOf_xsd_string_To_xsd_anyType物件。 此集合對象用於儲存要拆解的PDF。
   • 建立MyMapOf_xsd_string_To_xsd_anyType_Item物件。
   • 為MyMapOf_xsd_string_To_xsd_anyType_Item對象的key欄位分配表示鍵名的字串值。 此值必須與DDX文檔中指定的PDF源元素的值匹配。
   • 將儲存PDF文檔的BLOB對象指派給MyMapOf_xsd_string_To_xsd_anyType_Item對象的value欄位。
   • 將MyMapOf_xsd_string_To_xsd_anyType_Item物件新增至MyMapOf_xsd_string_To_xsd_anyType物件。 調用MyMapOf_xsd_string_To_xsd_anyType對象' Add方法並傳遞MyMapOf_xsd_string_To_xsd_anyType對象。

5. 設定運行時選項。

   • 使用其建構子建立AssemblerOptionSpec物件，以儲存執行時選項。
   • 為屬於AssemblerOptionSpec對象的資料成員分配值，以設定運行時選項以滿足您的業務要求。 例如，要指示組合器服務在發生錯誤時繼續處理作業，請將false分配給AssemblerOptionSpec對象的failOnError欄位。

6. 反匯編PDF文檔。

   調用AssemblerServiceClient對象的invokeDDX方法並傳遞以下值：

   • BLOB對象，表示拆分PDF文檔的DDX文檔
   • 包含要反匯編的PDF文檔的MyMapOf_xsd_string_To_xsd_anyType對象
   • 指定運行時選項的AssemblerOptionSpec對象

   invokeDDX方法返回一個AssemblerResult對象，該對象包含作業結果和發生的任何異常。

7. 儲存已拆解的PDF檔案。

   要獲取新建立的PDF文檔，請執行以下操作：

   • 訪問AssemblerResult對象的documents欄位，該欄位是包含已拆解的PDF文檔的Map對象。
   • 逐一查看Map對象，以獲取每個結果文檔。 然後，將該陣列成員的value轉換為BLOB。
   • 通過訪問其BLOB對象的MTOM屬性來提取表示PDF文檔的二進位資料。 這會傳回可寫出為PDF檔案的位元組陣列。

另請參閱

以程式設計方式解譯PDF檔案

使用MTOM叫用AEM Forms