轉譯互動式PDF forms rendering-interactive-pdf-forms

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

開發人員

CAUTION

AEM 6.4已結束延伸支援，本檔案不再更新。如需詳細資訊，請參閱技術支援期. 尋找支援的版本此處.

Forms服務會將互動式PDF forms轉譯給用戶端裝置（通常是網頁瀏覽器），以收集使用者的資訊。轉譯互動式表單後，使用者可以在表單欄位中輸入資料，然後按一下表單上的提交按鈕，將資訊傳回Forms服務。 Adobe Reader或Acrobat必須安裝在托管用戶端網頁瀏覽器的電腦上，才能顯示互動式PDF表單。

NOTE

使用Forms服務演算表單之前，請先建立表單設計。通常，表單設計會在設計工具中建立，並儲存為XDP檔案。如需建立表單設計的相關資訊，請參閱 Forms Designer.

貸款申請示例

推出了範例貸款應用程式，以示範Forms服務如何使用互動式表單來收集使用者的資訊。此應用程式可讓使用者填寫表單，其中含有確保貸款安全所需的資料，然後將資料提交至Forms服務。下圖顯示貸款應用程式的邏輯流程。

ri_ri_finsrv_loanapp_v1

下表說明此圖中的步驟。

步驟

說明

此 GetLoanForm 從HTML頁面叫用Java Servlet。

此 GetLoanForm Java Servlet使用Forms服務用戶端API來轉譯貸款表單給用戶端網頁瀏覽器。 (請參閱使用Java API轉譯互動式PDF表單.)

使用者填寫貸款表單並按一下提交按鈕後，資料會提交至 HandleData Java Servlet。 (請參閱 "貸款表".)

此 HandleData Java Servlet使用Forms服務用戶端API來處理表單提交和擷取表單資料。然後，將資料儲存在企業資料庫中。 (請參閱處理已提交的Forms.)

確認表格會呈現回網頁瀏覽器。使用者的名字和姓氏等資料在轉譯前會與表單合併。 (請參閱使用可流式配置預填Forms.)

貸款表

此互動式貸款表由範例貸款申請的 GetLoanForm Java Servlet。

ri_ri_loanform

確認表

此表格由貸款申請示例 HandleData Java Servlet。

ri_ri_confirm

此 HandleData Java Servlet會以使用者的名字和姓氏以及金額預先填入此表單。預先填入表單後，表單會傳送至用戶端網頁瀏覽器。 (請參閱使用可流式配置預填Forms)

Java Servlet

範例貸款應用程式是以Java Servlet存在的Forms服務應用程式的範例。 Java Servlet是在J2EE應用程式伺服器（如WebSphere）上運行的Java程式，包含Forms服務客戶端API代碼。

