按值呈现Forms

通常，在Designer中创建的表单设计会通过引用Forms服务来传递。 表单设计可能很大，因此，通过引用传递它们更有效，以避免必须按值将表单设计字节汇总起来。 Forms服务还可以缓存表单设计，这样在缓存表单时，它不必持续读取表单设计。

如果表单设计包含UUID属性，则会缓存该属性。 UUID值对于所有表单设计都是唯一的，用于唯一标识表单。 按值呈现表单时，仅应在重复使用表单时缓存表单。 但是，如果表单不重复使用且必须是唯一的，则可以避免使用使用使用AEM FormsAPI设置的缓存选项来缓存表单。

Forms服务还可以解析表单设计中链接内容的位置。 例如，从表单设计中引用的链接图像是相对URL。 链接的内容始终被假定为相对于表单设计位置。 因此，解析链接内容是通过将相对路径应用到绝对表单设计位置来确定其位置的问题。

您可以按值传递表单设计，而不是按引用传递表单设计。 动态创建表单设计时，按值传递表单设计是有效的；即，当客户端应用程序在运行时生成创建表单设计的XML时。 在这种情况下，表单设计不会存储在物理存储库中，因为它存储在内存中。 在运行时动态创建表单设计并按值传递它时，您可以缓存表单并提高Forms服务的性能。

按值传递表单的限制

按值传递表单设计时适用以下限制：

• 表单设计中不能包含任何相对链接的内容。 所有图像和片段必须嵌入到表单设计中，或者绝对引用。
• 无法在呈现表单后执行服务器端计算。 如果表单提交回Forms服务，则数据将被提取并返回，而无需任何服务器端计算。
• 由于HTML在运行时只能使用链接的图像，因此无法生成包含嵌入图像的HTML。 这是因为Forms服务通过从引用的表单设计检索图像来支持带有HTML的嵌入图像。 由于按值传递的表单设计没有引用的位置，因此在显示HTML页面时无法提取嵌入的图像。 因此，图像引用必须是要在HTML中呈现的绝对路径。

步骤的摘要

要按值呈现表单，请执行以下步骤：

1. 包括项目文件。
2. 创建一个Forms客户端API对象。
3. 参考表单设计。
4. 按值呈现表单。
5. 将表单数据流写入客户端Web浏览器。

包括项目文件

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

创建Forms客户端API对象

在以编程方式将数据导入PDF表单客户端API之前，必须创建数据集成服务客户端。 在创建服务客户端时，您定义调用服务所需的连接设置。

参考表单设计

按值呈现表单时，必须创建一个com.adobe.idp.Document对象，其中包含要呈现的表单设计。 您可以引用现有XDP文件，也可以在运行时动态创建表单设计并用该数据填充com.adobe.idp.Document。

按值呈现表单

要按值呈现表单，请将包含表单设计的com.adobe.idp.Document实例传递给呈现方法的inDataDoc参数（可以是FormsServiceClient对象的任何呈现方法，如renderPDFForm、(Deprecated) renderHTMLForm等）。 此参数值通常为与表单合并的数据保留。 同样，将空字符串值传递给formQuery参数。 通常，此参数需要一个指定表单设计名称的字符串值。

将表单数据流写入客户端Web浏览器

当Forms服务按值呈现表单时，它会返回一个表单数据流，您必须将该数据流写入客户端Web浏览器。 写入客户端Web浏览器时，用户可以看到表单。

另请参阅

使用Java API按值呈现表单

使用Web服务API按值呈现表单

包括AEM FormsJava库文件

设置连接属性

Forms服务API快速开始

将文档送至Forms

创建呈现Forms的Web 应用程序

使用Java API按值呈现表单

使用FormsAPI(Java)按值渲染表单：

1. 包括项目文件

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

2. 创建Forms客户端API对象

   • 创建包含连接属性的ServiceClientFactory对象。
   • 使用FormsServiceClient对象的构造函数创建ServiceClientFactory对象。

3. 参考表单设计

   • 创建一个java.io.FileInputStream对象，该对象通过使用其构造函数并传递指定XDP文件位置的字符串值来表示要呈现的表单设计。
   • 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。

4. 按值呈现表单

   调用FormsServiceClient对象的renderPDFForm方法并传递以下值：

   • 空字符串值。 （通常，此参数需要一个指定表单设计名称的字符串值。）
   • 包含表单设计的com.adobe.idp.Document对象。 通常，此参数值是为与表单合并的数据保留的。
   • 存储运行时选项的PDFFormRenderSpec对象。 这是可选参数，如果不想指定运行时选项，可以指定null。
   • 一个URLSpec对象，它包含Forms服务所需的URI值。
   • 存储文件附件的java.util.HashMap对象。 这是可选参数，如果不想将文件附加到表单，可以指定null。

   renderPDFForm方法返回一个FormsResult对象，该对象包含一个可写入客户端Web浏览器的表单数据流。

