Representación de HTML Forms mediante archivos CSS personalizados
Los ejemplos y ejemplos de este documento son solo para AEM Forms en un entorno JEE.
El servicio Forms procesa formularios HTML en respuesta a una solicitud HTTP de un explorador web. Al procesar un formulario HTML, el servicio de Forms puede hacer referencia a un archivo CSS personalizado. Puede crear un archivo CSS personalizado para satisfacer los requisitos empresariales y hacer referencia a ese archivo CSS cuando utilice el servicio Forms para procesar formularios HTML.
El servicio Forms analiza silenciosamente el archivo CSS personalizado. Es decir, el servicio de Forms no informa de errores que se puedan encontrar si el archivo CSS personalizado no cumple con los estándares CSS. En este caso, el servicio de Forms ignora el estilo y continúa con los estilos restantes ubicados en el archivo CSS.
La siguiente lista especifica los estilos compatibles con un archivo CSS personalizado:
Pares de estilo selector de nivel de clase: Si está presente en un archivo CSS personalizado, se utilizan selectores utilizados en el formulario HTML como estilos de clase. Los estilos de clase no utilizados se ignoran.
Pares de estilo de selector de nivel de identificador: Todos los estilos de identificador se utilizan si se utilizan en el formulario HTML.
Pares de estilo de selector de nivel de elemento: Todos los estilos de elemento se utilizan si se utilizan en el formulario HTML.
Prioridad de estilo: La prioridad de estilo (como importante) es compatible y se puede utilizar en un archivo CSS personalizado.
Tipo de medio: Se pueden ajustar uno o más pares de estilo selector en el estilo @media para definir el tipo de medio. El servicio Forms no comprueba si se admite el tipo de medio especificado. El tipo de medio especificado en el archivo CSS personalizado se combina en el formulario HTML.
Puede recuperar un archivo CSS de ejemplo utilizando la aplicación FormsIVS. Cargue el formulario, selecciónelo en la página Probar diseño de formulario y haga clic en Generar CSS. No es necesario que configure el tipo de transformación HTML antes de hacer clic en el botón. A continuación, seleccione Guardar. Puede editar este archivo CSS para satisfacer los requisitos empresariales.
NOTA
Antes de procesar un formulario HTML que utilice un archivo CSS personalizado, es importante que tenga una comprensión sólida de la renderización de formularios HTML. (Consulte Representación de Forms como HTML).
Para procesar un formulario HTML que utilice un archivo CSS, realice las siguientes tareas:
Incluir archivos de proyecto.
Cree un objeto de API Java de Forms.
Haga referencia al archivo CSS.
Representar un formulario HTML.
Escriba el flujo de datos del formulario en el explorador web del cliente.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Creación de un objeto de API Java de Forms
Para poder realizar mediante programación una operación admitida por el servicio Forms, debe crear un objeto cliente de Forms.
Hacer referencia al archivo CSS
Para procesar un formulario HTML que utilice un archivo CSS personalizado, asegúrese de hacer referencia a un archivo CSS existente.
Representar un formulario HTML
Para procesar un formulario HTML, debe especificar un diseño de formulario creado en Designer y guardado como archivo XDP. También debe seleccionar un tipo de transformación HTML. Por ejemplo, puede especificar el tipo de transformación HTML que procesa un HTML dinámico para Internet Explorer 5.0 o posterior.
La renderización de un formulario HTML también requiere valores, como valores de URI necesarios para representar otros tipos de formulario.
Escribir el flujo de datos del formulario en el explorador web del cliente
Cuando el servicio Forms procesa un formulario HTML, devuelve un flujo de datos de formulario que debe escribir en el explorador web del cliente para que el formulario HTML sea visible para el usuario.
Representar un formulario HTML que utilice un archivo CSS mediante la API de Java
Representar un formulario HTML que utilice un archivo CSS personalizado mediante la API de Forms (Java):
Incluir archivos de proyecto
Incluya archivos JAR del cliente, como adobe-forms-client.jar, en la ruta de clase de su proyecto Java.
Creación de un objeto de API Java de Forms
Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
Cree un objeto FormsServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.
Hacer referencia al archivo CSS
Cree un objeto HTMLRenderSpec utilizando su constructor.
Para procesar el formulario HTML que utiliza un archivo CSS personalizado, invoque el método HTMLRenderSpec del objeto setCustomCSSURI y pase un valor de cadena que especifique la ubicación y el nombre del archivo CSS.
Representar un formulario HTML
Invoque el método FormsServiceClient del objeto (Deprecated) (Deprecated) renderHTMLForm y pase los siguientes valores:
Un valor de cadena que especifica el nombre del diseño de formulario, incluida la extensión del nombre de archivo. Si hace referencia a un diseño de formulario que forma parte de una aplicación de Forms, asegúrese de especificar la ruta completa, como Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
Un valor de enumeración TransformTo que especifica el tipo de preferencia HTML. Por ejemplo, para procesar un formulario HTML compatible con HTML dinámico para Internet Explorer 5.0 o posterior, especifique TransformTo.MSDHTML.
Un objeto com.adobe.idp.Document que contiene datos para combinar con el formulario. Si no desea combinar datos, pase un objeto com.adobe.idp.Document vacío.
El objeto HTMLRenderSpec que almacena las opciones de tiempo de ejecución HTML.
Un valor de cadena que especifica el valor del encabezado HTTP_USER_AGENT, como Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
Un objeto URLSpec que almacena los valores de URI necesarios para procesar un formulario HTML.
Un objeto java.util.HashMap que almacena archivos adjuntos. Se trata de un parámetro opcional y puede especificar null si no desea adjuntar archivos al formulario.
El método (Deprecated) renderHTMLForm devuelve un objeto FormsResult que contiene un flujo de datos de formulario que debe escribirse en el explorador web del cliente.
Escribir el flujo de datos del formulario en el explorador web del cliente
Cree un objeto com.adobe.idp.Document invocando el método FormsResult del objeto ‘s getOutputContent.
Obtenga el tipo de contenido del objeto com.adobe.idp.Document invocando su método getContentType.
Establezca el tipo de contenido del objeto javax.servlet.http.HttpServletResponse invocando su método setContentType y pasando el tipo de contenido del objeto com.adobe.idp.Document.
Cree un objeto javax.servlet.ServletOutputStream que se utilice para escribir el flujo de datos del formulario en el explorador web del cliente invocando el método javax.servlet.h\ttp.HttpServletResponse del objeto getOutputStream.
Cree un objeto java.io.InputStream invocando el método com.adobe.idp.Document del objeto getInputStream.
Cree una matriz de bytes y rellénela con la secuencia de datos del formulario invocando el método InputStream del objeto read y pasando la matriz de bytes como argumento.
Invoque el método javax.servlet.ServletOutputStream del objeto write para enviar la secuencia de datos del formulario al explorador web del cliente. Pase la matriz de bytes al método write.
Representar un formulario HTML que utilice un archivo CSS mediante la API de servicio web
Representar un formulario HTML que utilice un archivo CSS personalizado mediante la API de Forms (servicio web):
Incluir archivos de proyecto
Cree clases de proxy Java que consuman el WSDL del servicio Forms.
Incluya las clases proxy de Java en la ruta de clase.
Creación de un objeto de API Java de Forms
Cree un objeto FormsService y establezca valores de autenticación.
Hacer referencia al archivo CSS
Cree un objeto HTMLRenderSpec utilizando su constructor.
Para procesar el formulario HTML que utiliza un archivo CSS personalizado, invoque el método HTMLRenderSpec del objeto setCustomCSSURI y pase un valor de cadena que especifique la ubicación y el nombre del archivo CSS.
Representar un formulario HTML
Invoque el método FormsService del objeto (Deprecated) renderHTMLForm y pase los siguientes valores:
Un valor de cadena que especifica el nombre del diseño de formulario, incluida la extensión del nombre de archivo. Si hace referencia a un diseño de formulario que forma parte de una aplicación de Forms, asegúrese de especificar la ruta completa, como Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
Un valor de enumeración TransformTo que especifica el tipo de preferencia HTML. Por ejemplo, para procesar un formulario HTML compatible con HTML dinámico para Internet Explorer 5.0 o posterior, especifique TransformTo.MSDHTML.
El objeto HTMLRenderSpec que almacena las opciones de tiempo de ejecución HTML.
Un valor de cadena que especifica el valor del encabezado HTTP_USER_AGENT, como Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). Puede pasar una cadena vacía si no desea establecer este valor.
Un objeto URLSpec que almacena los valores de URI necesarios para procesar un formulario HTML.
Un objeto java.util.HashMap que almacena archivos adjuntos. Se trata de un parámetro opcional y puede especificar null si no desea adjuntar archivos al formulario.
Un objeto com.adobe.idp.services.holders.BLOBHolder vacío que se rellena con el método (Deprecated) renderHTMLForm. Este valor de parámetro almacena el formulario procesado.
Un objeto com.adobe.idp.services.holders.BLOBHolder vacío que se rellena con el método (Deprecated) renderHTMLForm. Este parámetro almacena los datos XML de salida.
Un objeto javax.xml.rpc.holders.LongHolder vacío que se rellena con el método (Deprecated) renderHTMLForm. Este argumento almacena el número de páginas del formulario.
Un objeto javax.xml.rpc.holders.StringHolder vacío que se rellena con el método (Deprecated) renderHTMLForm. Este argumento almacena el valor de configuración regional.
Un objeto javax.xml.rpc.holders.StringHolder vacío que se rellena con el método (Deprecated) renderHTMLForm. Este argumento almacena el valor de renderización HTML que se utiliza.
Un objeto com.adobe.idp.services.holders.FormsResultHolder vacío que contendrá los resultados de esta operación.
El método (Deprecated) renderHTMLForm rellena el objeto com.adobe.idp.services.holders.FormsResultHolder que se pasa como el último valor de argumento con un flujo de datos de formulario que debe escribirse en el explorador web del cliente.
Escribir el flujo de datos del formulario en el explorador web del cliente
Cree un objeto FormResult obteniendo el valor del miembro de datos com.adobe.idp.services.holders.FormsResultHolder del objeto value.
Cree un objeto BLOB que contenga datos de formulario invocando el método FormsResult del objeto getOutputContent.
Obtenga el tipo de contenido del objeto BLOB invocando su método getContentType.
Establezca el tipo de contenido del objeto javax.servlet.http.HttpServletResponse invocando su método setContentType y pasando el tipo de contenido del objeto BLOB.
Cree un objeto javax.servlet.ServletOutputStream que se utilice para escribir el flujo de datos del formulario en el explorador web del cliente invocando el método javax.servlet.http.HttpServletResponse del objeto getOutputStream.
Cree una matriz de bytes y rellénela invocando el método BLOB del objeto getBinaryData. Esta tarea asigna el contenido del objeto FormsResult a la matriz de bytes.
Invoque el método javax.servlet.http.HttpServletResponse del objeto write para enviar la secuencia de datos del formulario al explorador web del cliente. Pase la matriz de bytes al método write.
