計算表單資料

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

Forms服務可計算使用者在表單中輸入的值，並顯示結果。 若要計算表單資料，您必須執行兩項工作。 首先，您建立可計算表單資料的表單設計指令碼。 表單設計支援三種類型的指令碼。 一種指令碼類型在客戶端上運行，另一種指令碼類型在伺服器上運行，第三種指令碼類型在伺服器和客戶端上運行。 本主題中討論的指令碼類型在伺服器上運行。 HTML、PDF和表單指南（已過時）轉換支援伺服器端計算。

在表單設計流程中，您可以運用計算和指令碼來提供更豐富的使用者體驗。 計算和指令碼可新增至大部分的表格欄位和物件。 您必須建立表單設計指令碼，以對使用者輸入互動式表單的資料執行計算作業。

用戶在表單中輸入值，然後按一下「計算」按鈕查看結果。 下列程式說明可讓使用者計算資料的範例應用程式：

• 使用者存取名為StartLoan.html的HTML頁面，該頁面可當成網頁應用程式的開始頁面。 此頁調用名為GetLoanForm的Java Servlet。
• GetLoanForm servlet將呈現貸款表單。 此表單包含指令碼、互動式欄位、計算按鈕和送出按鈕。
• 使用者在表單欄位中輸入值，然後按一下「計算」按鈕。 表單會傳送至執行指令碼的CalculateData Java Servlet。 表單會傳回給使用者，其計算結果會顯示在表單中。
• 用戶繼續輸入和計算值，直到顯示滿意的結果。 當使用者滿意時，會按一下「提交」按鈕以處理表單。 表單會傳送至另一個名為ProcessForm的Java Servlet，負責擷取已提交的資料。 （請參閱處理提交的表單）。

下圖顯示應用程式的邏輯流程。

下表說明此圖中的步驟。

通常，提交為PDF內容的表單包含在用戶端上執行的指令碼。 不過，伺服器端的計算也可以執行。 「提交」按鈕不能用於計算指令碼。 在這種情況下，不會執行計算，因為Forms服務認為交互已完成。

為了說明表單設計指令碼的使用，本節將檢查一個簡單的互動式表單，其中包含已設定為可在伺服器上執行的指令碼。 下圖顯示的表單設計包含一個指令碼，該指令碼將用戶輸入到前兩個欄位中的值添加到第三個欄位中，並在第三個欄位中顯示結果。

A. A欄位，名為NumericField1 B. A欄位，名為NumericField2 C. A欄位，名為NumericField3

位於此表單設計中的指令碼語法如下：

     NumericField3 = NumericField2 + NumericField1

在此表單設計中，「計算」按鈕是命令按鈕，而指令檔位於此按鈕的Click事件中。 當使用者在前兩個欄位（NumericField1和NumericField2）中輸入值，然後按一下「計算」按鈕時，表格會傳送至Forms服務，並執行指令碼。 Forms服務會將表單轉譯回用戶端裝置，計算結果會顯示在NumericField3欄位中。

步驟摘要

要計算表單資料，請執行以下任務：

1. 包含專案檔案。
2. 建立Forms用戶端API物件。
3. 檢索包含計算指令碼的表單。
4. 將表單資料流寫回用戶端網頁瀏覽器

包含專案檔案

將必要的檔案加入您的開發專案中。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

建立Forms用戶端API物件

您必須先建立Forms服務用戶端，才能以程式設計方式執行Forms服務用戶端API操作。 如果您使用Java API，請建立FormsServiceClient物件。 如果您使用Forms web service API，請建立FormsServiceService物件。

檢索包含計算指令碼的表單

您可使用Forms服務用戶端API來建立應用程式邏輯，以處理包含設定為在伺服器上執行之指令碼的表單。 此程式類似於處理提交的表單。 （請參閱處理提交的表單）。

驗證與提交表單關聯的處理狀態為1 (Calculate)，這表示Forms服務正在對表單資料執行計算操作，且結果必須寫回給用戶。 在這種情況下，將自動執行配置為在伺服器上運行的指令碼。

將表單資料流寫回用戶端網頁瀏覽器

在驗證與提交的表單相關聯的處理狀態為1後，您必須將結果寫回客戶端Web瀏覽器。 當顯示表單時，計算值會出現在適當的欄位中。

另請參閱

包含AEM Forms Java程式庫檔案
使用Java
APIC計算表單資料使用web service
APISeting connection propertiesForms Service API快速啟動轉譯互動式PDF


表單建立轉譯表單的Web應用程式

使用Java API計算表單資料

使用Forms API(Java)計算表單資料：

1. 包含專案檔案

   在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-forms-client.jar。

2. 建立Forms用戶端API物件

   • 建立包含連接屬性的ServiceClientFactory對象。
   • 使用其建構子並傳遞ServiceClientFactory對象，建立FormsServiceClient對象。

