Rellenado previo de Forms con diseños flexibles prepopulating-forms-with-flowable-layouts1

Incluir archivos de proyecto

Incluya archivos JAR de cliente, como adobe-forms-client.jar, en la ruta de clase del proyecto Java. Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java de AEM Forms.

Crear una fuente de datos XML en memoria

• Cree un objeto Java DocumentBuilderFactory llamando al método newInstance de la clase DocumentBuilderFactory.

• Cree un objeto Java DocumentBuilder llamando al método newDocumentBuilder del objeto DocumentBuilderFactory.

• Llame al método newDocument del objeto DocumentBuilder para crear una instancia de un objeto org.w3c.dom.Document.

• Cree el elemento raíz del origen de datos XML invocando el método createElement del objeto org.w3c.dom.Document. Esto crea un objeto Element que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, anexe el elemento raíz al documento llamando al método appendChild del objeto Document y pase el objeto del elemento raíz como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element root = (Element)document.createElement("transaction");  document.appendChild(root);

• Cree el elemento de encabezado del origen de datos XML llamando al método createElement del objeto Document. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, agregue el elemento header al elemento raíz llamando al método appendChild del objeto root y pase el objeto header element como argumento. Los elementos XML que se anexan al elemento header corresponden a la parte estática del formulario. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element header = (Element)document.createElement("header");  root.appendChild(header);

• Cree un elemento secundario que pertenezca al elemento de encabezado llamando al método createElement del objeto Document y pase un valor de cadena que represente el nombre del elemento. Convertir el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su método appendChild y pase el método createTextNode del objeto Document como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Por último, agregue el elemento secundario al elemento de encabezado llamando al método appendChild del elemento de encabezado y pase el objeto de elemento secundario como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

