Forms服務會將互動式PDF表格轉譯至用戶端裝置(通常是網頁瀏覽器),以收集使用者的資訊。 在轉譯互動式表單後,使用者可以在表單欄位中輸入資料,然後按一下表單上的提交按鈕,將資訊傳回至Forms服務。 Adobe Reader或Acrobat必須安裝在用戶端網頁瀏覽器的電腦上,才能顯示互動式PDF表格。
在使用Forms服務演算表單之前,請先建立表單設計。 通常,表單設計是在Designer中建立,並儲存為XDP檔案。 有關建立表單設計的資訊,請參閱表單設計器。
貸款申請範例
引入範例貸款應用程式,以示範Forms服務如何使用互動式表單來收集使用者的資訊。 此應用程式可讓使用者填寫表單,填入保證貸款安全所需的資料,然後將資料提交至表單服務。 下圖顯示貸款申請的邏輯流程。
下表說明此圖中的步驟。
步驟 |
說明 |
---|---|
1 |
|
2 |
|
3 |
當使用者填入貸款表單並按一下提交按鈕後,資料就會送出至 |
4 |
|
5 |
確認表單會轉譯回網頁瀏覽器。 使用者的名字和姓氏等資料會在轉譯前與表單合併。 (請參閱使用可排程版面預填表單)。 |
貸款表
此互動式貸款表格由範例貸款應用程式的GetLoanForm
Java Servlet轉譯。
確認表單
此表單由範例貸款應用程式的HandleData
Java Servlet轉譯。
HandleData
Java Servlet會預先填入此表單中使用者的名字和姓氏以及金額。 在預先填入表單後,會將它傳送至用戶端網頁瀏覽器。 (請參閱使用可排程版面預填表單)
Java Servlet
範例貸款應用程式是Forms服務應用程式的範例,存在於Java Servlet中。 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 services,請確定您包含proxy檔案。
建立Forms用戶端API物件
您必須先建立Forms Client API物件,才能以程式設計方式執行Forms服務用戶端API作業。 如果您使用Java API,請建立FormsServiceClient
物件。 如果您使用Forms web service API,請建立FormsService
物件。
指定URI值
您可以指定Forms服務呈現表單所需的URI值。 使用內容根URI值repository:///
可以參照儲存為Forms應用程式一部分的表單設計。 例如,請考慮以下名為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 Service。)
將檔案附加至表單
您可以將檔案附加至表單。 當您轉譯包含檔案附件的PDF表格時,使用者可以使用檔案附件窗格在Acrobat中擷取檔案附件。 您可以將不同的檔案類型附加至表單,例如文字檔案,或附加至二進位檔案,例如JPG檔案。
將檔案附件附加到表單是可選的。
轉換互動式PDF表單
若要轉換表單,請使用在Designer中建立並儲存為XDP或PDF檔案的表單設計。 此外,您也可以轉換使用Acrobat建立並儲存為PDF檔案的表格。 若要轉換互動式PDF表單,請叫用FormsServiceClient
物件的renderPDFForm
方法或renderPDFForm2
方法。
renderPDFForm
使用URLSpec
物件。 使用URLSpec
物件的setContentRootURI
方法,將XDP檔案的內容根目錄傳遞至Forms服務。 表單設計名稱(formQuery
)會作為單獨的參數值傳遞。 這兩個值會串連起來,以取得表單設計的絕對參照。
renderPDFForm2
方法接受包含要渲染的XDP或PDF文檔的com.adobe.idp.Document
實例。
如果輸入檔案是PDF檔案,則無法設定標籤的PDF執行時期選項。 如果輸入檔案是XDP檔案,則可以設定標籤的PDF選項。
使用Forms API(Java)演算互動式PDF表格:
包含專案檔案
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-forms-client.jar。
建立Forms用戶端API物件
ServiceClientFactory
對象。ServiceClientFactory
對象,建立FormsServiceClient
對象。指定URI值
URLSpec
的建構函式建立儲存URI值的<a0/>物件。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瀏覽器的表單資料流。
將表單資料串流寫入用戶端網頁瀏覽器
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
方法,建立javax.servlet.ServletOutputStream
物件,用來將表單資料串流寫入用戶端Web瀏覽器。com.adobe.idp.Document
物件的getInputStream
方法,以建立java.io.InputStream
物件。InputStream
物件的read
方法來填入表單資料流,並將位元組陣列傳入為引數。javax.servlet.ServletOutputStream
物件的write
方法,將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write
方法。使用Forms API(web service)來轉換互動式PDF表格:
包含專案檔案
建立Forms用戶端API物件
建立FormsService
對象並設定驗證值。
指定URI值
URLSpec
的建構函式建立儲存URI值的<a0/>物件。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
物件。
將表單資料串流寫入用戶端網頁瀏覽器
com.adobe.idp.services.holders.FormsResultHolder
對象value
資料成員的值,建立FormResult
對象。FormsResult
物件的getOutputContent
方法,建立包含表單資料的BLOB
物件。getContentType
方法獲取BLOB
對象的內容類型。setContentType
方法並傳遞BLOB
物件的內容類型,以設定javax.servlet.http.HttpServletResponse
物件的內容類型。javax.servlet.http.HttpServletResponse
物件的getOutputStream
方法,建立javax.servlet.ServletOutputStream
物件,用來將表單資料串流寫入用戶端Web瀏覽器。BLOB
物件的getBinaryData
方法以填入它。 此任務將FormsResult
對象的內容分配給位元組陣列。javax.servlet.http.HttpServletResponse
物件的write
方法,將表單資料串流傳送至用戶端網頁瀏覽器。 將位元組陣列傳遞到write
方法。將表單資料串流寫入用戶端網頁瀏覽器
當Forms服務轉譯表單時,它會傳回必須寫入用戶端網頁瀏覽器的表單資料流。 當寫入用戶端網頁瀏覽器時,使用者會看到表單。