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

Incluir archivos de proyecto

Incluya archivos JAR del cliente, como adobe-forms-client.jar, en la ruta de clase de su 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 un origen de datos XML en memoria

• Creación de un Java DocumentBuilderFactory llamando al DocumentBuilderFactory class" newInstance método.

• Creación de un Java DocumentBuilder llamando al DocumentBuilderFactory del objeto newDocumentBuilder método.

• Llame a la función DocumentBuilder del objeto newDocument para crear una instancia de org.w3c.dom.Document objeto.

• Cree el elemento raíz del origen de datos XML invocando la variable org.w3c.dom.Document del objeto createElement método. Esto crea un Element objeto que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento a la variable createElement método. Conversión del valor devuelto a Element. A continuación, anexe el elemento raíz al documento llamando a la función Document del objeto appendChild y pase el objeto de 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 de la fuente de datos XML llamando a la función Document del objeto createElement método. Pase un valor de cadena que represente el nombre del elemento a la variable createElement método. Conversión del valor devuelto a Element. A continuación, anexe el elemento de encabezado al elemento raíz llamando a la función root del objeto appendChild y pase el objeto de elemento de encabezado como un argumento. Los elementos XML que se adjuntan al elemento de encabezado 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 del encabezado llamando a la función Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Conversión del valor devuelto a Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el Document del objeto createTextNode como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Finalmente, anexe el elemento secundario al elemento del encabezado llamando al elemento del encabezado appendChild 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 del encabezado repitiendo el último subpaso para cada campo que aparezca en la parte estática del formulario (en el diagrama de origen 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 de la fuente de datos XML llamando a la función Document del objeto createElement método. Pase un valor de cadena que represente el nombre del elemento a la variable createElement método. Conversión del valor devuelto a Element. A continuación, anexe el elemento de detalle al elemento raíz llamando a la función root del objeto appendChild y pase el objeto detail element como argumento. Los elementos XML que se adjuntan al elemento 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 a la función Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Conversión del valor devuelto a Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el Document del objeto createTextNode como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Finalmente, anexe el elemento secundario al elemento de detalle llamando al elemento de detalle appendChild 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 que desee anexar al elemento detalle. Para crear correctamente el origen de datos XML utilizado para rellenar el formulario de orden de compra, debe añadir los siguientes elementos XML al elemento detalle: txtDescription, numQtyy numUnitPrice.

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

Convertir el origen de datos XML

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

Representar un formulario rellenado previamente

Invocar el 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.
• A com.adobe.idp.Document objeto que contiene datos para combinar con el formulario. Asegúrese de usar la variable com.adobe.idp.Document objeto creado en los pasos uno y dos.
• A PDFFormRenderSpec que almacena opciones en tiempo de ejecución.
• A URLSpec que contiene valores de URI necesarios para el servicio Forms.
• A java.util.HashMap que almacena archivos adjuntos. Este es un parámetro opcional y puede especificar null si no desea adjuntar archivos al formulario.

La variable renderPDFForm el método devuelve un FormsResult objeto que contiene un flujo de datos de formulario que debe escribirse en el explorador web del cliente.

• Cree un javax.servlet.ServletOutputStream objeto utilizado para enviar una secuencia de datos de formulario al explorador web del cliente.
• Cree un com.adobe.idp.Document invocando el objeto FormsResult objeto ‘s getOutputContent método.
• Cree un java.io.InputStream invocando el objeto com.adobe.idp.Document del objeto getInputStream método.
• Crear una matriz de bytes rellenarla con la secuencia de datos del formulario invocando la variable InputStream del objeto read y pasando la matriz de bytes como argumento.
• Invocar el javax.servlet.ServletOutputStream del objeto write método para enviar la secuencia de datos del formulario al explorador web del cliente. Pase la matriz de bytes a la write método.

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 el eje Apache.)
• Incluya las clases proxy de Java en la ruta de clase.

Crear un origen de datos XML en memoria

• Creación de un Java DocumentBuilderFactory llamando al DocumentBuilderFactory class" newInstance método.

• Creación de un Java DocumentBuilder llamando al DocumentBuilderFactory del objeto newDocumentBuilder método.

• Llame a la función DocumentBuilder del objeto newDocument para crear una instancia de org.w3c.dom.Document objeto.

