呈现HTMLForms(使用自定义CSS文件) rendering-html-forms-using-custom-css-files
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文件以满足您的业务要求。
步骤摘要 summary-of-steps
要渲染使用CSS文件的HTML表单,请执行以下任务:
- 包括项目文件。
- 创建Forms Java API对象。
- 引用CSS文件。
- 呈现HTML表单。
- 将表单数据流写入客户端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表单 render-an-html-form-that-uses-a-css-file-using-the-java-api
使用Forms API(Java)渲染使用自定义CSS文件的HTML表单:
-
包含项目文件
在Java项目的类路径中包含客户端JAR文件,如adobe-forms-client.jar。
-
创建Forms Java API对象
- 创建
ServiceClientFactory
包含连接属性的对象。 - 创建
FormsServiceClient
对象,并使用其构造函数进行传递ServiceClientFactory
对象。
- 创建
-
引用CSS文件
- 创建
HTMLRenderSpec
对象。 - 要渲染使用自定义CSS文件的HTML表单,请调用
HTMLRenderSpec
对象setCustomCSSURI
方法,并传递一个字符串值,以指定CSS文件的位置和名称。
- 创建
-
呈现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浏览器的表单数据流的对象。 - 指定表单设计名称(包括文件扩展名)的字符串值。 如果您引用的表单设计是Forms应用程序的一部分,请确保指定完整路径,例如
-
将表单数据流写入客户端Web浏览器
- 创建
com.adobe.idp.Document
对象FormsResult
对象sgetOutputContent
方法。 - 获取的内容类型
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
方法。
- 创建
另请参阅
快速入门(SOAP模式):使用Java API呈现使用CSS文件的HTML表单
使用Web服务API渲染使用CSS文件的HTML表单 render-an-html-form-that-uses-a-css-file-using-the-web-service-api
使用Forms API(Web服务)呈现使用自定义CSS文件的HTML表单:
-
包含项目文件
- 创建使用Forms服务WSDL的Java代理类。
- 在类路径中包含Java代理类。
-
创建Forms Java API对象
创建
FormsService
对象,并设置身份验证值。 -
引用CSS文件
- 创建
HTMLRenderSpec
对象。 - 要渲染使用自定义CSS文件的HTML表单,请调用
HTMLRenderSpec
对象setCustomCSSURI
方法,并传递一个字符串值,以指定CSS文件的位置和名称。
- 创建
-
呈现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浏览器。 - 指定表单设计名称(包括文件扩展名)的字符串值。 如果您引用的表单设计是Forms应用程序的一部分,请确保指定完整路径,例如
-
将表单数据流写入客户端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
方法。
- 创建
另请参阅