文件AEM 6.5使用手冊

使用已提交的XML資料建立PDF檔案 creating-pdf-documents-with-submittedxml-data

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

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

使用已提交的XML資料建立PDF檔案 creating-pdf-documents-with-submitted-xml-data

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

NOTE
在閱讀本內容之前，建議您務必瞭解如何處理已提交的表單。 處理提交的Forms中會說明一些概念，例如表單設計與提交的XML資料之間的關係。

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

  • 使用者從網頁型應用程式將XML資料提交至Forms服務。
  • Forms服務用於處理提交的表單並擷取表單欄位。 可以處理表單資料。 例如，資料可以提交至企業資料庫。
  • 表單資料會傳送至輸出服務，以建立非互動式PDF檔案。
  • 非互動式PDF檔案會儲存在Content Services中（已棄用）。

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

cd_cd_finsrv_architecture_xml_pdf1

使用者從使用者端網頁瀏覽器提交表單後，非互動式PDF檔案會儲存在Content Services中（已棄用）。 下圖顯示儲存在Content Services （已棄用）中的PDF檔案。

cd_cd_cs_gui

步驟摘要 summary-of-steps

若要使用提交的XML資料建立非互動式PDF檔案，並儲存在Content Services的PDF檔案中（已棄用），請執行下列工作：

  1. 包含專案檔案。
  2. 建立Forms、輸出和檔案管理物件。
  3. 使用Forms服務擷取表單資料。
  4. 使用Output服務建立非互動式PDF檔案。
  5. 使用檔案管理服務將PDF表單儲存在內容服務（已棄用）中。

包含專案檔

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

建立Forms、輸出和檔案管理物件

在您以程式設計方式執行Forms服務API作業之前，請先建立Forms使用者端API物件。 同樣地，由於此工作流程會叫用「輸出」和「檔案管理」服務，因此請建立「輸出使用者端API」物件和「檔案管理使用者端API」物件。

使用Forms服務擷取表單資料

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

使用Output服務建立非互動式PDF檔案。

使用Output服務建立以表單設計和XML表單資料為基礎的非互動式PDF檔案。 在工作流程中，會從Forms服務擷取表單資料。

使用Document Management服務將PDF表單儲存在Content Services （已棄用）

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

另請參閱

包含AEM Forms Java程式庫檔案

設定連線屬性

Forms服務API快速入門

使用Java API建立包含已提交XML資料的PDF檔案 create-a-pdf-document-with-submitted-xml-data-using-the-java-api

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

  1. 包含專案檔案

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

  2. 建立Forms、輸出和檔案管理物件

    • 建立包含連線屬性的ServiceClientFactory物件。
    • 使用它的建構函式並傳遞ServiceClientFactory物件來建立FormsServiceClient物件。
    • 使用它的建構函式並傳遞ServiceClientFactory物件來建立OutputClient物件。
    • 使用它的建構函式並傳遞ServiceClientFactory物件來建立DocumentManagementServiceClientImpl物件。

  3. 使用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物件。

    • 判斷Forms服務是否已透過叫用FormsResult物件的getAction方法來完成表單資料的處理。 如果此方法傳回值0，資料即可處理。

    • 透過呼叫FormsResult物件的getOutputContent方法建立com.adobe.idp.Document物件來擷取表單資料。 （此物件包含可傳送至Output服務的表單資料。）

    • 呼叫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。 會顯示此方法的內文。

  4. 使用Output服務建立非互動式PDF檔案。

    呼叫OutputClient物件的generatePDFOutput方法並傳遞下列值，以建立PDF檔案：

    • TransformationFormat列舉值。 若要產生PDF檔案，請指定TransformationFormat.PDF。
    • 字串值，指定表單設計的名稱。 確認表單設計與從Forms服務擷取的表單資料相容。
    • 字串值，指定表單設計所在的內容根。
    • 包含PDF執行階段選項的PDFOutputOptionsSpec物件。
    • 包含轉譯執行階段選項的RenderOptionsSpec物件。
    • 包含要與表單設計合併之資料的XML資料來源的com.adobe.idp.Document物件。 請確定FormsResult物件的getOutputContent方法已傳回此物件。
    • generatePDFOutput方法傳回包含作業結果的OutputResult物件。
    • 叫用OutputResult物件的getGeneratedDoc方法，擷取非互動式PDF檔案。 此方法會傳回代表非互動式PDF檔案的com.adobe.idp.Document執行個體。

  5. 使用檔案管理服務將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方法。

另請參閱

包含AEM Forms Java程式庫檔案

設定連線屬性

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2