3. 檢索包含計算指令碼的表單

   • 若要擷取包含計算指令碼的表單資料，請使用其建構函式建立com.adobe.idp.Document物件，並從建構函式中叫用javax.servlet.http.HttpServletResponse物件的getInputStream方法。

   • 叫用FormsServiceClient物件的processFormSubmission方法並傳遞下列值：

     • 包含表單資料的com.adobe.idp.Document物件。
     • 一個字串值，它指定包括所有相關HTTP標題的環境變數。 必須通過為CONTENT_TYPE環境變數指定一個或多個值來指定要處理的內容類型。 例如，若要處理XML和PDF資料，請為此參數指定下列字串值：CONTENT_TYPE=application/xml&CONTENT_TYPE=application/pdf
     • 指定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方法，確認與提交表單相關的處理狀態為1。 如果此方法返回值1，則會執行計算並將資料寫回客戶端Web瀏覽器。

4. 將表單資料流寫回用戶端網頁瀏覽器

   • 建立javax.servlet.ServletOutputStream物件，用來傳送表單資料流至用戶端網頁瀏覽器。
   • 通過調用FormsResult對象「s getOutputContent」方法建立com.adobe.idp.Document對象。
   • 調用com.adobe.idp.Document物件的getInputStream方法，以建立java.io.InputStream物件。
   • 建立位元組陣列，並以InputStream物件的read方法來填入表單資料流，並將位元組陣列傳入為引數。
   • 叫用javax.servlet.ServletOutputStream物件的write方法，將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write方法。

另請參閱

包含AEM Forms Java程式庫檔案設
定連線屬性

使用web service API計算表單資料

使用Forms API(web service)計算表單資料：

1. 包含專案檔案

   • 建立使用Forms服務WSDL的Java代理類。
   • 將Java代理類包含到類路徑中。

2. 建立Forms用戶端API物件

   建立FormsService對象並設定驗證值。

3. 檢索包含計算指令碼的表單

   • 要檢索張貼到Java Servlet的表單資料，請使用其建構子建立BLOB對象。

   • 使用javax.servlet.http.HttpServletResponse物件的getInputStream方法建立java.io.InputStream物件。

   • 使用其建構子並傳遞java.io.InputStream對象的長度，建立java.io.ByteArrayOutputStream對象。

   • 將java.io.InputStream對象的內容複製到java.io.ByteArrayOutputStream對象中。

   • 通過調用java.io.ByteArrayOutputStream對象的toByteArray方法建立位元組陣列。

   • 調用setBinaryData方法並將位元組陣列作為參數傳遞，以填充BLOB對象。

   • 使用其建構子建立RenderOptionsSpec對象。 調用RenderOptionsSpec物件的setLocale方法並傳遞指定地區值的字串值，以設定地區值。

   • 叫用FormsServiceClient物件的processFormSubmission方法並傳遞下列值：

     • 包含表單資料的BLOB物件。
     • 指定環境變數的字串值包括所有相關的HTTP標頭。 例如，您可以指定下列字串值：HTTP_REFERER=referrer&HTTP_CONNECTION=keep-alive&CONTENT_TYPE=application/xml
     • 指定HTTP_USER_AGENT標題值的字串值；例如，Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)。
     • 儲存運行時選項的RenderOptionsSpec對象。 如需詳細資訊，請造訪。
     • 由方法填充的空BLOBHolder對象。
     • 由方法填充的空javax.xml.rpc.holders.StringHolder對象。
     • 由方法填充的空BLOBHolder對象。
     • 由方法填充的空BLOBHolder對象。
     • 由方法填充的空javax.xml.rpc.holders.ShortHolder對象。
     • 由方法填充的空MyArrayOf_xsd_anyTypeHolder對象。 此參數用於儲存隨表單一起提交的檔案附件。
     • 由方法填入的空FormsResultHolder對象，其表單為已提交。

     processFormSubmission方法會以表單提交的結果填入FormsResultHolder參數。 processFormSubmission方法返回包含表單提交結果的FormsResult對象。

   • 呼叫FormsResult物件的getAction方法，確認與提交表單相關的處理狀態為1。 如果此方法返回值1，則會執行計算並將資料寫回客戶端Web瀏覽器。

4. 將表單資料流寫回用戶端網頁瀏覽器

   • 建立javax.servlet.ServletOutputStream物件，用來傳送表單資料流至用戶端網頁瀏覽器。
   • 呼叫FormsResult物件的getOutputContent方法，建立包含表單資料的BLOB物件。
   • 建立位元組陣列，並呼叫BLOB物件的getBinaryData方法以填入它。 此任務將FormsResult對象的內容分配給位元組陣列。
   • 叫用javax.servlet.http.HttpServletResponse物件的write方法，將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write方法。

另請
參閱使用Base64編碼叫用AEM Forms