以下代碼顯示名為GetLoanForm的Java Servlet的語法：

     public class GetLoanForm extends HttpServlet implements Servlet {
         public void doGet(HttpServletRequest req, HttpServletResponse resp
         throws ServletException, IOException {

         }
         public void doPost(HttpServletRequest req, HttpServletResponse resp
         throws ServletException, IOException {

             }

通常，您不會將Forms服務用戶端API程式碼放入Java Servlet的 doGet 或 doPost 方法。將此程式碼放置在個別類別中，從中實例化類別，是最佳的程式設計實務 doPost 方法(或 doGet 方法)，並呼叫適當的方法。不過，為了簡化程式碼，本節中的程式碼範例會維持在最小，而程式碼範例會放置在 doPost 方法。

NOTE

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

步驟摘要

若要呈現互動式PDF表單，請執行下列工作：

包含專案檔案。
建立Forms用戶端API物件。
指定URI值。
將檔案附加到表單（可選）。
轉譯互動式PDF表單。
將表單資料流寫入客戶端Web瀏覽器。

包含項目檔案

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

建立Forms用戶端API物件

您必須先建立Forms Client API物件，才能以程式設計方式執行Forms服務用戶端API作業。如果您使用Java API，請建立 FormsServiceClient 物件。如果您使用Forms網站服務API，請建立 FormsService 物件。

指定URI值

您可以指定Forms服務呈現表單所需的URI值。儲存為Forms應用程式一部分的表單設計，可使用內容根URI值來參照 repository:///. 例如，請考量下清單單設計，命名為 Loan.xdp 位於Forms應用程式中，名為 FormsApplication:

ri_ri_formrepository

若要存取此表單設計，請指定 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp 作為表單名稱(傳遞至 renderPDFForm 方法)和 repository:/// 作為內容根URI值。

NOTE

如需使用Workbench建立Forms應用程式的相關資訊，請參閱 Workbench說明.

位於Forms應用程式中之資源的路徑為：

Applications/Application-name/Application-version/Folder.../Filename

以下值顯示一些URI值的示例：

Applications/AppraisalReport/1.0/Forms/FullForm.xdp
Applications/AnotherApp/1.1/Assets/picture.jpg
Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd

呈現互動式表單時，您可以定義URI值，例如張貼表單資料的目標URL。目標URL可透過下列其中一種方式定義：

在Designer中設計表單設計時的「提交」按鈕
使用Forms服務用戶端API

如果目標URL是在表單設計中定義，請勿以Forms服務用戶端API覆寫它。也就是說，使用Forms API設定目標URL會將表單設計中指定的URL重設為使用API指定的URL。如果您想要將PDF表單提交至表單設計中指定的目標URL，請以程式設計方式將目標URL設為空字串。

如果您的表單包含提交按鈕和計算按鈕（具有在伺服器上運行的相應指令碼），則可以以寫程式方式定義表單要發送到的URL以執行指令碼。使用表單設計上的提交按鈕，指定張貼表單資料的URL。 (請參閱計算表單資料.)

NOTE

您也可以傳遞 com.adobe.idp.Document 例項至Forms服務。此 com.adobe.idp.Document 例項包含表單設計。 (請參閱將檔案傳遞至Forms服務.)

將檔案附加到表單

您可以將檔案附加到表單。當您呈現包含檔案附件的PDF表單時，使用者可以使用檔案附件窗格在Acrobat中擷取檔案附件。您可以將不同的檔案類型附加到表單（如文本檔案）或二進位檔案(如JPG檔案)。

NOTE

將檔案附件附加到表單是可選的。

轉譯互動式PDF表單

要呈現表單，請使用在設計器中建立並另存為XDP或PDF檔案的表單設計。您也可以呈現使用Acrobat建立並儲存為PDF檔案的表單。若要呈現互動式PDF表單，請叫用 FormsServiceClient 物件 renderPDFForm 方法或 renderPDFForm2 方法。

此 renderPDFForm 使用 URLSpec 物件。 XDP檔案的內容根目錄會使用 URLSpec 物件 setContentRootURI 方法。表單設計名稱( formQuery)會以個別參數值的形式傳遞。這兩個值會串連，以取得表單設計的絕對參照。

此 renderPDFForm2 方法接受 com.adobe.idp.Document 包含要呈現的XDP或PDF檔案的例項。

NOTE

如果輸入文檔是PDF文檔，則無法設定標籤的PDF運行時選項。如果輸入檔案是XDP檔案，則可以設定標籤的PDF選項。

使用Java API轉譯互動式PDF表單 render-an-interactive-pdf-form-using-the-java-api

使用Forms API(Java)轉譯互動式PDF表單：

包含項目檔案

在Java專案的類別路徑中加入用戶端JAR檔案，例如adobe-forms-client.jar。
建立Forms用戶端API物件
- 建立 ServiceClientFactory 包含連接屬性的對象。
- 建立 FormsServiceClient 對象，使用其建構子並傳遞 ServiceClientFactory 物件。
指定URI值
- 建立 URLSpec 使用其建構子儲存URI值的物件。
- 叫用 URLSpec 物件 setApplicationWebRoot 方法，並傳遞代表應用程式網頁根的字串值。
- 叫用 URLSpec 物件 setContentRootURI 方法，並傳遞指定內容根URI值的字串值。確保表單設計位於內容根URI中。否則，Forms服務會擲回例外狀況。要引用儲存庫，請指定 repository:///.
- 叫用 URLSpec 物件 setTargetURL 方法，並傳遞字串值，指定表單資料張貼到的目標URL值。如果您在表單設計中定義目標URL，則可以傳遞空字串。您也可以指定表單要傳送到哪個URL，以執行計算。

將檔案附加到表單

建立 java.util.HashMap 對象，使用其建構子儲存檔案附件。
叫用 java.util.HashMap 物件 put 方法，以附加至呈現的表單。將下列值傳遞至此方法：
- 指定檔案附件名稱的字串值，包括檔案名副檔名。
A com.adobe.idp.Document 包含檔案附件的對象。

note note
NOTE
對要附加到表單的每個檔案重複此步驟。此步驟為選填，您可以通過 `null`如果您不想發送檔案附件。

轉譯互動式PDF表單

叫用 FormsServiceClient 物件 renderPDFForm 方法，並傳遞下列值：
- 指定表單設計名稱的字串值，包括檔案名副檔名。如果您參考屬於Forms應用程式一部分的表單設計，請務必指定完整路徑，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
- A com.adobe.idp.Document 包含要與表單合併資料的物件。如果您不想合併資料，請傳遞空白 com.adobe.idp.Document 物件。
- A PDFFormRenderSpec 儲存運行時選項的對象。這是選用參數，您可以指定 null 如果您不想指定執行時選項。
- A URLSpec 包含Forms服務所需URI值的物件。
- A java.util.HashMap 儲存檔案附件的物件。這是選用參數，您可以指定 null 如果您不想將檔案附加到表單。
此 renderPDFForm 方法傳回 FormsResult 包含必須寫入客戶端web瀏覽器的表單資料流的對象。
將表單資料流寫入客戶端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 方法。

使用網站服務API轉譯互動式PDF表單 render-an-interactive-pdf-form-using-the-web-service-api

使用Forms API（網站服務）轉譯互動式PDF表單：

包含項目檔案
- 建立使用Forms服務WSDL的Java代理類。
- 將Java代理類包含到類路徑中。
建立Forms用戶端API物件

建立 FormsService 對象和設定驗證值。
指定URI值
- 建立 URLSpec 使用其建構子儲存URI值的物件。
- 叫用 URLSpec 物件 setApplicationWebRoot 方法，並傳遞代表應用程式網頁根的字串值。
- 叫用 URLSpec 物件 setContentRootURI 方法，並傳遞指定內容根URI值的字串值。確保表單設計位於內容根URI中。否則，Forms服務會擲回例外狀況。要引用儲存庫，請指定 repository:///.
- 叫用 URLSpec 物件 setTargetURL 方法，並傳遞字串值，指定表單資料張貼到的目標URL值。如果您在表單設計中定義目標URL，則可以傳遞空字串。您也可以指定表單要傳送到哪個URL，以執行計算。

將檔案附加到表單

建立 java.util.HashMap 對象，使用其建構子儲存檔案附件。
叫用 java.util.HashMap 物件 put 方法，以附加至呈現的表單。將下列值傳遞至此方法：
- 指定檔案附件名稱的字串值，包括檔案名副檔名
A BLOB 包含檔案附件的對象

note note
NOTE
對要附加到表單的每個檔案重複此步驟。

轉譯互動式PDF表單

叫用 FormsService 物件 renderPDFForm 方法，並傳遞下列值：
- 指定表單設計名稱的字串值，包括檔案名副檔名。如果您參考屬於Forms應用程式一部分的表單設計，請務必指定完整路徑，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
- A BLOB 包含要與表單合併資料的物件。如果您不想合併資料，請傳遞 null.
- A PDFFormRenderSpec 儲存運行時選項的對象。這是選用參數，您可以指定 null 如果您不想指定執行時選項。
- A URLSpec 包含Forms服務所需URI值的物件。
- A java.util.HashMap 儲存檔案附件的物件。這是選用參數，您可以指定 null 如果您不想將檔案附加到表單。
- 空白 com.adobe.idp.services.holders.BLOBHolder 由方法填入的物件。這可用來儲存呈現的PDF表單。
- 空白 javax.xml.rpc.holders.LongHolder 由方法填入的物件。（此引數會以表單儲存頁數。）
- 空白 javax.xml.rpc.holders.StringHolder 由方法填入的物件。（此參數將儲存區域設定值。）
- 空白 com.adobe.idp.services.holders.FormsResultHolder 包含此操作結果的對象。
此 renderPDFForm 方法填入 com.adobe.idp.services.holders.FormsResultHolder 作為最後一個引數值傳遞的物件，具有必須寫入用戶端網頁瀏覽器的表單資料流。
將表單資料流寫入客戶端Web瀏覽器
- 建立 FormResult 物件，方法是取得 com.adobe.idp.services.holders.FormsResultHolder 物件 value 資料成員。
- 建立 BLOB 包含表單資料的物件，方法是叫用 FormsResult 物件 getOutputContent 方法。
- 取得 BLOB 對象 getContentType 方法。
- 設定 javax.servlet.http.HttpServletResponse 對象的內容類型，方法是調用 setContentType 方法，並傳遞 BLOB 物件。
- 建立 javax.servlet.ServletOutputStream 用於通過調用 javax.servlet.http.HttpServletResponse 物件 getOutputStream 方法。
- 建立位元組陣列，並叫用 BLOB 物件 getBinaryData 方法。此任務分配 FormsResult 位元組陣列的物件。
- 叫用 javax.servlet.http.HttpServletResponse 物件 write 將表單資料流傳送至用戶端網頁瀏覽器的方法。將位元組陣列傳遞至 write 方法。

將表單資料流寫入客戶端Web瀏覽器

Forms服務轉譯表單時，會傳回您必須寫入用戶端網頁瀏覽器的表單資料流。寫入客戶端Web瀏覽器時，用戶可以看到該表單。

recommendation-more-help

a6ebf046-2b8b-4543-bd46-42a0d77792da