Gestión de Forms enviado

Las aplicaciones basadas en la Web que permiten a un usuario rellenar formularios interactivos requieren que los datos se envíen de nuevo al servidor. Con el servicio Forms, puede recuperar los datos introducidos por el usuario en un formulario interactivo. Después de recuperar los datos, puede procesarlos para satisfacer los requisitos empresariales. Por ejemplo, puede almacenar los datos en una base de datos, enviarlos a otra aplicación, enviarlos a otro servicio, combinar los datos en un diseño de formulario, mostrar los datos en un explorador Web, etc.

Los datos del formulario se envían al servicio Forms como datos XML o PDF, que es una opción que se establece en Designer. Un formulario enviado como XML permite extraer valores de datos de campo individuales. Es decir, puede extraer el valor de cada campo de formulario que el usuario haya introducido en el formulario. Un formulario enviado como datos PDF es datos binarios, no datos XML. Puede guardar el formulario como un archivo PDF o enviarlo a otro servicio. Si desea extraer datos de un formulario enviado como XML y, a continuación, utilizar los datos del formulario para crear un documento PDF, invoque otra operación de AEM Forms. (Consulte Creación de documentos PDF con datos XML enviados)

El diagrama siguiente muestra los datos que se están enviando a un servlet Java llamado HandleData desde un formulario interactivo mostrado en un explorador web.

En la tabla siguiente se explican los pasos del diagrama.

Gestión de datos XML enviados

Cuando los datos del formulario se envían como XML, se pueden recuperar datos XML que representen los datos enviados. Todos los campos de formulario aparecen como nodos en un esquema XML. Los valores de nodo corresponden a los valores que el usuario ha rellenado. Considere un formulario de préstamo en el que cada campo del formulario aparece como un nodo dentro de los datos XML. El valor de cada nodo corresponde al valor que rellena el usuario. Supongamos que un usuario rellena el formulario de préstamo con datos que se muestran en el siguiente formulario.

La siguiente ilustración muestra los datos XML correspondientes que se recuperan mediante la API de cliente del servicio Forms.

Los campos del formulario de préstamo. Estos valores se pueden recuperar
uso de clases XML de Java.

Gestión de datos PDF enviados

Considere una aplicación web que invoque el servicio Forms. Una vez que el servicio Forms procesa un formulario PDF interactivo en un explorador web cliente, el usuario rellena el formulario y lo envía de nuevo como datos PDF. Cuando el servicio Forms recibe los datos PDF, puede enviarlos a otro servicio o guardarlos como un archivo PDF. El diagrama siguiente muestra el flujo lógico de la aplicación.

En la tabla siguiente se describen los pasos de este diagrama.

Gestión de datos de URL UTF-16 enviados

Si los datos del formulario se envían como datos de URL UTF-16, el equipo cliente requiere Adobe Reader o Acrobat 8.1 o posterior. Además, si el diseño de formulario contiene un botón de envío con datos codificados con URL (HTTP Post) y la opción de codificación de datos es UTF-16, el diseño de formulario debe modificarse en un editor de texto como el Bloc de notas. Puede establecer la opción de codificación en UTF-16LE o UTF-16BE para el botón de envío. Designer no proporciona esta funcionalidad.

Resumen de los pasos

Para gestionar los formularios enviados, realice las siguientes tareas:

1. Incluir archivos de proyecto.
2. Cree un objeto de API de cliente de Forms.
3. Recupere datos de formulario.
4. Determine si el envío del formulario contiene archivos adjuntos.
5. Procese los datos enviados.

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.

Recuperar datos de formulario

Para recuperar los datos de formulario enviados, invoque el método FormsServiceClient del objeto processFormSubmission. Al invocar este método, debe especificar el tipo de contenido del formulario enviado. Cuando los datos se envían desde un explorador web del cliente al servicio Forms, se pueden enviar como datos XML o PDF. Para recuperar los datos introducidos en los campos del formulario, estos se pueden enviar como datos XML.

También puede recuperar campos de formulario de un formulario enviado como datos PDF definiendo las siguientes opciones en tiempo de ejecución:

• Pase el siguiente valor al método processFormSubmission como parámetro de tipo de contenido: CONTENT_TYPE=application/pdf.
• Establezca el valor RenderOptionsSpec del objeto PDFToXDP en true
• Establezca el valor RenderOptionsSpec del objeto ExportDataFormat en XMLData

