使用已提交的XML資料建立PDF文檔

讓使用者能夠填寫互動式表單的網頁型應用程式，需要將資料提交回伺服器。使用Forms服務，您可以擷取使用者在互動式表單中輸入的表單資料。然後，您可以將表單資料傳遞至其他AEM Forms服務操作，並使用資料建立PDF檔案。

注意

閱讀此內容之前，建議您對處理已提交表單有紮實的了解。處理已提交的Forms中涵蓋表單設計與已提交XML資料之間的關係等概念。

請考量下列涉及三個AEM Forms服務的工作流程：

用戶從基於Web的應用程式向Forms服務提交XML資料。
Forms服務可用於處理已提交的表單及擷取表單欄位。可處理表單資料。例如，可將資料提交到企業資料庫。
表單資料會傳送至輸出服務，以建立非互動式PDF檔案。
非互動式PDF檔案會儲存在內容服務中（已過時）。

下圖提供此工作流程的視覺表示法。

cd_cd_finsrv_architecture_xml_pdf1

使用者從用戶端網頁瀏覽器提交表單後，非互動式PDF檔案會儲存在內容服務中（已過時）。下圖顯示儲存在「內容服務」中的PDF檔案（已過時）。

cd_cd_cs_gui

步驟的摘要

要使用已提交的XML資料建立非互動式PDF文檔，並將其儲存在Content Services中的PDF文檔中（已過時），請執行以下任務：

包含專案檔案。
建立Forms、輸出和文檔管理對象。
使用Forms服務擷取表單資料。
使用輸出服務建立非互動式PDF文檔。
使用檔案管理服務將PDF表單儲存在內容服務（已淘汰）。

包含項目檔案

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

建立Forms、輸出和文檔管理對象

在以程式設計方式執行Forms服務API操作之前，請先建立Forms用戶端API物件。同樣，由於此工作流調用了輸出和文檔管理服務，因此請同時建立輸出客戶端API對象和文檔管理客戶端API對象。

使用Forms服務擷取表單資料

擷取已提交至Forms服務的表單資料。您可以處理提交的資料，以符合您的業務需求。例如，您可以將表單資料儲存在企業資料庫中。不過，若要建立非互動式PDF檔案，表單資料會傳遞至輸出服務。

使用輸出服務建立非互動式PDF文檔。

使用輸出服務建立基於表單設計和XML表單資料的非互動式PDF文檔。在工作流程中，表單資料會從Forms服務中擷取。

使用檔案管理服務將PDF表單儲存在內容服務（已淘汰）中

使用檔案管理服務API將PDF檔案儲存在內容服務中（已過時）。

另請參閱

包含AEM Forms Java程式庫檔案

設定連接屬性

Forms服務API快速入門

使用Java API建立含有已提交XML資料的PDF文檔

使用Forms、輸出和文檔管理API(Java)，使用提交的XML資料建立PDF文檔：

包含項目檔案

在您的Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-forms-client.jar、adobe-output-client.jar和adobe-contentservices-client.jar。
建立Forms、輸出和文檔管理對象
- 建立包含連接屬性的ServiceClientFactory對象。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立FormsServiceClient物件。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立OutputClient物件。
- 使用其建構子並傳遞ServiceClientFactory物件，以建立DocumentManagementServiceClientImpl物件。
使用Forms服務擷取表單資料
- 調用FormsServiceClient對象的processFormSubmission方法並傳遞以下值：
  - 包含表單資料的com.adobe.idp.Document物件。
  - 指定環境變數的字串值，包括所有相關的HTTP標題。通過為CONTENT_TYPE環境變數指定一個或多個值來指定要處理的內容類型。例如，要處理XML資料，請為此參數指定以下字串值：CONTENT_TYPE=text/xml。
  - 指定HTTP_USER_AGENT標題值（如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)）的字串值。
  - 儲存運行時選項的RenderOptionsSpec對象。
  processFormSubmission方法會傳回包含表單提交結果的FormsResult物件。
- 叫用FormsResult物件的getAction方法，判斷Forms服務是否已完成表單資料的處理。如果此方法返回值0，則資料已準備好進行處理。
- 調用FormsResult對象的getOutputContent方法，通過建立com.adobe.idp.Document對象來檢索表單資料。（此物件包含可傳送至輸出服務的表單資料。）
- 通過調用java.io.DataInputStream建構子並傳遞com.adobe.idp.Document對象來建立java.io.InputStream對象。
- 呼叫靜態org.w3c.dom.DocumentBuilderFactory物件的newInstance方法，建立org.w3c.dom.DocumentBuilderFactory物件。
- 調用org.w3c.dom.DocumentBuilderFactory對象的newDocumentBuilder方法，建立org.w3c.dom.DocumentBuilder對象。
- 調用org.w3c.dom.DocumentBuilder對象的parse方法並傳遞java.io.InputStream對象，建立org.w3c.dom.Document對象。
- 檢索XML文檔中每個節點的值。完成此工作的一種方式是建立接受兩個參數的自訂方法：org.w3c.dom.Document對象以及要檢索其值的節點的名稱。此方法會傳回代表節點值的字串值。在此程式後的程式碼範例中，此自訂方法稱為getNodeText。此方法的內文如所示。
使用輸出服務建立非互動式PDF文檔。

叫用OutputClient物件的generatePDFOutput方法並傳遞下列值，以建立PDF檔案：
- TransformationFormat枚舉值。要生成PDF文檔，請指定TransformationFormat.PDF。
- 指定表單設計名稱的字串值。確認表單設計與從Forms服務擷取的表單資料相容。
- 一個字串值，它指定表單設計所在的內容根。
- 包含PDF運行時選項的PDFOutputOptionsSpec對象。
- 包含呈現運行時選項的RenderOptionsSpec對象。
- com.adobe.idp.Document對象，該對象包含要與表單設計合併的資料的XML資料源。確保此對象由FormsResult對象的getOutputContent方法返回。
- generatePDFOutput方法返回包含操作結果的OutputResult對象。
- 調用OutputResult對象的getGeneratedDoc方法，檢索非互動式PDF文檔。此方法會傳回代表非互動式PDF檔案的com.adobe.idp.Document例項。
使用檔案管理服務將PDF表單儲存在內容服務（已淘汰）中

叫用DocumentManagementServiceClientImpl物件的storeContent方法並傳遞下列值，以新增內容：
- 一個字串值，它指定添加內容的儲存區。預設儲存為SpacesStore。此值是必要參數。
- 一個字串值，它指定添加內容的空間的完全限定路徑（例如/Company Home/Test Directory）。此值是必要參數。
- 代表新內容的節點名稱（例如MortgageForm.pdf）。此值是必要參數。
- 指定節點類型的字串值。若要新增內容（例如PDF檔案），請指定{https://www.alfresco.org/model/content/1.0}content。此值是必要參數。
- 代表內容的com.adobe.idp.Document物件。此值是必要參數。
- 指定編碼值的字串值（例如UTF-8）。此值是必要參數。
- UpdateVersionType列舉值，指定如何處理版本資訊（例如UpdateVersionType.INCREMENT_MAJOR_VERSION）以增加內容版本。 )此值是必填參數。
- java.util.List實例，它指定與內容相關的方面。此值是選用參數，您可以指定null。
- 儲存內容屬性的java.util.Map物件。
storeContent方法返回描述內容的CRCResult對象。例如，使用CRCResult物件，您可以取得內容的唯一識別碼值。要執行此任務，請調用CRCResult對象的getNodeUuid方法。