將檔案傳遞至Forms服務

上次更新: 2023-12-07
  • 建立對象:
  • Developer

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

AEM Forms服務會將互動式PDF forms轉譯給使用者端裝置(通常是網頁瀏覽器),以收集使用者的資訊。 互動式PDF表單是以表單設計為基礎,通常會儲存為XDP檔案並在Designer中建立。 至於AEM Forms,您可以傳遞 com.adobe.idp.Document 包含表單設計給Forms服務的物件。 Forms服務接著會在下列位置呈現表單設計: com.adobe.idp.Document 物件。

傳遞的優點 com.adobe.idp.Document 物件至Forms服務:其他服務作業會傳回 com.adobe.idp.Document 執行個體。 也就是說,您可以取得 com.adobe.idp.Document 執行個體,並加以呈現。 例如,假設XDP檔案儲存在名為的內容服務(已棄用)節點中 /Company Home/Form Designs,如下圖所示。

您可以利用程式設計方式從內容服務(已棄用)擷取Loan.xdp (已棄用),並將XDP檔案傳遞至Forms服務,位於 com.adobe.idp.Document 物件。

注意

如需Forms服務的詳細資訊,請參閱 AEM Forms服務參考.

步驟摘要

若要將從Content Services (已棄用)取得的檔案傳遞至Forms服務,請執行下列工作:

  1. 包含專案檔案。
  2. 建立Forms和Document Management使用者端API物件。
  3. 從內容服務擷取表單設計(已棄用)。
  4. 演算互動式PDF表單。
  5. 使用表單資料流執行動作。

包含專案檔案

在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請包含Proxy檔案。

建立Forms和Document Management使用者端API物件

在您以程式設計方式執行Forms服務API作業之前,請先建立Forms使用者端API物件。 此外,由於此工作流程會從內容服務中擷取XDP檔案(已棄用),請建立檔案管理API物件。

從內容服務擷取表單設計(已棄用)

使用Java或網站服務API從內容服務擷取XDP檔案(已棄用)。 XDP檔案會在 com.adobe.idp.Document 執行個體(或 BLOB 執行個體)。 然後,您可以傳遞 com.adobe.idp.Document 執行個體重新命名為Forms服務。

演算互動式PDF表單

若要呈現互動式表單,請傳遞 com.adobe.idp.Document 從Content Services (已棄用)傳回至Forms服務的例項。

注意

您可以傳遞 com.adobe.idp.Document 包含表單設計給Forms服務。 兩個命名的新方法 renderPDFForm2renderHTMLForm2 接受 com.adobe.idp.Document 包含表單設計的物件。

使用表單資料流執行動作

根據使用者端應用程式的型別,您可以將表單寫入使用者端網頁瀏覽器,或將表單儲存為PDF檔案。 網頁式應用程式通常會將表單寫入網頁瀏覽器。 不過,案頭應用程式通常會將表單儲存為PDF檔案。

另請參閱

包含AEM Forms Java程式庫檔案

設定連線屬性

Forms服務API快速入門

使用Java API將檔案傳遞至Forms服務

使用Forms服務和內容服務(已棄用) API (Java),傳遞從內容服務(已棄用)取得的檔案:

  1. 包含專案檔案

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

  2. 建立Forms和Document Management使用者端API物件

    • 建立 ServiceClientFactory 包含連線屬性的物件。 (請參閱 設定連線屬性.)
    • 建立 FormsServiceClient 物件,使用它的建構函式並傳遞 ServiceClientFactory 物件。
    • 建立 DocumentManagementServiceClientImpl 物件,使用它的建構函式並傳遞 ServiceClientFactory 物件。
  3. 從內容服務擷取表單設計(已棄用)

    叫用 DocumentManagementServiceClientImpl 物件的 retrieveContent 方法並傳遞下列值:

    • 字串值,指定新增內容的存放區。 預設存放區為 SpacesStore. 此值為必要引數。
    • 字串值,指定要擷取之內容的完整路徑(例如 /Company Home/Form Designs/Loan.xdp)。 此值為必要引數。
    • 字串值,指定版本。 此值是選用引數,您可以傳遞空字串。 在此情況下,會擷取最新版本。

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

  4. 演算互動式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瀏覽器的表單資料流的物件。

  5. 使用表單資料流執行動作

    • 建立 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 方法。

另請參閱

快速入門(SOAP模式):使用Java API將檔案傳遞至Forms服務

包含AEM Forms Java程式庫檔案

設定連線屬性

使用網站服務API將檔案傳遞至Forms服務

使用Forms服務和內容服務(已棄用) API (網頁服務),傳遞從內容服務(已棄用)取得的檔案:

  1. 包含專案檔案

    建立使用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 執行個體已完整合格。

    注意

    取代 localhost搭配託管AEM Forms之伺服器的IP位址。

  2. 建立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服務使用者端。

  3. 從內容服務擷取表單設計(已棄用)

    透過叫用擷取內容 DocumentManagementServiceClient 物件的 retrieveContent 方法並傳遞下列值:

    • 字串值,指定新增內容的存放區。 預設存放區為 SpacesStore. 此值為必要引數。
    • 字串值,指定要擷取之內容的完整路徑(例如 /Company Home/Form Designs/Loan.xdp)。 此值為必要引數。
    • 字串值,指定版本。 此值是選用引數,您可以傳遞空字串。 在此情況下,會擷取最新版本。
    • 儲存瀏覽連結值的字串輸出引數。
    • A BLOB 儲存內容的輸出引數。 您可以使用此輸出引數來擷取內容。
    • A ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType 儲存內容屬性的輸出引數。
    • A CRCResult 輸出引數。 除了使用此物件外,您還可以使用 BLOB 輸出引數以取得內容。
  4. 演算互動式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表單的物件。

  5. 使用表單資料流執行動作

    • 建立 BLOB 透過取得以下專案的值,包含表單資料的物件: FormsResult 物件的 outputContent 欄位。
    • 建立 System.IO.FileStream 物件,透過叫用它的建構函式。 傳遞代表互動式PDF檔案檔案位置及開啟檔案模式的字串值。
    • 建立位元組陣列,儲存 BLOB 物件,擷取自 FormsResult 物件。 透過取得 BLOB 物件的 MTOM 資料成員。
    • 建立 System.IO.BinaryWriter 物件,方法是叫用其建構函式,然後傳遞 System.IO.FileStream 物件。
    • 透過叫用將位元組陣列的內容寫入PDF檔案 System.IO.BinaryWriter 物件的 Write 方法並傳遞位元組陣列。

另請參閱

使用MTOM叫用AEM Forms

本頁內容