使用提交的XML数据创建PDF文档 creating-pdf-documents-with-submittedxml-data
使用提交的XML数据创建PDF文档 creating-pdf-documents-with-submitted-xml-data
使用户能够填写交互式表单的基于Web的应用程序需要将数据提交回服务器。 使用Forms服务,您可以检索用户在交互式表单中输入的表单数据。 然后,您可以将表单数据传递到另一个AEM Forms服务操作,并使用该数据创建PDF文档。
请考虑以下涉及三项AEM Forms服务的工作流:
- 用户从基于Web的应用程序向Forms服务提交XML数据。
- Forms服务用于处理提交的表单和提取表单字段。 可以处理表单数据。 例如,数据可提交到企业数据库。
- 表单数据会发送到输出服务以创建非交互式PDF文档。
- 非交互式PDF文档存储在Content Services中(已弃用)。
下图提供了此工作流的可视化表示形式。
用户从客户端Web浏览器提交表单后,非交互式PDF文档将存储在Content Services中(已弃用)。 下图显示了存储在Content Services中的PDF文档(已弃用)。
步骤摘要 summary-of-steps
要使用提交的XML数据创建非交互式PDF文档并将其存储在Content Services的PDF文档中(已弃用),请执行以下任务:
- 包括项目文件。
- 创建Forms、输出和文档管理对象。
- 使用Forms服务检索表单数据。
- 使用输出服务创建非交互式PDF文档。
- 使用文档管理服务将PDF表单存储在内容服务(已弃用)中。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请确保包含代理文件。
创建Forms、输出和文档管理对象
在以编程方式执行Forms服务API操作之前,请先创建Forms客户端API对象。 同样,由于此工作流会调用输出和文档管理服务,因此请创建输出客户端API对象和文档管理客户端API对象。
使用Forms服务检索表单数据
检索已提交到Forms服务的表单数据。 您可以处理提交的数据以满足您的业务要求。 例如,您可以将表单数据存储在企业数据库中。 但是,要创建非交互式PDF文档,表单数据将传递到输出服务。
使用输出服务创建非交互式PDF文档。
使用输出服务创建基于表单设计和XML表单数据的非交互式PDF文档。 在工作流中,将从Forms服务中检索表单数据。
使用文档管理服务将PDF表单存储在内容服务(已弃用)中
使用文档管理服务API在Content Services中存储PDF文档(已弃用)。
另请参阅
使用Java API使用提交的XML数据创建PDF文档 create-a-pdf-document-with-submitted-xml-data-using-the-java-api
使用Forms、输出和文档管理API(Java)创建包含已提交XML数据的PDF文档:
-
包含项目文件
将客户端JAR文件(如adobe-forms-client.jar、adobe-output-client.jar和adobe-contentservices-client.jar)包含到您Java项目的类路径中。
-
创建Forms、输出和文档管理对象
- 创建
ServiceClientFactory
包含连接属性的对象。 - 创建
FormsServiceClient
对象,并使用其构造函数进行传递ServiceClientFactory
对象。 - 创建
OutputClient
对象,并使用其构造函数进行传递ServiceClientFactory
对象。 - 创建
DocumentManagementServiceClientImpl
对象,并使用其构造函数进行传递ServiceClientFactory
对象。
- 创建
-
使用Forms服务检索表单数据
-
调用
FormsServiceClient
对象processFormSubmission
方法并传递以下值:- 的
com.adobe.idp.Document
包含表单数据的对象。 - 一个字符串值,用于指定环境变量,包括所有相关的HTTP标头。 通过为
CONTENT_TYPE
环境变量。 例如,要处理XML数据,请为此参数指定以下字符串值:CONTENT_TYPE=text/xml
. - 指定
HTTP_USER_AGENT
标题值,例如Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
. - A
RenderOptionsSpec
用于存储运行时选项的对象。
的
processFormSubmission
方法返回FormsResult
包含表单提交结果的对象。 - 的
-
通过调用
FormsResult
对象getAction
方法。 如果此方法返回值0
,则数据已准备就绪,可供处理。 -
通过创建
com.adobe.idp.Document
对象FormsResult
对象getOutputContent
方法。 (此对象包含可发送到输出服务的表单数据。) -
创建
java.io.InputStream
对象java.io.DataInputStream
构造函数和传递com.adobe.idp.Document
对象。 -
创建
org.w3c.dom.DocumentBuilderFactory
对象(通过调用静态org.w3c.dom.DocumentBuilderFactory
对象newInstance
方法。 -
创建
org.w3c.dom.DocumentBuilder
对象org.w3c.dom.DocumentBuilderFactory
对象newDocumentBuilder
方法。 -
创建
org.w3c.dom.Document
对象org.w3c.dom.DocumentBuilder
对象parse
方法和通过java.io.InputStream
对象。 -
检索XML文档中每个节点的值。 完成此任务的一种方法是创建一个接受两个参数的自定义方法:the
org.w3c.dom.Document
对象以及要检索其值的节点的名称。 此方法会返回表示节点值的字符串值。 在此过程后面的代码示例中,此自定义方法称为getNodeText
. 此方法的正文如下。
-
-
使用输出服务创建非交互式PDF文档。
通过调用
OutputClient
对象generatePDFOutput
方法和传递以下值:- A
TransformationFormat
枚举值。 要生成PDF文档,请指定TransformationFormat.PDF
. - 指定表单设计名称的字符串值。 确保表单设计与从Forms服务中检索的表单数据兼容。
- 一个字符串值,用于指定表单设计所在的内容根目录。
- A
PDFOutputOptionsSpec
包含PDF运行时选项的对象。 - A
RenderOptionsSpec
包含呈现运行时选项的对象。 - 的
com.adobe.idp.Document
包含XML数据源的对象,该数据源包含要与表单设计合并的数据。 确保此对象由FormsResult
对象getOutputContent
方法。 - 的
generatePDFOutput
方法返回OutputResult
包含操作结果的对象。 - 通过调用
OutputResult
对象getGeneratedDoc
方法。 此方法将返回com.adobe.idp.Document
表示非交互式PDF文档的实例。
- A
-
使用文档管理服务将PDF表单存储在内容服务(已弃用)中
通过调用
DocumentManagementServiceClientImpl
对象storeContent
方法和传递以下值:- 一个字符串值,用于指定添加内容的商店。 默认存储区为
SpacesStore
. 此值是必需参数。 - 一个字符串值,用于指定添加内容的空间的完全限定路径(例如,
/Company Home/Test Directory
)。 此值是必需参数。 - 表示新内容的节点名称(例如,
MortgageForm.pdf
)。 此值是必需参数。 - 指定节点类型的字符串值。 要添加新内容(如PDF文件),请指定
{https://www.alfresco.org/model/content/1.0}content
. 此值是必需参数。 - A
com.adobe.idp.Document
表示内容的对象。 此值是必需参数。 - 指定编码值的字符串值(例如,
UTF-8
)。 此值是必需参数。 - 安
UpdateVersionType
指定如何处理版本信息的枚举值(例如,UpdateVersionType.INCREMENT_MAJOR_VERSION
以递增内容版本。 )此值是必需参数。 - A
java.util.List
用于指定与内容相关的方面的实例。 此值是一个可选参数,您可以指定null
. - A
java.util.Map
用于存储内容属性的对象。
的
storeContent
方法返回CRCResult
描述内容的对象。 使用CRCResult
对象中,例如,您可以获取内容的唯一标识符值。 要执行此任务,请调用CRCResult
对象getNodeUuid
方法。 - 一个字符串值,用于指定添加内容的商店。 默认存储区为
另请参阅