将文档传递到Forms服务

本文档中的示例和示例仅适用于AEM Forms on JEE环境。

AEM Forms服务向客户端设备(通常是Web浏览器)呈现交互式PDF forms,以从用户那里收集信息。 交互式PDF表单基于表单设计,该表单设计通常保存为XDP文件并在Designer中创建。 从AEM Forms开始,您可以传递 com.adobe.idp.Document 包含表单设计到Forms服务的对象。 然后,Forms服务渲染位于 com.adobe.idp.Document 对象。

通过A的优点是 com.adobe.idp.Document Forms服务的对象是其他服务操作返回 com.adobe.idp.Document 实例。 那就是,你可以得到一个 com.adobe.idp.Document 来自另一个服务操作的实例并渲染它。 例如,假设XDP文件存储在名为的Content Services(已弃用)节点中 /Company Home/Form Designs,如下图所示。

您可以通过编程方式从Content Services(已弃用)中检索Loan.xdp(已弃用),并将XDP文件传递给Forms服务 com.adobe.idp.Document 对象。

注意

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

步骤摘要

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

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

包括项目文件

在开发项目中包含必要的文件。 如果要使用Java创建客户端应用程序,请包含必要的JAR文件。 如果使用Web服务,请包含代理文件。

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

在以编程方式执行Forms服务API操作之前,请先创建Forms客户端API对象。 此外,由于此工作流从内容服务中检索XDP文件(已弃用),因此请创建文档管理API对象。

从Content Services检索表单设计(已弃用)

使用Java或Web服务API从内容服务中检索XDP文件(已弃用)。 XDP文件返回于 com.adobe.idp.Document 实例(或 BLOB 实例(如果您使用Web服务)。 然后,您可以传递 com.adobe.idp.Document 实例添加到Forms服务。

渲染交互式PDF表单

要渲染交互式表单,请传递 com.adobe.idp.Document 从Content Services(已弃用)返回到Forms服务的实例。

注意

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

对表单数据流执行操作

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

另请参阅

包括AEM Forms Java库文件

设置连接属性

Forms服务API快速启动

使用Java API将文档传递到Forms服务

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

  1. 包括项目文件

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

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

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

  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 实例是完全限定的。

    注意

    Replace localhost包含托管AEM Forms的服务器的IP地址。

  2. 创建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服务客户端。

  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

在此页面上