Show Menu
主题×

使用自定义CSS文件渲染HTML表单

Forms服务响应于来自Web浏览器的HTTP请求来呈现HTML表单。 呈现HTML表单时,Forms服务可引用自定义CSS文件。 您可以创建自定义CSS文件以满足您的业务要求,并在使用Forms服务渲染HTML表单时引用该CSS文件。
Forms服务将无提示地分析自定义CSS文件。 即,如果自定义CSS文件不符合CSS标准,则表单服务不会报告可能遇到的错误。 在这种情况下,Forms服务将忽略样式,并继续保留CSS文件中的其余样式。
以下列表指定自定义CSS文件中支持的样式:
  • 类级选择器——样式对 :如果自定义CSS文件中存在,则使用HTML表单中用作类样式的选择器。 将忽略未使用的类样式。
  • 标识符级别选择器——样式对 :如果在HTML表单中使用所有标识符样式,则使用这些样式。
  • 元素级选择器——样式对 :如果在HTML表单中使用所有元素样式,则会使用这些样式。
  • 样式优先级 :支持样式优先级(如重要内容),并可用于自定义CSS文件。
  • 媒体类型 :一个或多个选择器样式对可以封装在@media样式中以定义媒体类型。 Forms服务不检查是否支持指定的媒体类型。 在自定义CSS文件中指定的媒体类型将合并到HTML表单中。
您可以使用FormsIVS应用程序检索示例CSS文件。 上传表单,在“测试表单设计”页面中选择它,然后单击“生成CSS”。 单击按钮之前,无需设置HTML转换类型。 下一步选择保存。 您可以编辑此CSS文件以满足您的业务需求。
在渲染使用自定义CSS文件的HTML表单之前,请务必对渲染HTML表单有深入的了解。 (请参阅 将表单渲染为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表单

使用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 法并传递以下值:
    • 一个字符串值,它指定表单设计名称,包括文件扩展名。 如果引用的表单设计是表单应用程序的一部分,请确保指定完整路径,如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
    • 指定 TransformTo HTML首选项类型的enum值。 例如,要渲染与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单,请指定 TransformTo.MSDHTML
    • 包含 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)
    • 存储 URLSpec 呈现HTML表单所需的URI值的对象。
    • 存储 java.util.HashMap 文件附件的对象。 这是一个可选参数,您可以指 null 定是否不想将文件附加到表单。
    该方 (Deprecated) renderHTMLForm 法返回一个对 FormsResult 象,该对象包含必须写入客户端Web浏览器的表单数据流。
  5. 将表单数据流写入客户端Web浏览器
    • 通过 com.adobe.idp.Document 调用对象的方 FormsResult 法创建对 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 方法。
另请参阅

使用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 法并传递以下值:
    • 一个字符串值,它指定表单设计名称,包括文件扩展名。 如果引用的表单设计是表单应用程序的一部分,请确保指定完整路径,如 Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
    • 指定 TransformTo HTML首选项类型的enum值。 例如,要渲染与Internet Explorer 5.0或更高版本的动态HTML兼容的HTML表单,请指定 TransformTo.MSDHTML
    • 包含 BLOB 要与表单合并的数据的对象。 如果您不想合并数据,请传递 null 。 (请参阅 使用可流式布局预填充表单 。)
    • HTMLRenderSpec 储HTML运行时选项的对象。
    • 指定标题值的 HTTP_USER_AGENT 字符串值,如 Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322) 。 如果不想设置此值,可以传递空字符串。
    • 存储 URLSpec 呈现HTML表单所需的URI值的对象。
    • 存储 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 方法。
另请参阅