Forms服務會將互動式PDF forms轉譯給用戶端裝置(通常是網頁瀏覽器),以收集使用者的資訊。 轉譯互動式表單後,使用者可以在表單欄位中輸入資料,然後按一下表單上的提交按鈕,將資訊傳回Forms服務。 Adobe Reader或Acrobat必須安裝在托管用戶端網頁瀏覽器的電腦上,才能顯示互動式PDF表單。
使用Forms服務演算表單之前,請先建立表單設計。 通常,表單設計會在設計工具中建立,並儲存為XDP檔案。 如需建立表單設計的相關資訊,請參閱Forms Designer。
貸款申請示例
推出了範例貸款應用程式,以示範Forms服務如何使用互動式表單來收集使用者的資訊。 此應用程式可讓使用者填寫表單,其中含有確保貸款安全所需的資料,然後將資料提交至Forms服務。 下圖顯示貸款應用程式的邏輯流程。
下表說明此圖中的步驟。
步驟 |
說明 |
---|---|
1 |
從HTML頁面叫用 |
2 |
|
3 |
用戶填寫貸款表並按一下提交按鈕後,資料將提交到 |
4 |
|
5 |
確認表格會呈現回網頁瀏覽器。 使用者的名字和姓氏等資料在轉譯前會與表單合併。 (請參閱使用可流動配置預填Forms。) |
貸款表
此互動式貸款表單由範例貸款應用程式的GetLoanForm
Java Servlet轉譯。
確認表
此表單由範例貸款應用程式的HandleData
Java Servlet呈現。
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
方法中。
如需Forms服務的詳細資訊,請參閱AEM Forms的服務參考。
步驟摘要
要呈現互動式PDF表單,請執行以下任務:
包含項目檔案
在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
建立Forms用戶端API物件
您必須先建立Forms Client API物件,才能以程式設計方式執行Forms服務用戶端API作業。 如果您使用Java API,請建立FormsServiceClient
物件。 如果您使用Forms Web服務API,請建立FormsService
物件。
指定URI值
您可以指定Forms服務呈現表單所需的URI值。 儲存為Forms應用程式一部分的表單設計,可使用內容根URI值repository:///
來參照。 例如,請考慮以下名為Loan.xdp的表單設計,該表單設計位於名為FormsApplication的Forms應用程式中:
若要存取此表單設計,請指定Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
作為表單名稱(傳遞至renderPDFForm
方法的第一個參數),指定repository:///
作為內容根URI值。
如需使用Workbench建立Forms應用程式的相關資訊,請參閱Workbench說明。
位於Forms應用程式中之資源的路徑為:
Applications/Application-name/Application-version/Folder.../Filename
以下值顯示一些URI值的示例:
呈現互動式表單時,您可以定義URI值,例如張貼表單資料的目標URL。 目標URL可透過下列其中一種方式定義:
如果目標URL是在表單設計中定義,請勿以Forms服務用戶端API覆寫它。 也就是說,使用Forms API設定目標URL會將表單設計中指定的URL重設為使用API指定的URL。 如果要將PDF表單提交到表單設計中指定的目標URL,請以程式設計方式將目標URL設定為空字串。
如果您的表單包含提交按鈕和計算按鈕(具有在伺服器上運行的相應指令碼),則可以以寫程式方式定義表單要發送到的URL以執行指令碼。 使用表單設計上的提交按鈕,指定張貼表單資料的URL。 (請參閱計算表單資料。)
您也可以將com.adobe.idp.Document
例項傳遞至Forms服務,而不是指定URL值以參考XDP檔案。 com.adobe.idp.Document
實例包含表單設計。 (請參閱將檔案傳遞至Forms服務。)
將檔案附加到表單
您可以將檔案附加到表單。 在您轉譯含有檔案附件的PDF表單時,使用者可以使用檔案附件窗格在Acrobat中擷取檔案附件。 您可以將不同的檔案類型附加到表單(如文本檔案)或二進位檔案(如JPG檔案)。
將檔案附件附加到表單是可選的。
轉譯互動式PDF表單
若要呈現表單,請使用在Designer中建立並儲存為XDP或PDF檔案的表單設計。 您也可以轉譯使用Acrobat建立並儲存為PDF檔案的表單。 要呈現互動式PDF表單,請調用FormsServiceClient
對象的renderPDFForm
方法或renderPDFForm2
方法。
renderPDFForm
使用URLSpec
物件。 XDP檔案的內容根會使用URLSpec
物件的setContentRootURI
方法傳遞至Forms服務。 表單設計名稱(formQuery
)會以單獨的參數值傳遞。 這兩個值會串連,以取得表單設計的絕對參照。
renderPDFForm2
方法接受要呈現的com.adobe.idp.Document
實例,該實例包含XDP或PDF文檔。
如果輸入文檔是PDF文檔,則無法設定標籤的PDF運行時選項。 如果輸入檔案是XDP檔案,則可以設定標籤的PDF選項。
使用Forms API(Java)轉譯互動式PDF表單:
包含項目檔案
在Java專案的類別路徑中加入用戶端JAR檔案,例如adobe-forms-client.jar。
建立Forms用戶端API物件
ServiceClientFactory
對象。ServiceClientFactory
物件,以建立FormsServiceClient
物件。指定URI值
URLSpec
對象,該對象使用其建構子儲存URI值。URLSpec
物件的setApplicationWebRoot
方法,並傳遞代表應用程式Web根的字串值。URLSpec
對象的setContentRootURI
方法並傳遞指定內容根URI值的字串值。 確保表單設計位於內容根URI中。 否則,Forms服務會擲回例外狀況。 要引用儲存庫,請指定repository:///
。URLSpec
物件的setTargetURL
方法,並傳遞字串值,指定將表單資料張貼到的目標URL值。 如果您在表單設計中定義目標URL,則可以傳遞空字串。 您也可以指定表單要傳送到哪個URL,以執行計算。將檔案附加到表單
使用java.util.HashMap
對象的建構子建立對象以儲存檔案附件。
為每個檔案調用java.util.HashMap
對象的put
方法,以附加到呈現的表單。 將下列值傳遞至此方法:
包含檔案附件的com.adobe.idp.Document
對象。
對要附加到表單的每個檔案重複此步驟。 此步驟是可選的,如果不想發送檔案附件,則可以傳遞null
。
轉譯互動式PDF表單
調用FormsServiceClient
對象的renderPDFForm
方法並傳遞以下值:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
。com.adobe.idp.Document
物件,包含要與表單合併的資料。 如果您不想合併資料,請傳遞空白的com.adobe.idp.Document
物件。PDFFormRenderSpec
對象。 這是可選參數,如果您不想指定運行時選項,可以指定null
。URLSpec
物件,包含Forms服務所需的URI值。java.util.HashMap
對象。 這是可選參數,如果不想將檔案附加到表單,可以指定null
。renderPDFForm
方法返回一個FormsResult
對象,該對象包含必須寫入客戶端Web瀏覽器的表單資料流。
將表單資料流寫入客戶端Web瀏覽器
FormsResult
對象s getOutputContent
方法,建立com.adobe.idp.Document
對象。getContentType
方法,獲取com.adobe.idp.Document
對象的內容類型。setContentType
方法並傳遞com.adobe.idp.Document
對象的內容類型來設定javax.servlet.http.HttpServletResponse
對象的內容類型。javax.servlet.http.HttpServletResponse
對象的getOutputStream
方法,建立用於將表單資料流寫入客戶端Web瀏覽器的javax.servlet.ServletOutputStream
對象。com.adobe.idp.Document
對象的getInputStream
方法,建立java.io.InputStream
對象。InputStream
物件的read
方法,並將位元組陣列傳遞為引數,借此建立位元組陣列,並填入表單資料流。javax.servlet.ServletOutputStream
對象的write
方法,將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write
方法。使用Forms API(網站服務)轉譯互動式PDF表單:
包含項目檔案
建立Forms用戶端API物件
建立FormsService
物件並設定驗證值。
指定URI值
URLSpec
對象,該對象使用其建構子儲存URI值。URLSpec
物件的setApplicationWebRoot
方法,並傳遞代表應用程式Web根的字串值。URLSpec
對象的setContentRootURI
方法並傳遞指定內容根URI值的字串值。 確保表單設計位於內容根URI中。 否則,Forms服務會擲回例外狀況。 要引用儲存庫,請指定repository:///
。URLSpec
物件的setTargetURL
方法,並傳遞字串值,指定將表單資料張貼到的目標URL值。 如果您在表單設計中定義目標URL,則可以傳遞空字串。 您也可以指定表單要傳送到哪個URL,以執行計算。將檔案附加到表單
使用java.util.HashMap
對象的建構子建立對象以儲存檔案附件。
為每個檔案調用java.util.HashMap
對象的put
方法,以附加到呈現的表單。 將下列值傳遞至此方法:
包含檔案附件的BLOB
對象
對要附加到表單的每個檔案重複此步驟。
轉譯互動式PDF表單
調用FormsService
對象的renderPDFForm
方法並傳遞以下值:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
。BLOB
物件,包含要與表單合併的資料。 如果您不想合併資料,請傳遞null
。PDFFormRenderSpec
對象。 這是可選參數,如果您不想指定運行時選項,可以指定null
。URLSpec
物件,包含Forms服務所需的URI值。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瀏覽器
com.adobe.idp.services.holders.FormsResultHolder
對象的value
資料成員的值,以建立FormResult
對象。FormsResult
對象的getOutputContent
方法,建立包含表單資料的BLOB
對象。getContentType
方法,獲取BLOB
對象的內容類型。setContentType
方法並傳遞BLOB
對象的內容類型來設定javax.servlet.http.HttpServletResponse
對象的內容類型。javax.servlet.http.HttpServletResponse
對象的getOutputStream
方法,建立用於將表單資料流寫入客戶端Web瀏覽器的javax.servlet.ServletOutputStream
對象。BLOB
對象的getBinaryData
方法來填入。 此任務將FormsResult
對象的內容分配給位元組陣列。javax.servlet.http.HttpServletResponse
對象的write
方法,將表單資料流發送到客戶端Web瀏覽器。 將位元組陣列傳遞至write
方法。將表單資料流寫入客戶端Web瀏覽器
Forms服務轉譯表單時,會傳回您必須寫入用戶端網頁瀏覽器的表單資料流。 寫入客戶端Web瀏覽器時,用戶可以看到該表單。