本文档中的示例和示例仅适用于JEE环境上的AEM Forms 。
Forms服务向客户端设备(通常是Web浏览器)呈现交互式PDF forms,以从用户那里收集信息。 呈现交互式表单后,用户可以在表单字段中输入数据,然后单击表单上的提交按钮以将信息发送回Forms服务。 必须在托管客户端Web浏览器的计算机上安装Adobe Reader或Acrobat,以便显示交互式PDF表单。
在使用Forms服务呈现表单之前,请先创建表单设计。 通常,表单设计会在Designer中创建,并保存为XDP文件。 有关创建表单设计的信息,请参阅 Forms Designer.
贷款申请示例
引入了一个贷款申请示例,以演示Forms服务如何使用交互式表单从用户那里收集信息。 通过此应用程序,用户可在表单中填写保护贷款所需的数据,然后将数据提交到Forms服务。 下图显示了贷款申请的逻辑流程。
下表描述了此图中的步骤。
步骤 |
描述 |
---|---|
1 |
此 |
2 |
此 |
3 |
用户填写贷款表单并单击提交按钮后,数据将提交到 |
4 |
此 |
5 |
确认表单将呈现回Web浏览器。 诸如用户名字和姓氏的数据在呈现之前将与表单合并。 (请参阅 使用可流布局预填充Forms.) |
贷款表
此互动贷款表格由范例贷款申请表提供,其附属 GetLoanForm
Java Servlet。
确认表单
此表格由范例贷款申请的 HandleData
Java Servlet。
此 HandleData
Java Servlet会使用用户的名字和姓氏以及数量预填充此表单。 预填充表单后,该表单会被发送到客户端Web浏览器。 (请参阅 使用可流布局预填充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服务,请确保包含代理文件。
创建Forms客户端API对象
您必须先创建Forms客户端API对象,然后才能以编程方式执行Forms服务客户端API操作。 如果您使用的是Java API,请创建 FormsServiceClient
对象。 如果您使用的是Forms Web服务API,请创建 FormsService
对象。
指定URI值
您可以指定Forms服务呈现表单所需的URI值。 可以使用内容根URI值引用另存为Forms应用程序一部分的表单设计 repository:///
. 例如,考虑以下名为的表单设计 Loan.xdp 位于名为的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。 (请参阅 计算表单数据.)
您还可以传递URL值来引用XDP文件,而不是 com.adobe.idp.Document
Forms服务的实例。 此 com.adobe.idp.Document
实例包含窗体设计。 (请参阅 将文档传递到Forms服务.)
将文件附加到表单
您可以将文件附加到表单。 渲染带有文件附件的PDF表单时,用户可以使用文件附件窗格在Acrobat中检索文件附件。 您可以将不同的文件类型附加到表单(如文本文件)或二进制文件(如JPG文件)。
将文件附件附加到表单是可选的。
呈现交互式PDF表单
要呈现表单,请使用在Designer中创建并另存为XDP或PDF文件的表单设计。 此外,您还可以呈现使用Acrobat创建并另存为PDF文件的表单。 要呈现交互式PDF表单,请调用 FormsServiceClient
对象的 renderPDFForm
方法或 renderPDFForm2
方法。
此 renderPDFForm
使用 URLSpec
对象。 使用,将XDP文件的内容根传递到Forms服务 URLSpec
对象的 setContentRootURI
方法。 窗体设计名称( formQuery
)作为单独的参数值传递。 将这两个值连接起来以获得对窗体设计的绝对引用。
此 renderPDFForm2
方法接受 com.adobe.idp.Document
包含要呈现的XDP或PDF文档的实例。
如果输入文档是PDFPDF,则无法设置标记文档运行时选项。 如果输入文件是XDP文件,则可以设置标记的PDF选项。
使用Forms API (Java)呈现交互式PDF表单:
包含项目文件
在Java项目的类路径中包含客户端JAR文件,例如adobe-forms-client.jar。
创建Forms客户端API对象
ServiceClientFactory
包含连接属性的对象。FormsServiceClient
对象,使用它的构造函数传递 ServiceClientFactory
对象。指定URI值
URLSpec
使用其构造函数存储URI值的对象。URLSpec
对象的 setApplicationWebRoot
方法,并传递一个表示应用程序的Web根目录的字符串值。URLSpec
对象的 setContentRootURI
方法,并传递一个指定内容根URI值的字符串值。 确保表单设计位于内容根URI中。 否则,Forms服务会引发异常。 要引用存储库,请指定 repository:///
.URLSpec
对象的 setTargetURL
方法,并传递一个字符串值,该值指定要将表单数据发布到的目标URL值。 如果您在表单设计中定义目标URL,则可以传递空字符串。 您还可以指定将表单发送到哪个URL来执行计算。将文件附加到表单
创建 java.util.HashMap
对象以使用其构造函数存储文件附件。
调用 java.util.HashMap
对象的 put
每个文件附加到渲染表单的方法。 将以下值传递到此方法:
A 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浏览器
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
方法。使用Forms API(Web服务)呈现交互式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
每个文件附加到渲染表单的方法。 将以下值传递到此方法:
A 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浏览器的表单数据流。
将表单数据流写入客户端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
将表单数据流发送到客户端Web浏览器的方法。 将字节数组传递给 write
方法。将表单数据流写入客户端Web浏览器
Forms服务渲染表单时,会返回一个您必须写入客户端Web浏览器的表单数据流。 在写入客户端Web浏览器时,该表单对用户可见。