您可以使用Acrobat或Adobe Reader的客户端渲染功能优化PDF内容的投放并提高Forms服务处理网络负载的能力。 此过程称为在客户端渲染表单。 要在客户端渲染表单,客户端设备(通常为Web浏览器)必须使用Acrobat 7.0或Adobe Reader7.0或更高版本。
服务器端脚本执行对表单所做的更改不会反映在客户端呈现的表单中,除非根子表单包含设置为auto
的restoreState
属性。 有关此属性的详细信息,请参阅Forms设计器。
有关Forms服务的详细信息,请参见AEM Forms服务参考。
要在客户端渲染表单,请执行以下任务:
包括项目文件
将必要的文件包含在您的开发项目中。 如果您使用Java创建客户端应用程序,请包含必要的JAR文件。 如果您使用Web服务,请确保包含代理文件。
创建Forms客户端API对象
在以编程方式执行Forms服务客户端API操作之前,必须创建Forms服务客户端。 如果您使用Java API,请创建FormsServiceClient
对象。 如果您使用的是FormsWeb服务API,请创建一个FormsService
对象。
设置客户端渲染运行时选项
必须通过将RenderAtClient
run-time选项设置为true
,设置客户端渲染运行时选项以在客户端渲染表单。 这会导致表单被传送到呈现表单的客户端设备。 如果RenderAtClient
是auto
(默认值),表单设计将确定表单是否在客户端呈现。 表单设计必须是具有可流动布局的表单设计。
可以设置的可选运行时选项是SeedPDF
选项。 SeedPDF
选项将PDF容器(种子PDF文档)与表单设计和XML数据相结合。 表单设计和XML数据都交付到Acrobat或Adobe Reader,在那里可以呈现表单。 当客户端计算机没有表单中使用的字体时(例如,当最终用户未获得使用表单所有者有权使用的字体的许可时),可以使用SeedPDF
选项。
您可以使用设计器创建简单的动态PDF文件以用作种子PDF文件。 执行此任务需要执行以下步骤:
您无需定义种子PDF运行时选项即可在客户端上渲染表单。 如果不指定种子PDF,Forms服务将创建一个外壳pdf,它将不包含COS对象,但将包含一个PDF包装器,实际XDP内容嵌入其中。 本节中的步骤不设置种子PDF运行时选项。 有关COS对象的信息,请参阅《Adobe PDF参考指南》。
在客户端渲染表单
要在客户端上呈现表单,必须确保在呈现表单的应用程序逻辑中包含客户端呈现运行时选项。
将表单数据流写入客户端Web浏览器
Forms服务创建一个表单数据流,您必须将其写入客户端Web浏览器。 当写入到客户端Web浏览器时,表单由Acrobat 7.0或Adobe Reader7.0或更高版本渲染,并且用户可见。
另请参阅
使用FormsAPI(Java)在客户端渲染表单:
包括项目文件
在Java项目的类路径中包含客户端JAR文件,如adobe-forms-client.jar。
创建Forms客户端API对象
ServiceClientFactory
对象。FormsServiceClient
对象的构造函数创建ServiceClientFactory
对象。设置客户端渲染运行时选项
PDFFormRenderSpec
对象的构造函数创建<a0/>对象。PDFFormRenderSpec
对象的setRenderAtClient
方法并传递枚举值RenderAtClient.Yes
来设置RenderAtClient
运行时选项。在客户端渲染表单
调用FormsServiceClient
对象的renderPDFForm
方法并传递以下值:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
。com.adobe.idp.Document
对象,其中包含要与表单合并的数据。 如果不想合并数据,请传递一个空com.adobe.idp.Document
对象。PDFFormRenderSpec
对象,用于存储在客户端呈现表单所需的运行时选项。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
方法,创建一个javax.servlet.ServletOutputStream
对象,用于将表单数据流写入客户端Web浏览器。com.adobe.idp.Document
对象的getInputStream
方法创建java.io.InputStream
对象。InputStream
对象的read
方法并将字节数组作为参数进行传递,创建一个字节数组并将其填充为表单数据流。javax.servlet.ServletOutputStream
对象的write
方法,将表单数据流发送到客户端Web浏览器。 将字节数组传递给write
方法。另请参阅
快速开始(SOAP模式):使用Java API在客户端渲染表单
使用FormsAPI(Web服务)在客户端渲染表单:
包括项目文件
创建Forms客户端API对象
创建FormsService
对象并设置身份验证值。
设置客户端渲染运行时选项
PDFFormRenderSpec
对象的构造函数创建<a0/>对象。PDFFormRenderSpec
对象的setRenderAtClient
方法并传递字符串值RenderAtClient.Yes
,设置RenderAtClient
run-time选项。在客户端渲染表单
调用FormsService
对象的renderPDFForm
方法并传递以下值:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
。BLOB
对象,其中包含要与表单合并的数据。 如果不想合并数据,请传递null
。 (请参阅使用可流动布局预填充Forms。)PDFFormRenderSpec
对象,用于存储在客户端呈现表单所需的运行时选项。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
方法,创建一个javax.servlet.ServletOutputStream
对象,用于将表单数据流写入客户端Web浏览器。BLOB
对象的getBinaryData
方法填充它。 此任务将FormsResult
对象的内容分配给字节数组。javax.servlet.http.HttpServletResponse
对象的write
方法,将表单数据流发送到客户端Web浏览器。 将字节数组传递给write
方法。另请参阅