將檔案傳遞至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 包含從Content Services擷取之表單設計的物件（已棄用）。
• 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 物件 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 將表單資料流傳送至使用者端web瀏覽器的方法。 將位元組陣列傳遞至 write 方法。

包含專案檔案

建立使用MTOM的Microsoft .NET專案。 由於此使用者端應用程式會叫用兩個AEM Forms服務，請建立兩個服務參考。 使用下列WSDL定義作為與Forms服務相關的服務參考： http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

使用下列WSDL定義作為與Document Management服務相關的服務參考： 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 包含從Content Services擷取之表單設計的物件（已棄用）。
• 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 物件。
• 透過叫用將位元組陣列的內容寫入PDF檔案 System.IO.BinaryWriter 物件的 Write 方法並傳遞位元組陣列。