• Agregue todos los elementos restantes al elemento de encabezado repitiendo el último subpaso para cada campo que aparezca en la parte estática del formulario (en el diagrama de fuente de datos XML, estos campos se muestran en la sección A. (Consulte Explicación de los subgrupos de datos).

• Cree el elemento de detalle del origen de datos XML llamando al método createElement del objeto Document. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, anexe el elemento detail al elemento raíz llamando al método appendChild del objeto root y pase el objeto detail element como argumento. Los elementos XML anexados al elemento de detalle corresponden a la parte dinámica del formulario. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

• Cree un elemento secundario que pertenezca al elemento de detalle llamando al método createElement del objeto Document y pase un valor de cadena que represente el nombre del elemento. Convertir el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su método appendChild y pase el método createTextNode del objeto Document como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Por último, agregue el elemento secundario al elemento de detalle llamando al método appendChild del elemento de detalle y pase el objeto de elemento secundario como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

• Repita el último subpaso para todos los elementos XML para anexar al elemento de detalle. Para crear correctamente el origen de datos XML utilizado para rellenar el formulario de pedido de compra, debe anexar los siguientes elementos XML al elemento de detalle: txtDescription, numQty y numUnitPrice.

• Repita los dos últimos pasos secundarios para todos los elementos de datos utilizados para rellenar previamente el formulario.

Conversión de la fuente de datos XML

• Cree un objeto javax.xml.transform.Transformer invocando el método newInstance estático del objeto javax.xml.transform.Transformer.
• Cree un objeto Transformer invocando el método newTransformer del objeto TransformerFactory.
• Crear un objeto ByteArrayOutputStream mediante su constructor.
• Cree un objeto javax.xml.transform.dom.DOMSource utilizando su constructor y pasando el objeto org.w3c.dom.Document creado en el paso 1.
• Cree un objeto javax.xml.transform.dom.DOMSource utilizando su constructor y pasando el objeto ByteArrayOutputStream.
• Rellene el objeto Java ByteArrayOutputStream invocando el método transform del objeto javax.xml.transform.Transformer y pasando los objetos javax.xml.transform.dom.DOMSource y javax.xml.transform.stream.StreamResult.
• Cree una matriz de bytes y asigne el tamaño del objeto ByteArrayOutputStream a la matriz de bytes.
• Rellene la matriz de bytes invocando el método toByteArray del objeto ByteArrayOutputStream.
• Cree un objeto com.adobe.idp.Document utilizando su constructor y pasando la matriz de bytes.

Procesar un formulario rellenado previamente

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

• Un valor de cadena que especifica el nombre del diseño del formulario, incluida la extensión del nombre de archivo.
• Objeto com.adobe.idp.Document que contiene datos para combinar con el formulario. Asegúrese de utilizar el objeto com.adobe.idp.Document creado en los pasos uno y dos.
• Objeto PDFFormRenderSpec que almacena opciones en tiempo de ejecución.
• Un objeto URLSpec que contiene valores de URI requeridos por el servicio Forms.
• Objeto java.util.HashMap que almacena datos adjuntos de archivos. Este es 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 una secuencia de datos de formulario que debe escribirse en el explorador web del cliente.

• Cree un objeto javax.servlet.ServletOutputStream que se use para enviar un flujo de datos de formulario al explorador web del cliente.
• Cree un objeto com.adobe.idp.Document invocando el método getOutputContent del objeto FormsResult.
• Cree un objeto java.io.InputStream invocando el método getInputStream del objeto com.adobe.idp.Document.
• Cree una matriz de bytes y rellénela con la secuencia de datos de formulario invocando el método read del objeto InputStream y pasando la matriz de bytes como argumento.
• Invoque el método write del objeto javax.servlet.ServletOutputStream para enviar la secuencia de datos de formulario al explorador web del cliente. Pase la matriz de bytes al método write.

Incluir archivos de proyecto

• Cree clases de proxy Java que consuman el WSDL del servicio Forms. (Consulte Creación de clases de proxy Java mediante Apache Axis).
• Incluya las clases de proxy Java en la ruta de clase.

Crear una fuente de datos XML en memoria

• Cree un objeto Java DocumentBuilderFactory llamando al método newInstance de la clase DocumentBuilderFactory.

• Cree un objeto Java DocumentBuilder llamando al método newDocumentBuilder del objeto DocumentBuilderFactory.

• Llame al método newDocument del objeto DocumentBuilder para crear una instancia de un objeto org.w3c.dom.Document.

• Cree el elemento raíz del origen de datos XML invocando el método createElement del objeto org.w3c.dom.Document. Esto crea un objeto Element que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, anexe el elemento raíz al documento llamando al método appendChild del objeto Document y pase el objeto del elemento raíz como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element root = (Element)document.createElement("transaction");  document.appendChild(root);

• Cree el elemento de encabezado del origen de datos XML llamando al método createElement del objeto Document. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, agregue el elemento header al elemento raíz llamando al método appendChild del objeto root y pase el objeto header element como argumento. Los elementos XML que se anexan al elemento header corresponden a la parte estática del formulario. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element header = (Element)document.createElement("header");  root.appendChild(header);

• Cree un elemento secundario que pertenezca al elemento de encabezado llamando al método createElement del objeto Document y pase un valor de cadena que represente el nombre del elemento. Convertir el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su método appendChild y pase el método createTextNode del objeto Document como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Por último, agregue el elemento secundario al elemento de encabezado llamando al método appendChild del elemento de encabezado y pase el objeto de elemento secundario como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

• Agregue todos los elementos restantes al elemento de encabezado repitiendo el último subpaso para cada campo que aparezca en la parte estática del formulario (en el diagrama de fuente de datos XML, estos campos se muestran en la sección A. (Consulte Explicación de los subgrupos de datos).

• Cree el elemento de detalle del origen de datos XML llamando al método createElement del objeto Document. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, anexe el elemento detail al elemento raíz llamando al método appendChild del objeto root y pase el objeto detail element como argumento. Los elementos XML anexados al elemento de detalle corresponden a la parte dinámica del formulario. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

• Cree un elemento secundario que pertenezca al elemento de detalle llamando al método createElement del objeto Document y pase un valor de cadena que represente el nombre del elemento. Convertir el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su método appendChild y pase el método createTextNode del objeto Document como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Por último, agregue el elemento secundario al elemento de detalle llamando al método appendChild del elemento de detalle y pase el objeto de elemento secundario como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

   Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

• Repita el último subpaso para todos los elementos XML para anexar al elemento de detalle. Para crear correctamente el origen de datos XML utilizado para rellenar el formulario de pedido de compra, debe anexar los siguientes elementos XML al elemento de detalle: txtDescription, numQty y numUnitPrice.

• Repita los dos últimos pasos secundarios para todos los elementos de datos utilizados para rellenar previamente el formulario.

Conversión de la fuente de datos XML

• Cree un objeto javax.xml.transform.Transformer invocando el método newInstance estático del objeto javax.xml.transform.Transformer.
• Cree un objeto Transformer invocando el método newTransformer del objeto TransformerFactory.
• Crear un objeto ByteArrayOutputStream mediante su constructor.
• Cree un objeto javax.xml.transform.dom.DOMSource utilizando su constructor y pasando el objeto org.w3c.dom.Document creado en el paso 1.
• Cree un objeto javax.xml.transform.dom.DOMSource utilizando su constructor y pasando el objeto ByteArrayOutputStream.
• Rellene el objeto Java ByteArrayOutputStream invocando el método transform del objeto javax.xml.transform.Transformer y pasando los objetos javax.xml.transform.dom.DOMSource y javax.xml.transform.stream.StreamResult.
• Cree una matriz de bytes y asigne el tamaño del objeto ByteArrayOutputStream a la matriz de bytes.
• Rellene la matriz de bytes invocando el método toByteArray del objeto ByteArrayOutputStream.
• Cree un objeto BLOB utilizando su constructor, invoque su método setBinaryData y pase la matriz de bytes.

Procesar un formulario rellenado previamente

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

• Un valor de cadena que especifica el nombre del diseño del formulario, incluida la extensión del nombre de archivo.
• Objeto BLOB que contiene datos para combinar con el formulario. Asegúrese de utilizar el objeto BLOB creado en los pasos uno y dos.
• Objeto PDFFormRenderSpecc que almacena opciones en tiempo de ejecución. Para obtener más información, consulte Referencia de la API de AEM Forms.
• Un objeto URLSpec que contiene valores de URI requeridos por el servicio Forms.
• Objeto java.util.HashMap que almacena datos adjuntos de archivos. Este es 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 ha rellenado el método. Se utiliza para almacenar el formulario de PDF procesado.
• Un objeto javax.xml.rpc.holders.LongHolder vacío que ha rellenado el método. (Este argumento almacenará el número de páginas en el formulario).
• Un objeto javax.xml.rpc.holders.StringHolder vacío que ha rellenado 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 una secuencia de datos de formulario que debe escribirse en el explorador web del cliente.

• Cree un objeto FormResult obteniendo el valor del miembro de datos value del objeto com.adobe.idp.services.holders.FormsResultHolder.
• Cree un objeto BLOB que contenga datos de formulario invocando el método getOutputContent del objeto FormsResult.
• 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 utilizado para escribir el flujo de datos de formulario en el explorador web del cliente invocando el método getOutputStream del objeto javax.servlet.http.HttpServletResponse.
• Cree una matriz de bytes y rellénela invocando el método getBinaryData del objeto BLOB. Esta tarea asigna el contenido del objeto FormsResult a la matriz de bytes.
• Invoque el método write del objeto javax.servlet.http.HttpServletResponse para enviar la secuencia de datos de formulario al explorador web del cliente. Pase la matriz de bytes al método write.