将文档传递到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 对象。

NOTE
有关Forms服务的更多信息,请参阅 AEM Forms的服务参考.

步骤摘要 summary-of-steps

要将从Content Services(已弃用)获得的文档传递到Forms服务,请执行以下任务:

  1. 包括项目文件。
  2. 创建Forms和文档管理客户端API对象。
  3. 从Content Services检索表单设计(已弃用)。
  4. 呈现交互式PDF表单。
  5. 对表单数据流执行操作。

包含项目文件

在开发项目中包含必要的文件。 如果使用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服务的实例。

NOTE
您可以传递 com.adobe.idp.Document 其中包含表单设计到Forms服务。 两个名为的新方法 renderPDFForm2renderHTMLForm2 接受 com.adobe.idp.Document 包含表单设计的对象。

对表单数据流执行操作

根据客户端应用程序的类型,可以将表单写入客户端Web浏览器或将表单另存为PDF文件。 基于Web的应用程序通常将表单写入Web浏览器。 但是,桌面应用程序通常将表单保存为PDF文件。

另请参阅

包括AEM Forms Java库文件

设置连接属性

Forms服务API快速启动

使用Java API将文档传递到Forms服务 pass-documents-to-the-forms-service-using-the-java-api

使用Forms服务和内容服务(已弃用)API (Java)传递从内容服务(已弃用)获得的文档:

  1. 包含项目文件

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

  2. 创建Forms和Document Management客户端API对象

    • 创建 ServiceClientFactory 包含连接属性的对象。 (请参阅 设置连接属性.)
    • 创建 FormsServiceClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
    • 创建 DocumentManagementServiceClientImpl 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 从Content Services检索表单设计(已弃用)

    调用 DocumentManagementServiceClientImpl 对象的 retrieveContent 方法并传递以下值:

    • 一个字符串值,它指定添加内容的存储。 默认存储为 SpacesStore. 此值是必需参数。
    • 一个字符串值,它指定要检索的内容的完全限定路径(例如, /Company Home/Form Designs/Loan.xdp)。 此值是必需参数。
    • 指定版本的字符串值。 此值是一个可选参数,您可以传递空字符串。 在这种情况下,将检索最新版本。

    retrieveContent 方法返回 CRCResult 包含XDP文件的对象。 获取 com.adobe.idp.Document 通过调用 CRCResult 对象的 getDocument 方法。

  4. 呈现交互式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浏览器的表单数据流的对象。

  5. 对表单数据流执行操作

    • 创建 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服务

包括AEM Forms Java库文件

设置连接属性

使用Web服务API将文档传递到Forms服务 pass-documents-to-the-forms-service-using-the-web-service-api

使用Forms服务和内容服务(已弃用)API(Web服务)传递从内容服务(已弃用)获得的文档:

  1. 包含项目文件

    创建使用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地址。
  2. 创建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.
    • 分配常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

    note note
    NOTE
    对重复这些步骤 DocumentManagementServiceClient服务客户端。
  3. 从Content Services检索表单设计(已弃用)

    通过调用 DocumentManagementServiceClient 对象的 retrieveContent 方法并传递以下值:

    • 一个字符串值,它指定添加内容的存储。 默认存储为 SpacesStore. 此值是必需参数。
    • 一个字符串值,它指定要检索的内容的完全限定路径(例如, /Company Home/Form Designs/Loan.xdp)。 此值是必需参数。
    • 指定版本的字符串值。 此值是一个可选参数,您可以传递空字符串。 在这种情况下,将检索最新版本。
    • 用于存储浏览链接值的字符串输出参数。
    • A BLOB 用于存储内容的输出参数。 您可以使用此输出参数检索内容。
    • A ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType 用于存储内容属性的输出参数。
    • A CRCResult 输出参数。 除了使用此对象之外,您还可以使用 BLOB 用于获取内容的输出参数。
  4. 呈现交互式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表单的对象。

  5. 对表单数据流执行操作

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

另请参阅

使用MTOM调用AEM Forms

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2