Optimización del rendimiento del servicio de Forms

Los ejemplos y ejemplos de este documento son solo para AEM Forms en un entorno JEE.

Optimización del rendimiento del servicio de Forms

Al procesar un formulario, puede definir opciones en tiempo de ejecución que optimicen el rendimiento del servicio Forms. Otra tarea que puede realizar para mejorar el rendimiento del servicio Forms es almacenar archivos XDP en el repositorio. Sin embargo, esta sección no describe cómo realizar esta tarea. (Consulte Invocación de un servicio mediante una biblioteca de cliente Java).

Resumen de los pasos

Para optimizar el rendimiento del servicio Forms mientras se procesa un formulario, realice las siguientes tareas:

1. Incluir archivos de proyecto.
2. Cree un objeto de API de cliente de Forms.
3. Establezca las opciones de rendimiento en tiempo de ejecución.
4. Procese el formulario.
5. 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 de cliente de Forms

Para poder realizar mediante programación una operación de API de cliente de servicio de Forms, debe crear un cliente de servicio de Forms. Si utiliza la API de Java, cree un objeto FormsServiceClient. Si utiliza la API de servicio web de Forms, cree un objeto FormsService.

Establecer opciones de tiempo de ejecución del rendimiento

Puede configurar las siguientes opciones de rendimiento en tiempo de ejecución para mejorar el rendimiento del servicio Forms:

• Procesamiento de formularios en la caché: Puede almacenar en caché un formulario que se procese como PDF en la caché del servidor. Cada formulario se almacena en caché una vez que se genera por primera vez. En un procesamiento posterior, si el formulario almacenado en caché es más reciente que la marca de tiempo del diseño de formulario, el formulario se recupera de la caché. Al almacenar en caché los formularios, se mejora el rendimiento del servicio Forms porque no tiene que recuperar el diseño de formulario de un repositorio.
• Las guías del formulario (obsoletas) pueden tardar más en procesarse que otros tipos de transformación. Se recomienda almacenar en caché las guías del formulario (obsoleto) para mejorar el rendimiento.
• Opción independiente: Si no necesita que el servicio Forms realice cálculos en el servidor, puede establecer la opción Independiente en true, lo que hace que los formularios se procesen sin información de estado. La información de estado es necesaria si desea procesar un formulario interactivo para un usuario final que, a continuación, introduzca información en el formulario y lo envíe de nuevo al servicio de Forms. A continuación, el servicio Forms realiza una operación de cálculo y vuelve a procesar el formulario para el usuario con los resultados mostrados en el formulario. Si se devuelve un formulario sin información de estado al servicio Forms, solo están disponibles los datos XML y no se realizan cálculos en el servidor.
• PDF linealizado: Un archivo PDF linealizado está organizado para permitir un acceso incremental eficiente en un entorno de red. El archivo PDF es válido en todos los aspectos y es compatible con todos los visores existentes y otras aplicaciones PDF. Es decir, se puede ver un PDF linealizado mientras se sigue descargando.
• Esta opción no mejora el rendimiento cuando se procesa un formulario PDF en el cliente.
• Opción GuideRSL: Habilita la generación de guías de formulario (obsoleto) mediante bibliotecas compartidas en tiempo de ejecución. Esto significa que la primera solicitud descargará un archivo SWF más pequeño, además de bibliotecas compartidas más grandes que se almacenan en la caché del explorador. Para obtener más información, consulte RSL en la documentación de Flex.
• También puede mejorar el rendimiento del servicio Forms procesando un formulario en el cliente. (Consulte Renderización de Forms en Client).

Procesamiento del formulario

Para procesar el formulario después de definir las opciones de rendimiento, se utiliza la misma lógica de aplicación que para procesar un formulario sin opciones de rendimiento.

Escribir el flujo de datos del formulario en el explorador web del cliente

Una vez que el servicio Forms procesa un formulario, devuelve un flujo de datos de formulario que debe escribir en el explorador web del cliente. Cuando se escribe en el explorador web del cliente, el formulario es visible para el usuario.

