呈现HTMLForms（使用自定义CSS文件）

最近更新： 2023年5月4日

创建对象：

  • 开发人员
注意
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

Forms服务会响应Web浏览器的HTTP请求来呈现HTML表单。 呈现HTML表单时，Forms服务可以引用自定义CSS文件。 您可以创建自定义CSS文件以满足您的业务要求，并在使用Forms服务渲染HTML表单时引用该CSS文件。

Forms服务会静默解析自定义CSS文件。 也就是说，如果自定义CSS文件不符合CSS标准，Forms服务不会报告可能遇到的错误。 在这种情况下，Forms服务将忽略样式，并继续保留位于CSS文件中的其余样式。

以下列表指定自定义CSS文件支持的样式：

  • 类级别选择器样式对:如果自定义CSS文件中存在，则会使用HTML表单中用作类样式的选择器。 将忽略未使用的类样式。
  • 标识符级别选择器样式对:如果在HTML表单中使用所有标识符样式，则会使用这些样式。
  • 元素级别选择器样式对:如果在HTML表单中使用所有元素样式，则会使用这些样式。
  • 样式优先级:支持样式优先级（与重要信息一样），并可在自定义CSS文件中使用。
  • 媒体类型:一个或多个选择器样式对可封装在@media样式中以定义媒体类型。 Forms服务不检查指定的媒体类型是否受支持。 在自定义CSS文件中指定的媒体类型将合并到HTML表单中。

您可以使用FormsIVS应用程序检索示例CSS文件。 上载表单，在“测试表单设计”页面中选择该表单，然后单击生成CSS。 单击按钮之前，您无需设置HTML转换类型。 接下来选择保存。 您可以编辑此CSS文件以满足您的业务要求。

注意
在渲染使用自定义CSS文件的HTML表单之前，您必须对渲染HTML表单有扎实的了解。 (请参阅 将Forms渲染为HTML.)
注意
有关Forms服务的更多信息，请参阅 AEM Forms服务参考.

步骤摘要

要渲染使用CSS文件的HTML表单，请执行以下任务：

  1. 包括项目文件。
  2. 创建Forms Java API对象。
  3. 引用CSS文件。
  4. 呈现HTML表单。
  5. 将表单数据流写入客户端Web浏览器。

包含项目文件

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

创建Forms Java API对象

您必须先创建一个Forms客户端对象，然后才能以编程方式执行Forms服务支持的操作。

引用CSS文件

要渲染使用自定义CSS文件的HTML表单，请确保引用现有CSS文件。

呈现HTML表单

要渲染HTML表单，必须指定在Designer中创建并另存为XDP文件的表单设计。 您还必须选择HTML转换类型。 例如，您可以指定用于为Internet Explorer 5.0或更高版本呈现动态HTML的HTML转换类型。

呈现HTML表单还需要值，例如呈现其他表单类型所需的URI值。

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

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

另请参阅

使用Java API呈现使用CSS文件的HTML表单

包括AEM Forms Java库文件

设置连接属性

Forms Service API快速入门

呈现交互式PDF forms

将Forms渲染为HTML

创建可渲染Forms的Web应用程序

使用Java API呈现使用CSS文件的HTML表单

