将文档传递到Forms服务 passing-documents-to-the-formsservice
本文档中的示例和示例仅适用于JEE环境上的AEM Forms 。
AEM Forms服务向客户端设备(通常是Web浏览器)呈现交互式PDF forms,以从用户那里收集信息。 交互式PDF表单基于表单设计,该表单设计通常保存为XDP文件并在Designer中创建。 从AEM Forms开始,您可以传递 com.adobe.idp.Document
包含表单设计到Forms服务的对象。 然后,Forms服务在中呈现表单设计 com.adobe.idp.Document
对象。
通过的优势 com.adobe.idp.Document
对象到Forms服务,即其他服务操作返回 com.adobe.idp.Document
实例。 那就是,你可以 com.adobe.idp.Document
来自另一个服务操作的实例并呈现它。 例如,假设XDP文件存储在名为的内容服务(已弃用)节点中 /Company Home/Form Designs
,如下图所示。
您可以以编程方式从内容服务中检索Loan.xdp(已弃用)(已弃用),并将XDP文件传递到Forms服务中的 com.adobe.idp.Document
对象。
步骤摘要 summary-of-steps
要将从Content Services(已弃用)获得的文档传递到Forms服务,请执行以下任务:
- 包括项目文件。
- 创建Forms和文档管理客户端API对象。
- 从Content Services检索表单设计(已弃用)。
- 呈现交互式PDF表单。
- 对表单数据流执行操作。
包含项目文件
在开发项目中包含必要的文件。 如果使用Java创建客户端应用程序,请包含必要的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建Forms和Document Management客户端API对象
在以编程方式执行Forms服务API操作之前,请先创建Forms客户端API对象。 此外,由于此工作流从内容服务中检索XDP文件(已弃用),因此请创建文档管理API对象。
从Content Services检索表单设计(已弃用)
使用Java或Web服务API从内容服务中检索XDP文件(已弃用)。 XDP文件将在 com.adobe.idp.Document
实例(或 BLOB
实例)。 然后,您可以传递 com.adobe.idp.Document
Forms服务的实例。
呈现交互式PDF表单
要呈现交互式表单,请传递 com.adobe.idp.Document
从Content Services(已弃用)返回到Forms服务的实例。
com.adobe.idp.Document
其中包含表单设计到Forms服务。 两个名为的新方法 renderPDFForm2
和 renderHTMLForm2
接受 com.adobe.idp.Document
包含表单设计的对象。对表单数据流执行操作
根据客户端应用程序的类型,可以将表单写入客户端Web浏览器或将表单另存为PDF文件。 基于Web的应用程序通常将表单写入Web浏览器。 但是,桌面应用程序通常将表单保存为PDF文件。
另请参阅
使用Java API将文档传递到Forms服务 pass-documents-to-the-forms-service-using-the-java-api
使用Forms服务和内容服务(已弃用)API (Java)传递从内容服务(已弃用)获得的文档:
-
包含项目文件
在Java项目的类路径中包含客户端JAR文件,例如adobe-forms-client.jar和adobe-contentservices-client.jar。
-
创建Forms和Document Management客户端API对象
- 创建
ServiceClientFactory
包含连接属性的对象。 (请参阅 设置连接属性.) - 创建
FormsServiceClient
对象,使用它的构造函数传递ServiceClientFactory
对象。 - 创建
DocumentManagementServiceClientImpl
对象,使用它的构造函数传递ServiceClientFactory
对象。
- 创建
-
从Content Services检索表单设计(已弃用)
调用
DocumentManagementServiceClientImpl
对象的retrieveContent
方法并传递以下值:- 一个字符串值,它指定添加内容的存储。 默认存储为
SpacesStore
. 此值是必需参数。 - 一个字符串值,它指定要检索的内容的完全限定路径(例如,
/Company Home/Form Designs/Loan.xdp
)。 此值是必需参数。 - 指定版本的字符串值。 此值是一个可选参数,您可以传递空字符串。 在这种情况下,将检索最新版本。
此
retrieveContent
方法返回CRCResult
包含XDP文件的对象。 获取com.adobe.idp.Document
通过调用CRCResult
对象的getDocument
方法。 - 一个字符串值,它指定添加内容的存储。 默认存储为
-
呈现交互式PDF表单
调用
FormsServiceClient
对象的renderPDFForm2
方法并传递以下值:- A
com.adobe.idp.Document
包含从Content Services检索到的表单设计的对象(已弃用)。 - A
com.adobe.idp.Document
包含要与表单合并的数据的对象。 如果不想合并数据,请传递一个空值com.adobe.idp.Document
对象。 - A
PDFFormRenderSpec
存储运行时选项的对象。 该值是一个可选参数,您可以指定null
如果您不想指定运行时选项。 - A
URLSpec
包含URI值的对象。 该值是一个可选参数,您可以指定null
. - A
java.util.HashMap
存储文件附件的对象。 该值是一个可选参数,您可以指定null
如果您不想将文件附加到表单。
此
renderPDFForm
方法返回FormsResult
包含必须写入客户端Web浏览器的表单数据流的对象。 - A
-
对表单数据流执行操作
- 创建
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
方法。
- 创建
另请参阅
快速入门(SOAP模式):使用Java API将文档传递到Forms服务
使用Web服务API将文档传递到Forms服务 pass-documents-to-the-forms-service-using-the-web-service-api
使用Forms服务和内容服务(已弃用)API(Web服务)传递从内容服务(已弃用)获得的文档:
-
包含项目文件
创建使用MTOM的Microsoft .NET项目。 由于此客户端应用程序调用两个AEM Forms服务,因此请创建两个服务引用。 对与Forms服务关联的服务引用使用以下WSDL定义:
http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1
.对与Document Management服务关联的服务引用使用以下WSDL定义:
http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1
.因为
BLOB
数据类型对两个服务引用都是通用的,完全限定BLOB
数据类型。 在相应的Web服务快速启动中,BLOB
实例是完全限定的。note note NOTE 替换 localhost
,其中包含托管AEM Forms的服务器的IP地址。 -
创建Forms和Document Management客户端API对象
-
创建
FormsServiceClient
对象使用默认构造函数。 -
创建
FormsServiceClient.Endpoint.Address
对象System.ServiceModel.EndpointAddress
构造函数。 将指定WSDL的字符串值传递给AEM Forms服务(例如,http://localhost:8080/soap/services/FormsService?WSDL
)。 您无需使用lc_version
属性。 此属性在创建服务引用时使用。) -
创建
System.ServiceModel.BasicHttpBinding
对象,方法是获取FormsServiceClient.Endpoint.Binding
字段。 将返回值强制转换为BasicHttpBinding
. -
设置
System.ServiceModel.BasicHttpBinding
对象的MessageEncoding
字段至WSMessageEncoding.Mtom
. 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证:
- 将AEM表单用户名分配给字段
FormsServiceClient.ClientCredentials.UserName.UserName
. - 将相应的密码值分配给字段
FormsServiceClient.ClientCredentials.UserName.Password
. - 分配常量值
HttpClientCredentialType.Basic
到字段BasicHttpBindingSecurity.Transport.ClientCredentialType
.
- 将AEM表单用户名分配给字段
-
分配常量值
BasicHttpSecurityMode.TransportCredentialOnly
到字段BasicHttpBindingSecurity.Security.Mode
.
note note NOTE 对重复这些步骤 DocumentManagementServiceClient
服务客户端。 -
-
从Content Services检索表单设计(已弃用)
通过调用
DocumentManagementServiceClient
对象的retrieveContent
方法并传递以下值:- 一个字符串值,它指定添加内容的存储。 默认存储为
SpacesStore
. 此值是必需参数。 - 一个字符串值,它指定要检索的内容的完全限定路径(例如,
/Company Home/Form Designs/Loan.xdp
)。 此值是必需参数。 - 指定版本的字符串值。 此值是一个可选参数,您可以传递空字符串。 在这种情况下,将检索最新版本。
- 用于存储浏览链接值的字符串输出参数。
- A
BLOB
用于存储内容的输出参数。 您可以使用此输出参数检索内容。 - A
ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType
用于存储内容属性的输出参数。 - A
CRCResult
输出参数。 除了使用此对象之外,您还可以使用BLOB
用于获取内容的输出参数。
- 一个字符串值,它指定添加内容的存储。 默认存储为
-
呈现交互式PDF表单
调用
FormsServiceClient
对象的renderPDFForm2
方法并传递以下值:- A
BLOB
包含从Content Services检索到的表单设计的对象(已弃用)。 - A
BLOB
包含要与表单合并的数据的对象。 如果不想合并数据,请传递一个空值BLOB
对象。 - A
PDFFormRenderSpec
存储运行时选项的对象。 该值是一个可选参数,您可以指定null
如果您不想指定运行时选项。 - A
URLSpec
包含URI值的对象。 该值是一个可选参数,您可以指定null
. - A
Map
存储文件附件的对象。 该值是一个可选参数,您可以指定null
如果您不想将文件附加到表单。 - 用于存储页数的长输出参数。
- 用于存储区域设置值的字符串输出参数。
- A
FormsResult
用于存储交互PDF表单的输出参数.
此
renderPDFForm2
方法返回FormsResult
包含交互式PDF表单的对象。 - A
-
对表单数据流执行操作
- 创建
BLOB
通过获取的值,包含表单数据的对象FormsResult
对象的outputContent
字段。 - 创建
System.IO.FileStream
对象通过调用其构造函数。 传递一个字符串值,该值表示交互式PDF文档的文件位置以及打开文件的模式。 - 创建一个字节数组,用于存储
BLOB
对象检索自FormsResult
对象。 通过获取的值,填充字节数组BLOB
对象的MTOM
数据成员。 - 创建
System.IO.BinaryWriter
对象通过调用其构造函数并传递System.IO.FileStream
对象。 - PDF通过调用
System.IO.BinaryWriter
对象的Write
和传递字节数组。
- 创建
另请参阅