• Cree el elemento raíz del origen de datos XML invocando la variable org.w3c.dom.Document del objeto createElement método. Esto crea un Element objeto que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento a la variable createElement método. Conversión del valor devuelto a Element. A continuación, anexe el elemento raíz al documento llamando a la función Document del objeto appendChild y pase el objeto de 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 de la fuente de datos XML llamando a la función Document del objeto createElement método. Pase un valor de cadena que represente el nombre del elemento a la variable createElement método. Conversión del valor devuelto a Element. A continuación, anexe el elemento de encabezado al elemento raíz llamando a la función root del objeto appendChild y pase el objeto de elemento de encabezado como un argumento. Los elementos XML que se adjuntan al elemento de encabezado 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 del encabezado llamando a la función Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Conversión del valor devuelto a Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el Document del objeto createTextNode como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Finalmente, anexe el elemento secundario al elemento del encabezado llamando al elemento del encabezado appendChild 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 del encabezado repitiendo el último subpaso para cada campo que aparezca en la parte estática del formulario (en el diagrama de origen 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 de la fuente de datos XML llamando a la función Document del objeto createElement método. Pase un valor de cadena que represente el nombre del elemento a la variable createElement método. Conversión del valor devuelto a Element. A continuación, anexe el elemento de detalle al elemento raíz llamando a la función root del objeto appendChild y pase el objeto detail element como argumento. Los elementos XML que se adjuntan al elemento 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 a la función Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Conversión del valor devuelto a Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el Document del objeto createTextNode como argumento. Especifique un valor de cadena que aparezca como el valor del elemento secundario. Finalmente, anexe el elemento secundario al elemento de detalle llamando al elemento de detalle appendChild 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 que desee anexar al elemento detalle. Para crear correctamente el origen de datos XML utilizado para rellenar el formulario de orden de compra, debe añadir los siguientes elementos XML al elemento detalle: txtDescription, numQtyy numUnitPrice.

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

Convertir el origen de datos XML

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

Representar un formulario rellenado previamente

Invocar el 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.
• A BLOB objeto que contiene datos para combinar con el formulario. Asegúrese de usar la variable BLOB objeto creado en los pasos uno y dos.
• A PDFFormRenderSpecc que almacena opciones en tiempo de ejecución. Para obtener más información, consulte Referencia de la API de AEM Forms.
• A URLSpec que contiene valores de URI necesarios para el servicio Forms.
• A java.util.HashMap que almacena archivos adjuntos. Este es un parámetro opcional y puede especificar null si no desea adjuntar archivos al formulario.
• Un vacío com.adobe.idp.services.holders.BLOBHolder objeto que rellena el método . Se utiliza para almacenar el formulario de PDF procesado.
• Un vacío javax.xml.rpc.holders.LongHolder objeto que rellena el método . (Este argumento almacenará el número de páginas del formulario).
• Un vacío javax.xml.rpc.holders.StringHolder objeto que rellena el método . (Este argumento almacenará el valor de configuración regional).
• Un vacío com.adobe.idp.services.holders.FormsResultHolder que contendrá los resultados de esta operación.

La variable renderPDFForm rellena el com.adobe.idp.services.holders.FormsResultHolder objeto 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.

• Cree un FormResult obteniendo el valor de com.adobe.idp.services.holders.FormsResultHolder del objeto value miembro de datos.
• Cree un BLOB objeto que contiene datos de formulario invocando la variable FormsResult del objeto getOutputContent método.
• Obtenga el tipo de contenido de la variable BLOB invocando su getContentType método.
• Configure las variables javax.servlet.http.HttpServletResponse tipo de contenido del objeto invocando su setContentType y pasar el tipo de contenido de la variable BLOB objeto.
• Cree un javax.servlet.ServletOutputStream objeto utilizado para escribir el flujo de datos del formulario en el explorador web del cliente invocando la variable javax.servlet.http.HttpServletResponse del objeto getOutputStream método.
• Cree una matriz de bytes y rellénela invocando la variable BLOB del objeto getBinaryData método. Esta tarea asigna el contenido de la variable FormsResult a la matriz de bytes.
• Invocar el javax.servlet.http.HttpServletResponse del objeto write método para enviar la secuencia de datos del formulario al explorador web del cliente. Pase la matriz de bytes a la write método.