Las aplicaciones basadas en la Web que permiten al 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 cumplir con los requisitos comerciales. 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 de formulario se envían al servicio de Forms como datos XML o PDF, una opción que se establece en Designer. Un formulario que se envía 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 que se envía como datos PDF es datos binarios, no datos XML. Puede guardar el formulario como 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 envían a un servlet Java denominado HandleData
desde un formulario interactivo que se muestra en un explorador Web.
En la tabla siguiente se explican los pasos del diagrama.
Etapa |
Descripción |
---|---|
1 |
Un usuario rellena un formulario interactivo y hace clic en el botón Enviar del formulario. |
2 |
Los datos se envían al servlet de Java |
3 |
El servlet |
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 donde 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 los 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 de servicio de Forms.
Los campos del formulario de préstamo. Estos valores se pueden recuperar
uso de clases XML de Java.
El diseño de formulario debe configurarse correctamente en Designer para que los datos se envíen como datos XML. Para configurar correctamente el diseño de formulario para enviar datos XML, asegúrese de que el botón Enviar que se encuentra en el diseño de formulario está configurado para enviar datos XML. Para obtener información sobre cómo configurar el botón Enviar para enviar datos XML, consulte AEM Forms Designer.
Considere una aplicación web que invoque el servicio Forms. Una vez que el servicio Forms procesa un formulario PDF interactivo en un navegador web del cliente, el usuario rellena el formulario y lo devuelve como datos PDF. Cuando el servicio Forms recibe los datos en 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.
Etapa |
Descripción |
---|---|
3 |
Una página web contiene un vínculo que accede a un servlet Java que invoca el servicio Forms. |
2 |
El servicio Forms procesa un formulario PDF interactivo en el navegador web del cliente. |
3 |
El usuario rellena un formulario interactivo y hace clic en un botón de envío. El formulario se devuelve al servicio Forms como datos PDF. Esta opción se establece en Designer. |
4 |
El servicio Forms guarda los datos del PDF como un archivo PDF. |
Si los datos del formulario se envían como datos UTF-16 de URL, 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.
Para obtener más información sobre el servicio Forms, consulte Referencia de servicios para AEM Forms.
Para controlar los formularios enviados, realice las siguientes tareas:
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear 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 Forms Client
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, se invoca 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 navegador web del cliente al servicio Forms, se pueden enviar como datos en formato XML o PDF. Para recuperar los datos introducidos en los campos de formulario, estos se pueden enviar como datos XML.
También puede recuperar campos de formulario de un formulario enviado como datos PDF estableciendo las siguientes opciones en tiempo de ejecución:
processFormSubmission
como parámetro de tipo de contenido: CONTENT_TYPE=application/pdf
.RenderOptionsSpec
del objeto PDFToXDP
en true
RenderOptionsSpec
del objeto ExportDataFormat
en XMLData
Especifique el tipo de contenido del formulario enviado cuando invoque el método processFormSubmission
. La siguiente lista especifica los valores de tipo de contenido aplicables:
Observará que hay tres inicios rápidos correspondientes asociados con la sección Gestión de Forms enviado. El inicio rápido de Administración de PDF forms enviados como PDF mediante la API de Java muestra cómo gestionar los datos de PDF enviados. El tipo de contenido especificado en este inicio rápido es application/pdf
. El inicio rápido de Gestión de PDF forms enviados como XML mediante la API de Java muestra cómo gestionar los datos XML enviados desde un formulario PDF. El tipo de contenido especificado en este inicio rápido es text/xml
. Del mismo modo, el inicio rápido de Gestión de formularios HTML enviados como XML mediante la API de Java muestra cómo gestionar los datos XML enviados desde un formulario HTML. El tipo de contenido especificado en este inicio rápido es application/x-www-form-urlencoded.
Los datos de formulario que se publicaron en el servicio de Forms se recuperan y determinan 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 los datos estén listos para procesarse. Por ejemplo, los datos se pueden enviar al servicio Forms para que se pueda realizar un cálculo. Cuando se completa el cálculo, el formulario se devuelve al usuario con los resultados de cálculo mostrados. Antes de procesar los datos enviados, se recomienda determinar si el servicio de Forms ha terminado de procesar los datos.
El servicio Forms devuelve los siguientes valores para indicar si ha terminado de procesar los datos:
Los cálculos y las validaciones se deben devolver al usuario. (Consulte Cálculo de datos de formulario.)
Determinar si el envío del formulario contiene archivos adjuntos
Forms enviado al servicio Forms puede contener archivos adjuntos. Por ejemplo, con el panel de datos adjuntos integrado de Acrobat, un usuario puede seleccionar archivos adjuntos para enviarlos junto con el formulario. Asimismo, 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.
El formulario debe enviarse como datos PDF para recuperar archivos adjuntos. Si el formulario se envía como datos XML, no se envían los archivos adjuntos.
Procesar 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 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 mediante 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
Inicios rápidos de la API de servicio de Forms
Pasar Documentos al servicio Forms
Creación de Aplicaciones web que procesan Forms
Administre un formulario enviado mediante la API de Forms (Java):
Incluir archivos de proyecto
Incluya archivos JAR de cliente, como adobe-forms-client.jar, en la ruta de clases del proyecto Java.
Creación de un objeto de API de Forms Client
ServiceClientFactory
que contenga propiedades de conexión.FormsServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
.Recuperar datos de formulario
com.adobe.idp.Document
utilizando su constructor e invocando el método javax.servlet.http.HttpServletResponse
del objeto getInputStream
desde dentro del constructor.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.Puede indicar al servicio de Forms que cree datos XDP o XML a partir de 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
es devuelto por el método processFormSubmission
, que se explica en el siguiente subpaso.)
Invoque el método FormsServiceClient
del objeto processFormSubmission
y pase los siguientes valores:
com.adobe.idp.Document
que contiene los datos del formulario.CONTENT_TYPE=text/xml
. Para gestionar datos PDF, especifique el siguiente valor de cadena para este parámetro: CONTENT_TYPE=application/pdf
.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.RenderOptionsSpec
que almacena opciones de 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 de 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 ser procesados.
Determinar si el envío del formulario contiene archivos adjuntos
FormsResult
del objeto getAttachments
. Este método devuelve un objeto java.util.List
que contiene archivos enviados con el formulario.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
.Este paso solo es aplicable si el formulario se envía como PDF.
Procesar 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 valores de datos XML.
com.adobe.idp.Document
invocando el método FormsResult
del objeto getOutputContent
.java.io.InputStream
invocando el constructor java.io.DataInputStream
y pasando el objeto com.adobe.idp.Document
.org.w3c.dom.DocumentBuilderFactory
llamando al método org.w3c.dom.DocumentBuilderFactory
del objeto estático newInstance
.org.w3c.dom.DocumentBuilder
invocando el método org.w3c.dom.DocumentBuilderFactory
del objeto newDocumentBuilder
.org.w3c.dom.Document
invocando el método org.w3c.dom.DocumentBuilder
del objeto parse
y pasando el objeto java.io.InputStream
.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 a este proceso, este método personalizado se denomina 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 del PDF enviado como un archivo PDF.
com.adobe.idp.Document
invocando el método FormsResult
del objeto getOutputContent
.java.io.File
utilizando su constructor público. Asegúrese de especificar PDF como extensión de nombre de archivo.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
Gestionar un formulario enviado mediante la API de Forms (servicio web):
Incluir archivos de proyecto
Creación de un objeto de API de Forms Client
Cree un objeto FormsService
y defina los valores de autenticación.
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 un 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:
BLOB
que contiene los datos del formulario.CONTENT_TYPE=text/xml
. Para gestionar datos PDF, especifique el siguiente valor de cadena para este parámetro: CONTENT_TYPE=application/pdf
.HTTP_USER_AGENT
; por ejemplo, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
.RenderOptionsSpec
que almacena opciones de tiempo de ejecución.BLOBHolder
que se rellena con el método.javax.xml.rpc.holders.StringHolder
que se rellena con el método.BLOBHolder
que se rellena con el método.BLOBHolder
que se rellena con el método.javax.xml.rpc.holders.ShortHolder
que se rellena con el método.MyArrayOf_xsd_anyTypeHolder
que se rellena con el método. Este parámetro se utiliza para almacenar archivos adjuntos enviados junto con el formulario.FormsResultHolder
que se rellena con el método con el formulario que se envía.El método processFormSubmission
rellena el parámetro FormsResultHolder
con los resultados del envío del formulario.
Determine si el servicio de 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
.
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 dentro de la matriz Object
es un Object
que corresponde a los archivos enviados junto con el formulario. Puede obtener cada elemento dentro de la matriz y convertirlo en un objeto BLOB
.
Procesar 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 valores de datos XML.
BLOB
invocando el método FormsResult
del objeto getOutputContent
.BLOB
del objeto getBinaryData
.java.io.InputStream
invocando el constructor java.io.ByteArrayInputStream
y pasando la matriz de bytes.org.w3c.dom.DocumentBuilderFactory
llamando al método org.w3c.dom.DocumentBuilderFactory
del objeto estático newInstance
.org.w3c.dom.DocumentBuilder
invocando el método org.w3c.dom.DocumentBuilderFactory
del objeto newDocumentBuilder
.org.w3c.dom.Document
invocando el método org.w3c.dom.DocumentBuilder
del objeto parse
y pasando el objeto java.io.InputStream
.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 a este proceso, este método personalizado se denomina 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 del PDF enviado como un archivo PDF.
BLOB
invocando el método FormsResult
del objeto getOutputContent
.BLOB
del objeto getBinaryData
.java.io.File
utilizando su constructor público. Asegúrese de especificar PDF como extensión de nombre de archivo.java.io.FileOutputStream
utilizando su constructor y pasando el objeto java.io.File
.java.io.FileOutputStream
del objeto write
y pasando la matriz de bytes.Consulte también
Invocación de AEM Forms mediante codificación Base64