使用Forms API(Java)渲染使用自定义CSS文件的HTML表单：

  1. 包含项目文件

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

  2. 创建Forms Java API对象

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 FormsServiceClient 对象，并使用其构造函数进行传递 ServiceClientFactory 对象。

  3. 引用CSS文件

    • 创建 HTMLRenderSpec 对象。
    • 要渲染使用自定义CSS文件的HTML表单，请调用 HTMLRenderSpec 对象 setCustomCSSURI 方法，并传递一个字符串值，以指定CSS文件的位置和名称。

  4. 呈现HTML表单

    调用 FormsServiceClient 对象 (Deprecated) (Deprecated) renderHTMLForm 方法并传递以下值：

    • 指定表单设计名称（包括文件扩展名）的字符串值。 如果您引用的表单设计是Forms应用程序的一部分，请确保指定完整路径，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
    • A TransformTo 指定HTML首选项类型的枚举值。 例如，要渲染与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单，请指定 TransformTo.MSDHTML.
    • A com.adobe.idp.Document 包含要与表单合并的数据的对象。 如果不想合并数据，请传递一个空 com.adobe.idp.Document 对象。
    • 的 HTMLRenderSpec 用于存储HTML运行时选项的对象。
    • 指定 HTTP_USER_AGENT 标题值，例如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
    • A URLSpec 用于存储呈现HTML表单所需URI值的对象。
    • A java.util.HashMap 用于存储文件附件的对象。 这是一个可选参数，您可以指定 null 如果您不想将文件附加到表单。

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

  5. 将表单数据流写入客户端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.h\ttp.HttpServletResponse 对象 getOutputStream 方法。
    • 创建 java.io.InputStream 对象 com.adobe.idp.Document 对象 getInputStream 方法。
    • 通过调用 InputStream 对象 read 方法并将字节数组作为参数进行传递。
    • 调用 javax.servlet.ServletOutputStream 对象 write 将表单数据流发送到客户端web浏览器的方法。 将字节数组传递到 write 方法。

另请参阅

呈现HTMLForms（使用自定义CSS文件）

快速入门（SOAP模式）：使用Java API呈现使用CSS文件的HTML表单

包括AEM Forms Java库文件

设置连接属性

使用Web服务API渲染使用CSS文件的HTML表单

使用Forms API（Web服务）呈现使用自定义CSS文件的HTML表单：

  1. 包含项目文件

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

  2. 创建Forms Java API对象

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

  3. 引用CSS文件

    • 创建 HTMLRenderSpec 对象。
    • 要渲染使用自定义CSS文件的HTML表单，请调用 HTMLRenderSpec 对象 setCustomCSSURI 方法，并传递一个字符串值，以指定CSS文件的位置和名称。

  4. 呈现HTML表单

    调用 FormsService 对象 (Deprecated) renderHTMLForm 方法并传递以下值：

    • 指定表单设计名称（包括文件扩展名）的字符串值。 如果您引用的表单设计是Forms应用程序的一部分，请确保指定完整路径，例如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
    • A TransformTo 指定HTML首选项类型的枚举值。 例如，要渲染与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单，请指定 TransformTo.MSDHTML.
    • A BLOB 包含要与表单合并的数据的对象。 如果不想合并数据，请传递 null. (请参阅 使用可流动布局预填充Forms.)
    • 的 HTMLRenderSpec 用于存储HTML运行时选项的对象。
    • 指定 HTTP_USER_AGENT 标题值，例如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). 如果不想设置此值，可以传递空字符串。
    • A URLSpec 用于存储呈现HTML表单所需URI值的对象。
    • A java.util.HashMap 用于存储文件附件的对象。 这是一个可选参数，您可以指定 null 如果您不想将文件附加到表单。
    • 空 com.adobe.idp.services.holders.BLOBHolder 由填充的对象 (Deprecated) renderHTMLForm 方法。 此参数值存储呈现的表单。
    • 空 com.adobe.idp.services.holders.BLOBHolder 由填充的对象 (Deprecated) renderHTMLForm 方法。 此参数存储输出XML数据。
    • 空 javax.xml.rpc.holders.LongHolder 由填充的对象 (Deprecated) renderHTMLForm 方法。 此参数以表单形式存储页数。
    • 空 javax.xml.rpc.holders.StringHolder 由填充的对象 (Deprecated) renderHTMLForm 方法。 此参数存储区域设置值。
    • 空 javax.xml.rpc.holders.StringHolder 由填充的对象 (Deprecated) renderHTMLForm 方法。 此参数存储所用的HTML呈现值。
    • 空 com.adobe.idp.services.holders.FormsResultHolder 包含此操作结果的对象。

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

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

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

另请参阅

呈现HTMLForms（使用自定义CSS文件）

使用Base64编码调用AEM Forms