本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
Forms服务将交互式PDF forms呈现到客户端设备(通常是Web浏览器),以从用户收集信息。 呈现交互式表单后,用户可以将数据输入到表单字段中,然后单击表单上的提交按钮以将信息发送回Forms服务。 Adobe Reader或Acrobat必须安装在承载客户端Web浏览器的计算机上,才能显示交互式PDF表单。
在使用Forms服务渲染表单之前,请先创建表单设计。 通常,表单设计在Designer中创建并保存为XDP文件。 有关创建表单设计的信息,请参阅Forms Designer。
贷款申请示例
引入了一个贷款应用程序示例,用于演示Forms服务如何使用交互式表单从用户处收集信息。 此应用程序允许用户用确保贷款安全所需的数据填写表单,然后向Forms服务提交数据。 下图显示了贷款应用程序的逻辑流。
下表介绍了此图中的步骤。
步骤 |
描述 |
---|---|
1 |
从HTML页调用 |
2 |
|
3 |
用户填写贷款表单并单击提交按钮后,数据将提交到 |
4 |
|
5 |
确认表单将呈现回Web浏览器。 呈现表单之前,会将用户的名和姓等数据与表单合并。 (请参阅使用可流式布局预填充Forms。) |
贷款表
此交互式贷款表由示例贷款应用程序的GetLoanForm
Java Servlet呈现。
确认表单
此表单由示例贷款应用程序的HandleData
Java Servlet呈现。
HandleData
Java Servlet使用用户的名和姓以及amount预填充此表单。 预填充表单后,表单将发送到客户端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 Client API对象
在以编程方式执行Forms服务客户端API操作之前,必须创建Forms客户端API对象。 如果您使用Java API,请创建FormsServiceClient
对象。 如果您使用Forms Web服务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服务。)
将文件附加到表单
您可以将文件附加到表单。 当您渲染带有文件附件的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 Client API对象
ServiceClientFactory
对象。FormsServiceClient
对象的构造函数并传递ServiceClientFactory
对象,创建对象。指定URI值
URLSpec
对象,该对象使用其构造函数存储URI值。URLSpec
对象的setApplicationWebRoot
方法并传递一个字符串值,该值表示应用程序的Web根目录。URLSpec
对象的setContentRootURI
方法并传递一个指定内容根URI值的字符串值。 确保表单设计位于内容根URI中。 否则,Forms服务将引发异常。 要引用存储库,请指定repository:///
。URLSpec
对象的setTargetURL
方法并传递一个字符串值,该字符串值指定将表单目标发布到的位置。 如果在表单设计中定义目标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(Web服务)渲染交互式PDF表单:
包括项目文件
创建Forms Client API对象
创建FormsService
对象并设置身份验证值。
指定URI值
URLSpec
对象,该对象使用其构造函数存储URI值。URLSpec
对象的setApplicationWebRoot
方法并传递一个字符串值,该值表示应用程序的Web根目录。URLSpec
对象的setContentRootURI
方法并传递一个指定内容根URI值的字符串值。 确保表单设计位于内容根URI中。 否则,Forms服务将引发异常。 要引用存储库,请指定repository:///
。URLSpec
对象的setTargetURL
方法并传递一个字符串值,该字符串值指定将表单目标发布到的位置。 如果在表单设计中定义目标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
方法使用必须写入客户端Web浏览器的表单数据流填充作为最后一个参数值传递的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浏览器的表单数据流。 写入到客户端Web浏览器时,用户可以看到表单。