Especifique el tipo de contenido del formulario enviado cuando invoque el método processFormSubmission. La siguiente lista especifica valores de tipo de contenido aplicables:

• text/xml: Representa el tipo de contenido que se utiliza cuando un formulario PDF envía datos de formulario como XML.
• application/x-www-form-urlencoded: Representa el tipo de contenido que se utiliza cuando un formulario HTML envía datos como XML.
• application/pdf: Representa el tipo de contenido que se utiliza cuando un formulario PDF envía datos como PDF.

Los datos de formulario que se publicaron en el servicio de Forms se recuperan y se determina su estado de procesamiento. Es decir, cuando los datos se envían al servicio de Forms, no significa necesariamente que el servicio de Forms haya terminado de procesar los datos y que estos estén listos para procesarse. Por ejemplo, se pueden enviar datos al servicio Forms para que se pueda realizar un cálculo. Cuando se completa el cálculo, el formulario se vuelve a procesar para el usuario con los resultados de cálculo mostrados. Antes de procesar los datos enviados, se recomienda determinar si el servicio de Forms ha finalizado el procesamiento de los datos.

El servicio Forms devuelve los siguientes valores para indicar si ha finalizado el procesamiento de los datos:

• 0 (Enviar): los datos enviados están listos para procesarse.
• 1 (Calcular): El servicio de Forms ha realizado una operación de cálculo en los datos y los resultados deben devolverse al usuario.
• 2 (Validar): El servicio Forms validó los datos del formulario y los resultados deben devolverse al usuario.
• 3 (Siguiente): La página actual ha cambiado con resultados que deben escribirse en la aplicación cliente.
• 4 (Anterior): La página actual ha cambiado con resultados que deben escribirse en la aplicación cliente.

Determinar si el envío del formulario contiene archivos adjuntos

Forms enviado al servicio de Forms puede contener archivos adjuntos. Por ejemplo, con el panel de archivos adjuntos integrado de Acrobat, un usuario puede seleccionar los archivos adjuntos que desea enviar junto con el formulario. Además, un usuario también puede seleccionar archivos adjuntos mediante una barra de herramientas HTML que se procesa con un archivo HTML.

Después de determinar si un formulario contiene archivos adjuntos, puede procesar los datos. Por ejemplo, puede guardar el archivo adjunto en el sistema de archivos local.

Procesamiento de los datos enviados

Según el tipo de contenido de los datos enviados, puede extraer valores de campo de formulario individuales de los datos XML enviados o guardar los datos PDF enviados como un archivo PDF (o enviarlos a otro servicio). Para extraer campos de formulario individuales, convierta los datos XML enviados a un origen de datos XML y, a continuación, recupere los valores del origen de datos XML utilizando las clases org.w3c.dom.

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

Pasar documentos al servicio de Forms

Creación de aplicaciones web que procesen Forms

Administrar formularios enviados mediante la API de Java

Gestione un formulario enviado 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. Recuperar datos de formulario

   • Para recuperar datos de formulario publicados en un servlet Java, cree un objeto com.adobe.idp.Document utilizando su constructor e invocando el método javax.servlet.http.HttpServletResponse del objeto getInputStream desde dentro del constructor.
   • Cree un objeto RenderOptionsSpec utilizando su constructor. Establezca el valor de configuración regional invocando el método RenderOptionsSpec del objeto setLocale y pasando un valor de cadena que especifica el valor de configuración regional.
   NOTA

   Puede indicar al servicio de Forms que cree datos XDP o XML a partir del contenido PDF enviado invocando el método RenderOptionsSpec del objeto setPDF2XDP y pasando true, y también llamando a setXMLData y pasando true. A continuación, puede invocar el método FormsResult del objeto getOutputXML para recuperar los datos XML que corresponden a los datos XDP/XML. (El objeto FormsResult se devuelve mediante el método processFormSubmission, que se explica en el siguiente subpaso.)

   • Invoque el método FormsServiceClient del objeto processFormSubmission y pase los siguientes valores:

     • El objeto com.adobe.idp.Document que contiene los datos del formulario.
     • Un valor de cadena que especifica variables de entorno, incluidos todos los encabezados HTTP relevantes. Especifique el tipo de contenido que se va a gestionar. Para gestionar datos XML, especifique el siguiente valor de cadena para este parámetro: CONTENT_TYPE=text/xml. Para gestionar datos PDF, especifique el siguiente valor de cadena para este parámetro: CONTENT_TYPE=application/pdf.
     • Un valor de cadena que especifica el valor del encabezado HTTP_USER_AGENT, por ejemplo, . Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). Este valor de parámetro es opcional.
     • Un objeto RenderOptionsSpec que almacena opciones en tiempo de ejecución.

     El método processFormSubmission devuelve un objeto FormsResult que contiene los resultados del envío del formulario.

   • Determine si el servicio Forms ha terminado de procesar los datos del formulario invocando el método FormsResult del objeto getAction. Si este método devuelve el valor 0, los datos están listos para procesarse.