Consulte también

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Inicio rápido de la API del servicio de Forms

Renderización de PDF forms interactivos

Representación de Forms como HTML

Creación de aplicaciones web que procesen Forms

Optimizar el rendimiento mediante la API de Java

Representar un formulario con rendimiento optimizado mediante la API de Forms (Java):

1. Incluir archivos de proyecto

   Incluya archivos JAR del cliente, como adobe-forms-client.jar, en la ruta de clase de su proyecto Java.

2. Creación de un objeto de API de cliente de Forms

   • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
   • Cree un objeto FormsServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.

3. Establecer opciones de tiempo de ejecución del rendimiento

   • Cree un objeto PDFFormRenderSpec utilizando su constructor.
   • Establezca la opción de caché de formulario invocando el método PDFFormRenderSpec del objeto setCacheEnabled y pasando true.
   • Establezca la opción linealizada invocando el método PDFFormRenderSpec del objeto setLinearizedPDF y pasando true.

4. Procesamiento del formulario

   Invoque el método FormsServiceClient del objeto renderPDFForm 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.
   • 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.
   • Un objeto PDFFormRenderSpec que almacena opciones en tiempo de ejecución para mejorar el rendimiento.
   • Un objeto URLSpec que contiene valores de URI necesarios para el servicio Forms.
   • 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 renderPDFForm devuelve un objeto FormsResult que contiene un flujo de datos de formulario que debe escribirse en el explorador web del cliente.

5. Escribir el flujo de datos del formulario en el explorador web del cliente

   • Cree un objeto javax.servlet.ServletOutputStream que se utilice para enviar una secuencia de datos de formulario al explorador web del cliente.
   • Cree un objeto com.adobe.idp.Document invocando el método FormsResult del objeto ‘s getOutputContent.
   • 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 ready 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.

Consulte también

Inicio rápido (modo SOAP): Optimización del rendimiento mediante la API de Java

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Optimizar el rendimiento mediante la API de servicio web

Representar un formulario con un rendimiento optimizado mediante la API de Forms (servicio web):

1. 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.

2. Creación de un objeto de API de cliente de Forms

   Cree un objeto FormsService y establezca valores de autenticación.

3. Establecer opciones de tiempo de ejecución del rendimiento

   • Cree un objeto PDFFormRenderSpec utilizando su constructor.
   • Establezca la opción de caché del formulario invocando el método PDFFormRenderSpec del objeto setCacheEnabled y pasando true.
   • Establezca la opción independiente invocando el método PDFFormRenderSpec del objeto setStandAlone y pasando true.
   • Establezca la opción linealizada invocando el método PDFFormRenderSpec del objeto setLinearizedPDF y pasando true.

4. Procesamiento del formulario

   Invoque el método FormsService del objeto renderPDFForm 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.
   • Un objeto BLOB que contiene datos para combinar con el formulario. Si no desea combinar datos, pase null.
   • Un objeto PDFFormRenderSpecc que almacena opciones en tiempo de ejecución.
   • Un objeto URLSpec que contiene valores de URI necesarios para el servicio Forms.
   • 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 . Se utiliza para almacenar el formulario PDF procesado.
   • Un objeto javax.xml.rpc.holders.LongHolder vacío que se rellena con el método . (Este argumento almacenará el número de páginas del formulario).
   • Un objeto javax.xml.rpc.holders.StringHolder vacío que se rellena con el método . (Este argumento almacenará el valor de configuración regional).
   • Un objeto com.adobe.idp.services.holders.FormsResultHolder vacío que contendrá los resultados de esta operación.

   El método renderPDFForm 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.

5. 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 javax.servlet.ServletOutputStream que se utilice para enviar una secuencia de datos de formulario al explorador web del cliente.
   • Cree un objeto BLOB que contenga datos de formulario invocando el método FormsResult del objeto getOutputContent.
   • 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.

Consulte también

Invocación de AEM Forms mediante la codificación Base64