將檔案傳遞至Forms服務 passing-documents-to-the-formsservice

包含項目檔案

在您Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-forms-client.jar和adobe-contentservices-client.jar。

建立Forms和Document Management用戶端API物件

• 建立 ServiceClientFactory 包含連接屬性的對象。 (請參閱 設定連接屬性.)
• 建立 FormsServiceClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
• 建立 DocumentManagementServiceClientImpl 對象，使用其建構子並傳遞 ServiceClientFactory 物件。

從內容服務擷取表單設計（已淘汰）

叫用 DocumentManagementServiceClientImpl 物件 retrieveContent 方法，並傳遞下列值：

• 一個字串值，它指定添加內容的儲存區。 預設商店為 SpacesStore. 此值是必要參數。
• 指定要檢索的內容的完全限定路徑的字串值(例如， /Company Home/Form Designs/Loan.xdp)。 此值是必要參數。
• 指定版本的字串值。 此值是選用參數，您可以傳遞空白字串。 在此情況下，會擷取最新版本。

此 retrieveContent 方法傳回 CRCResult 包含XDP檔案的物件。 取得 com.adobe.idp.Document 執行個體 CRCResult 物件 getDocument 方法。

轉譯互動式PDF表單

叫用 FormsServiceClient 物件 renderPDFForm2 方法，並傳遞下列值：

• A com.adobe.idp.Document 包含從內容服務擷取的表單設計的物件（已淘汰）。
• A com.adobe.idp.Document 包含要與表單合併資料的物件。 如果您不想合併資料，請傳遞空白 com.adobe.idp.Document 物件。
• A PDFFormRenderSpec 儲存運行時選項的對象。 此值是選用參數，您可以指定 null 如果您不想指定執行時選項。
• A URLSpec 包含URI值的對象。 此值是選用參數，您可以指定 null.
• A java.util.HashMap 儲存檔案附件的物件。 此值是選用參數，您可以指定 null 如果您不想將檔案附加到表單。

此 renderPDFForm 方法傳回 FormsResult 包含必須寫入客戶端web瀏覽器的表單資料流的對象。

使用表單資料流執行動作

• 建立 com.adobe.idp.Document 對象，方法是調用 FormsResult 物件s getOutputContent 方法。
• 取得 com.adobe.idp.Document 對象 getContentType 方法。
• 設定 javax.servlet.http.HttpServletResponse 對象的內容類型，方法是調用 setContentType 方法，並傳遞 com.adobe.idp.Document 物件。
• 建立 javax.servlet.ServletOutputStream 用於通過調用 javax.servlet.http.HttpServletResponse 物件 getOutputStream 方法。
• 建立 java.io.InputStream 對象，方法是調用 com.adobe.idp.Document 物件 getInputStream 方法。
• 建立位元組陣列，並叫用 InputStream 物件 read 方法。 將位元組陣列傳遞為引數。
• 叫用 javax.servlet.ServletOutputStream 物件 write 將表單資料流傳送至用戶端網頁瀏覽器的方法。 將位元組陣列傳遞至 write 方法。

包含項目檔案

建立使用MTOM的Microsoft .NET專案。 由於此客戶端應用程式調用了兩個AEM Forms服務，因此請建立兩個服務引用。 為與Forms服務關聯的服務引用使用以下WSDL定義： http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

為與文檔管理服務關聯的服務引用使用以下WSDL定義： http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

因為 BLOB 資料類型是兩個服務參考的共同類型，完全限定 BLOB 資料類型。 在相應的Web服務快速入門中，所有 BLOB 例項已完全限定。

建立Forms和Document Management用戶端API物件

• 建立 FormsServiceClient 物件，使用其預設建構函式。

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

• 建立 System.ServiceModel.BasicHttpBinding 物件，方法是取得 FormsServiceClient.Endpoint.Binding 欄位。 將傳回值轉換為 BasicHttpBinding.

• 設定 System.ServiceModel.BasicHttpBinding 物件 MessageEncoding 欄位至 WSMessageEncoding.Mtom. 此值可確保使用MTOM。

• 通過執行以下任務來啟用基本HTTP身份驗證：

  • 將AEM表單使用者名稱指派給欄位 FormsServiceClient.ClientCredentials.UserName.UserName.
  • 為欄位分配相應的密碼值 FormsServiceClient.ClientCredentials.UserName.Password.
  • 指派常數值 HttpClientCredentialType.Basic 欄位 BasicHttpBindingSecurity.Transport.ClientCredentialType.

• 指派常數值 BasicHttpSecurityMode.TransportCredentialOnly 欄位 BasicHttpBindingSecurity.Security.Mode.

從內容服務擷取表單設計（已淘汰）

叫用 DocumentManagementServiceClient 物件 retrieveContent 方法並傳遞下列值：

• 一個字串值，它指定添加內容的儲存區。 預設商店為 SpacesStore. 此值是必要參數。
• 指定要檢索的內容的完全限定路徑的字串值(例如， /Company Home/Form Designs/Loan.xdp)。 此值是必要參數。
• 指定版本的字串值。 此值是選用參數，您可以傳遞空白字串。 在此情況下，會擷取最新版本。
• 儲存瀏覽連結值的字串輸出參數。
• A BLOB 儲存內容的輸出參數。 您可以使用此輸出參數來擷取內容。
• A ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType 儲存內容屬性的輸出參數。
• A CRCResult 輸出參數。 您可以使用 BLOB 輸出參數來取得內容。

轉譯互動式PDF表單

叫用 FormsServiceClient 物件 renderPDFForm2 方法，並傳遞下列值：

• A BLOB 包含從內容服務擷取的表單設計的物件（已淘汰）。
• A BLOB 包含要與表單合併資料的物件。 如果您不想合併資料，請傳遞空白 BLOB 物件。
• A PDFFormRenderSpec 儲存運行時選項的對象。 此值是選用參數，您可以指定 null 如果您不想指定執行時選項。
• A URLSpec 包含URI值的對象。 此值是選用參數，您可以指定 null.
• A Map 儲存檔案附件的物件。 此值是選用參數，您可以指定 null 如果您不想將檔案附加到表單。
• 用於儲存頁數的長輸出參數。
• 用於儲存地區設定值的字串輸出參數。
• A FormsResult 用於儲存交互PDF表單的輸出參數 .

此 renderPDFForm2 方法傳回 FormsResult 包含互動式PDF表單的物件。

使用表單資料流執行動作

• 建立 BLOB 包含表單資料的物件，方法是取得 FormsResult 物件 outputContent 欄位。
• 建立 System.IO.FileStream 對象，方法是調用其建構子。 傳遞一個字串值，該字串值表示交互PDF文檔的檔案位置以及開啟檔案的模式。
• 建立位元組陣列，用於儲存 BLOB 從 FormsResult 物件。 取得 BLOB 物件 MTOM 資料成員。
• 建立 System.IO.BinaryWriter 對象，調用其建構子並傳遞 System.IO.FileStream 物件。
• 調用 System.IO.BinaryWriter 物件 Write 方法，並傳遞位元組陣列。