4. Determinar si el envío del formulario contiene archivos adjuntos

   • Invoque el método FormsResult del objeto getAttachments. Este método devuelve un objeto java.util.List que contiene archivos enviados con el formulario.
   • Itere el objeto java.util.List para determinar si hay archivos adjuntos. Si hay archivos adjuntos, cada elemento es una instancia com.adobe.idp.Document. Puede guardar los archivos adjuntos invocando el método com.adobe.idp.Document del objeto copyToFile y pasando un objeto java.io.File.
   NOTA

   Este paso solo es aplicable si el formulario se envía como PDF.

5. Procesamiento de los datos enviados

   • Si el tipo de contenido de datos es application/vnd.adobe.xdp+xml o text/xml, cree una lógica de aplicación para recuperar los valores de datos XML.

     • Cree un objeto com.adobe.idp.Document invocando el método FormsResult del objeto getOutputContent.
     • Cree un objeto java.io.InputStream invocando el constructor java.io.DataInputStream y pasando el objeto com.adobe.idp.Document.
     • Cree un objeto org.w3c.dom.DocumentBuilderFactory llamando al método estático org.w3c.dom.DocumentBuilderFactory del objeto newInstance.
     • Cree un objeto org.w3c.dom.DocumentBuilder invocando el método org.w3c.dom.DocumentBuilderFactory del objeto newDocumentBuilder.
     • Cree un objeto org.w3c.dom.Document invocando el método org.w3c.dom.DocumentBuilder del objeto parse y pasando el objeto java.io.InputStream.
     • Recupere el valor de cada nodo dentro del documento XML. Una forma de realizar esta tarea es crear un método personalizado que acepte dos parámetros: el objeto org.w3c.dom.Document y el nombre del nodo cuyo valor desea recuperar. Este método devuelve un valor de cadena que representa el valor del nodo . En el ejemplo de código que sigue este proceso, este método personalizado se llama getNodeText. Se muestra el cuerpo de este método.

   • Si el tipo de contenido de datos es application/pdf, cree una lógica de aplicación para guardar los datos PDF enviados como un archivo PDF.

     • Cree un objeto com.adobe.idp.Document invocando el método FormsResult del objeto getOutputContent.
     • Cree un objeto java.io.File utilizando su constructor público. Asegúrese de especificar PDF como extensión de nombre de archivo.
     • Rellene el archivo PDF invocando el método com.adobe.idp.Document del objeto copyToFile y pasando el objeto java.io.File.

Consulte también

Inicio rápido (modo SOAP): Gestión de PDF forms enviados como XML mediante la API de Java

Inicio rápido (modo SOAP): Gestión de formularios HTML enviados como XML mediante la API de Java

Inicio rápido (modo SOAP): Gestión de PDF forms enviados como PDF mediante la API de Java

Inclusión de archivos de biblioteca Java de AEM Forms

Configuración de las propiedades de conexión

Gestión de datos PDF enviados mediante la API de servicio web

