将文档传递到Forms服务 passing-documents-to-the-formsservice

包含项目文件

将客户端JAR文件（如adobe-forms-client.jar和adobe-contentservices-client.jar）包含在您Java项目的类路径中。

创建Forms和文档管理客户端API对象

• 创建 ServiceClientFactory 包含连接属性的对象。 (请参阅 设置连接属性.)
• 创建 FormsServiceClient 对象，并使用其构造函数进行传递 ServiceClientFactory 对象。
• 创建 DocumentManagementServiceClientImpl 对象，并使用其构造函数进行传递 ServiceClientFactory 对象。

从内容服务中检索表单设计（已弃用）

调用 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 包含从内容服务中检索的表单设计的对象（已弃用）。
• A com.adobe.idp.Document 包含要与表单合并的数据的对象。 如果不想合并数据，请传递一个空 com.adobe.idp.Document 对象。
• A PDFFormRenderSpec 用于存储运行时选项的对象。 此值是一个可选参数，您可以指定 null 如果您不想指定运行时选项，请执行以下操作：
• A URLSpec 包含URI值的对象。 此值是一个可选参数，您可以指定 null.
• A java.util.HashMap 用于存储文件附件的对象。 此值是一个可选参数，您可以指定 null 如果您不想将文件附加到表单。

的 renderPDFForm 方法返回 FormsResult 包含必须写入客户端web浏览器的表单数据流的对象。

对表单数据流执行操作

• 创建 com.adobe.idp.Document 对象 FormsResult 对象s getOutputContent 方法。
• 获取的内容类型 com.adobe.idp.Document 通过调用对象 getContentType 方法。
• 设置 javax.servlet.http.HttpServletResponse 对象的内容类型(通过调用 setContentType 方法和传递 com.adobe.idp.Document 对象。
• 创建 javax.servlet.ServletOutputStream 用于通过调用将表单数据流写入客户端web浏览器的对象 javax.servlet.http.HttpServletResponse 对象 getOutputStream 方法。
• 创建 java.io.InputStream 对象 com.adobe.idp.Document 对象 getInputStream 方法。
• 通过调用 InputStream 对象 read 方法。 将字节数组作为参数传递。
• 调用 javax.servlet.ServletOutputStream 对象 write 将表单数据流发送到客户端web浏览器的方法。 将字节数组传递到 write 方法。

包含项目文件

创建使用MTOM的Microsoft .NET项目。 由于此客户端应用程序调用两个AEM Forms服务，因此请创建两个服务引用。 对与Forms服务关联的服务引用使用以下WSDL定义： http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

对与文档管理服务关联的服务引用使用以下WSDL定义： http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

因为 BLOB 数据类型对于两个服务引用都是通用的，可完全限定 BLOB 数据类型。 在相应的Web服务快速启动中， BLOB 实例完全限定。

创建Forms和文档管理客户端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.

• 指定常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

从内容服务中检索表单设计（已弃用）

通过调用 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 包含从内容服务中检索的表单设计的对象（已弃用）。
• A BLOB 包含要与表单合并的数据的对象。 如果不想合并数据，请传递一个空 BLOB 对象。
• A PDFFormRenderSpec 用于存储运行时选项的对象。 此值是一个可选参数，您可以指定 null 如果您不想指定运行时选项，请执行以下操作：
• A URLSpec 包含URI值的对象。 此值是一个可选参数，您可以指定 null.
• A Map 用于存储文件附件的对象。 此值是一个可选参数，您可以指定 null 如果您不想将文件附加到表单。
• 用于存储页面计数的长输出参数。
• 用于存储区域设置值的字符串输出参数。
• A FormsResult 用于存储交互PDF表单的输出参数 .

的 renderPDFForm2 方法返回 FormsResult 包含交互式PDF表单的对象。

对表单数据流执行操作

• 创建 BLOB 包含表单数据的对象，方法是通过获取 FormsResult 对象 outputContent 字段。
• 创建 System.IO.FileStream 对象。 传递一个字符串值，以表示交互式PDF文档的文件位置以及打开文件的模式。
• 创建用于存储 BLOB 从检索的对象 FormsResult 对象。 通过获取 BLOB 对象 MTOM 数据成员。
• 创建 System.IO.BinaryWriter 对象，方法是调用其构造函数并传递 System.IO.FileStream 对象。
• 通过调用 System.IO.BinaryWriter 对象 Write 方法和传递字节数组。