5. 将表单数据流写入客户端Web浏览器

   • 通过调用FormsResult对象“s getOutputContent方法创建com.adobe.idp.Document对象。
   • 通过调用getContentType方法获取com.adobe.idp.Document对象的内容类型。
   • 通过调用setContentType方法并传递com.adobe.idp.Document对象的内容类型，设置javax.servlet.http.HttpServletResponse对象的内容类型。
   • 通过调用javax.servlet.http.HttpServletResponse对象的getOutputStream方法，创建一个javax.servlet.ServletOutputStream对象，用于将表单数据流写入客户端Web浏览器。
   • 通过调用com.adobe.idp.Document对象的getInputStream方法创建java.io.InputStream对象。
   • 创建一个字节数组并分配InputStream对象的大小。 调用InputStream对象的available方法以获取InputStream对象的大小。
   • 通过调用InputStream对象的read方法并将字节数组作为参数进行传递，用表单数据流填充字节数组。
   • 调用javax.servlet.ServletOutputStream对象的write方法，将表单数据流发送到客户端Web浏览器。 将字节数组传递给write方法。

另请参阅

按价值呈现Forms

快速开始（SOAP模式）:使用Java API按值呈现

包括AEM FormsJava库文件

设置连接属性

使用Web服务API按值呈现表单

使用FormsAPI（Web服务）按值渲染表单：

1. 包括项目文件

   • 创建使用Forms服务WSDL的Java代理类。
   • 将Java代理类包含到类路径中。

2. 创建Forms客户端API对象

   创建FormsService对象并设置身份验证值。

3. 参考表单设计

   • 使用java.io.FileInputStream对象的构造函数创建对象。 传递一个指定XDP文件位置的字符串值。
   • 使用BLOB对象的构造函数创建对象。 BLOB对象用于存储使用密码加密的PDF文档。
   • 创建存储java.io.FileInputStream对象内容的字节数组。 通过使用available方法获取java.io.FileInputStream对象的大小，可以确定字节数组的大小。
   • 通过调用java.io.FileInputStream对象的read方法并传递字节数组，用流数据填充字节数组。
   • 通过调用setBinaryData方法并传递字节数组来填充BLOB对象。

4. 按值呈现表单

   调用FormsService对象的renderPDFForm方法并传递以下值：

   • 空字符串值。 （通常，此参数需要一个指定表单设计名称的字符串值。）
   • 包含表单设计的BLOB对象。 通常，此参数值是为与表单合并的数据保留的。
   • 存储运行时选项的PDFFormRenderSpec对象。 这是可选参数，如果不想指定运行时选项，可以指定null。
   • 一个URLSpec对象，它包含Forms服务所需的URI值。
   • 存储文件附件的java.util.HashMap对象。 这是可选参数，如果不想将文件附加到表单，可以指定null。
   • 由方法填充的空com.adobe.idp.services.holders.BLOBHolder对象。 它用于存储呈现的PDF表单。
   • 由方法填充的空javax.xml.rpc.holders.LongHolder对象。 （此参数存储表单中的页数。）
   • 由方法填充的空javax.xml.rpc.holders.StringHolder对象。 （此参数存储区域设置值。）
   • 将包含此操作结果的空com.adobe.idp.services.holders.FormsResultHolder对象。

   renderPDFForm方法使用必须写入客户端Web浏览器的表单数据流填充作为最后一个参数值传递的com.adobe.idp.services.holders.FormsResultHolder对象。

5. 将表单数据流写入客户端Web浏览器

   • 通过获取com.adobe.idp.services.holders.FormsResultHolder对象的value数据成员的值，创建FormResult对象。
   • 通过调用FormsResult对象的getOutputContent方法，创建包含表单数据的BLOB对象。
   • 通过调用getContentType方法获取BLOB对象的内容类型。
   • 通过调用setContentType方法并传递BLOB对象的内容类型，设置javax.servlet.http.HttpServletResponse对象的内容类型。
   • 通过调用javax.servlet.http.HttpServletResponse对象的getOutputStream方法，创建一个javax.servlet.ServletOutputStream对象，用于将表单数据流写入客户端Web浏览器。
   • 创建一个字节数组，并通过调用BLOB对象的getBinaryData方法填充它。 此任务将FormsResult对象的内容分配给字节数组。
   • 调用javax.servlet.http.HttpServletResponse对象的write方法，将表单数据流发送到客户端Web浏览器。 将字节数组传递给write方法。

另请参阅

按价值呈现Forms

使用Base64编码调用AEM Forms