Gestione un formulario enviado 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. Recuperar datos de formulario

   • Para recuperar datos de formulario publicados en un servlet Java, cree un objeto BLOB utilizando su constructor.

   • Cree un objeto java.io.InputStream invocando el método javax.servlet.http.HttpServletResponse del objeto getInputStream.

   • Cree un objeto java.io.ByteArrayOutputStream utilizando su constructor y pasando la longitud del objeto java.io.InputStream.

   • Copie el contenido del objeto java.io.InputStream en el objeto java.io.ByteArrayOutputStream .

   • Cree una matriz de bytes invocando el método java.io.ByteArrayOutputStream del objeto toByteArray.

   • Rellene el objeto BLOB invocando su método setBinaryData y pasando la matriz de bytes como argumento.

   • Cree un objeto RenderOptionsSpec utilizando su constructor. Establezca el valor de configuración regional invocando el método RenderOptionsSpec del objeto setLocale y pasando un valor de cadena que especifica el valor de configuración regional.

   • Invoque el método FormsService del objeto processFormSubmission y pase los siguientes valores:

     • El objeto BLOB que contiene los datos del formulario.
     • Un valor de cadena que especifica variables de entorno, incluidos todos los encabezados HTTP relevantes. Especifique el tipo de contenido que se va a gestionar. Para gestionar datos XML, especifique el siguiente valor de cadena para este parámetro: CONTENT_TYPE=text/xml. Para gestionar datos PDF, especifique el siguiente valor de cadena para este parámetro: CONTENT_TYPE=application/pdf.
     • Un valor de cadena que especifica el valor del encabezado HTTP_USER_AGENT; por ejemplo, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
     • Un objeto RenderOptionsSpec que almacena opciones en tiempo de ejecución.
     • Un objeto BLOBHolder vacío que se rellena con el método .
     • Un objeto javax.xml.rpc.holders.StringHolder vacío que se rellena con el método .
     • Un objeto BLOBHolder vacío que se rellena con el método .
     • Un objeto BLOBHolder vacío que se rellena con el método .
     • Un objeto javax.xml.rpc.holders.ShortHolder vacío que se rellena con el método .
     • Un objeto MyArrayOf_xsd_anyTypeHolder vacío que se rellena con el método . Este parámetro se utiliza para almacenar archivos adjuntos enviados junto con el formulario.
     • Un objeto FormsResultHolder vacío que el método rellena con el formulario enviado.

     El método processFormSubmission rellena el parámetro FormsResultHolder con los resultados del envío del formulario.

   • Determine si el servicio Forms ha terminado de procesar los datos del formulario invocando el método FormsResult del objeto getAction. Si este método devuelve el valor 0, los datos del formulario están listos para procesarse. Puede obtener un objeto FormsResult obteniendo el valor del miembro de datos FormsResultHolder del objeto value.

4. Determinar si el envío del formulario contiene archivos adjuntos

   Obtenga el valor del miembro de datos MyArrayOf_xsd_anyTypeHolder del objeto value (el objeto MyArrayOf_xsd_anyTypeHolder se pasó al método processFormSubmission). Este miembro de datos devuelve una matriz de Objects. Cada elemento de la matriz Object es un Objectque corresponde a los archivos enviados junto con el formulario. Puede obtener cada elemento dentro de la matriz y convertirlo en un objeto BLOB.

5. Procesamiento de los datos enviados

   • Si el tipo de contenido de datos es application/vnd.adobe.xdp+xml o text/xml, cree una lógica de aplicación para recuperar los valores de datos XML.

     • Cree un objeto BLOB invocando el método FormsResult del objeto getOutputContent.
     • Cree una matriz de bytes invocando el método BLOB del objeto getBinaryData.
     • Cree un objeto java.io.InputStream invocando el constructor java.io.ByteArrayInputStream y pasando la matriz de bytes.
     • Cree un objeto org.w3c.dom.DocumentBuilderFactory llamando al método estático org.w3c.dom.DocumentBuilderFactory del objeto newInstance.
     • Cree un objeto org.w3c.dom.DocumentBuilder invocando el método org.w3c.dom.DocumentBuilderFactory del objeto newDocumentBuilder.
     • Cree un objeto org.w3c.dom.Document invocando el método org.w3c.dom.DocumentBuilder del objeto parse y pasando el objeto java.io.InputStream.
     • Recupere el valor de cada nodo dentro del documento XML. Una forma de realizar esta tarea es crear un método personalizado que acepte dos parámetros: el objeto org.w3c.dom.Document y el nombre del nodo cuyo valor desea recuperar. Este método devuelve un valor de cadena que representa el valor del nodo . En el ejemplo de código que sigue este proceso, este método personalizado se llama getNodeText. Se muestra el cuerpo de este método.

   • Si el tipo de contenido de datos es application/pdf, cree una lógica de aplicación para guardar los datos PDF enviados como un archivo PDF.

     • Cree un objeto BLOB invocando el método FormsResult del objeto getOutputContent.
     • Cree una matriz de bytes invocando el método BLOB del objeto getBinaryData.
     • Cree un objeto java.io.File utilizando su constructor público. Asegúrese de especificar PDF como extensión de nombre de archivo.
     • Cree un objeto java.io.FileOutputStream utilizando su constructor y pasando el objeto java.io.File.
     • Rellene el archivo PDF invocando el método java.io.FileOutputStream del objeto write y pasando la matriz de bytes.

Consulte también

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