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

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

Al rellenar previamente los formularios, se muestran datos a los usuarios dentro de un formulario procesado. Por ejemplo, supongamos que un usuario inicia sesión en un sitio web con un nombre de usuario y una contraseña. Si la autenticación se realiza correctamente, la aplicación cliente consulta una base de datos para obtener información del usuario. Los datos se combinan en el formulario y, a continuación, este se procesa para el usuario. Como resultado, el usuario puede ver datos personalizados dentro del formulario.

Rellenar previamente un formulario tiene las siguientes ventajas:

  • Permite al usuario ver datos personalizados en un formulario.
  • Reduce la cantidad de tiempo que el usuario escribe para rellenar un formulario.
  • Garantiza la integridad de los datos al tener control sobre dónde se colocan.

Los dos orígenes de datos XML siguientes pueden rellenar previamente un formulario:

  • Una fuente de datos XDP, que es XML que se ajusta a la sintaxis XFA (o datos XFDF para rellenar previamente un formulario creado con Acrobat).
  • Fuente de datos XML arbitraria que contiene pares de nombre/valor que coinciden con los nombres de campo del formulario (los ejemplos de esta sección utilizan una fuente de datos XML arbitraria).

Debe existir un elemento XML para cada campo de formulario que desee rellenar previamente. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. No es necesario coincidir con el orden en que se muestran los elementos XML, siempre y cuando se especifiquen todos los elementos XML.

Cuando se rellena previamente un formulario que ya contiene datos, se deben especificar los datos que ya se muestran en el origen de datos XML. Supongamos que un formulario que contiene 10 campos tiene datos en cuatro campos. A continuación, suponga que desea rellenar previamente los seis campos restantes. En este caso, debe especificar 10 elementos XML en la fuente de datos XML que se utiliza para rellenar previamente el formulario. Si especifica solo seis elementos, los cuatro campos originales están vacíos.

Por ejemplo, puede rellenar previamente un formulario como el formulario de confirmación de ejemplo. (Consulte "Formulario de confirmación" en Procesamiento de PDF forms interactivos.)

Para rellenar previamente el formulario de confirmación de ejemplo, debe crear un origen de datos XML que contenga tres elementos XML que coincidan con los tres campos del formulario. Este formulario contiene los tres campos siguientes: FirstName, LastName, y Amount. El primer paso es crear una fuente de datos XML que contenga elementos XML que coincidan con los campos del diseño de formulario. El siguiente paso es asignar valores de datos a los elementos XML, como se muestra en el siguiente código XML.

     <Untitled>
         <FirstName>Jerry</FirstName>
         <LastName>Johnson</LastName>
         <Amount>250000</Amount>
     </Untitled>

Después de rellenar previamente el formulario de confirmación con este origen de datos XML y, a continuación, procesar el formulario, se muestran los valores de datos asignados a los elementos XML, como se muestra en el diagrama siguiente.

pf_pf_confirmxml3

Rellenado previo de formularios con diseños flexibles prepopulating_forms_with_flowable_layouts-1

Los Forms con diseños flexibles son útiles para mostrar una cantidad indeterminada de datos a los usuarios. Dado que el diseño del formulario se ajusta automáticamente a la cantidad de datos que se combinan, no es necesario predeterminar un diseño fijo o un número de páginas para el formulario, como es necesario hacer con un formulario con un diseño fijo.

Un formulario se suele rellenar con datos que se obtienen durante el tiempo de ejecución. Como resultado, se puede rellenar previamente un formulario creando una fuente de datos XML en memoria y colocando los datos directamente en la fuente de datos XML en memoria.

Considere una aplicación basada en web, como una tienda en línea. Una vez que un comprador en línea termina de comprar artículos, todos los artículos comprados se colocan en una fuente de datos XML en memoria que se utiliza para rellenar previamente un formulario. El diagrama siguiente muestra este proceso, que se explica en la tabla siguiente.

pf_pf_finsrv_webapp_v1

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

Paso
Descripción
1
Un usuario compra artículos en una tienda en línea basada en web.
2
Una vez que el usuario termina de comprar elementos y hace clic en el botón Enviar, se crea una fuente de datos XML en memoria. Los elementos adquiridos y la información de usuario se colocan en la fuente de datos XML en memoria.
3
La fuente de datos XML se utiliza para rellenar previamente un formulario de pedido de compra (a continuación de esta tabla se muestra un ejemplo de este formulario).
4
El formulario de pedido de compra se procesa en el explorador web del cliente.

El diagrama siguiente muestra un ejemplo de un formulario de pedido de compra. La información de la tabla se puede ajustar al número de registros de los datos XML.

pf_pf_proform

NOTE
Un formulario se puede rellenar previamente con datos de otras fuentes, como una base de datos empresarial o aplicaciones externas.

Consideraciones del diseño del formulario form-design-considerations

Forms con diseños flexibles se basan en diseños de formulario creados en Designer. Un diseño de formulario especifica un conjunto de reglas de diseño, presentación y captura de datos, incluido el cálculo de valores basado en los datos introducidos por el usuario. Las reglas se aplican cuando se introducen datos en un formulario. Los campos que se agregan a un formulario son subformularios que se encuentran dentro del diseño del formulario. Por ejemplo, en el formulario de pedido de compra que se muestra en el diagrama anterior, cada línea es un subformulario. Para obtener información sobre la creación de un diseño de formulario que contenga subformularios, consulte Creación de un formulario de pedido de compra con un diseño variable.

Explicación de los subgrupos de datos understanding-data-subgroups

Se utiliza una fuente de datos XML para rellenar previamente formularios con diseños fijos y diseños flexibles. Sin embargo, la diferencia radica en que un origen de datos XML que rellena previamente un formulario con un diseño variable contiene elementos XML repetidos que se utilizan para rellenar previamente subformularios que se repiten dentro del formulario. Estos elementos XML repetitivos se denominan subgrupos de datos.

Una fuente de datos XML que se utiliza para rellenar previamente el formulario de pedido de compra que se muestra en el diagrama anterior contiene cuatro subgrupos de datos repetidos. Cada subgrupo de datos corresponde a un artículo comprado. Los artículos adquiridos son un monitor, una lámpara de escritorio, un teléfono y una libreta de direcciones.

La siguiente fuente de datos XML se utiliza para rellenar previamente el formulario de pedido de compra.

     <header>
         <!-- XML elements used to prepopulate non-repeating fields such as address
         <!and city
         <txtPONum>8745236985</txtPONum>
         <dtmDate>2004-02-08</dtmDate>
         <txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>
         <txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>
         <txtOrderedByCity>Any City</txtOrderedByCity>
         <txtOrderedByStateProv>ST</txtOrderedByStateProv>
         <txtOrderedByZipCode>12345</txtOrderedByZipCode>
         <txtOrderedByCountry>Any Country</txtOrderedByCountry>
         <txtOrderedByPhone>(123) 456-7890</txtOrderedByPhone>
         <txtOrderedByFax>(123) 456-7899</txtOrderedByFax>
         <txtOrderedByContactName>Contact Name</txtOrderedByContactName>
         <txtDeliverToCompanyName>Any Company Name</txtDeliverToCompanyName>
         <txtDeliverToAddress>7895, Any Street</txtDeliverToAddress>
         <txtDeliverToCity>Any City</txtDeliverToCity>
         <txtDeliverToStateProv>ST</txtDeliverToStateProv>
         <txtDeliverToZipCode>12346</txtDeliverToZipCode>
         <txtDeliverToCountry>Any Country</txtDeliverToCountry>
         <txtDeliverToPhone>(123) 456-7891</txtDeliverToPhone>
         <txtDeliverToFax>(123) 456-7899</txtDeliverToFax>
         <txtDeliverToContactName>Contact Name</txtDeliverToContactName>
     </header>
     <detail>
         <!-- A data subgroup that contains information about the monitor>
         <txtPartNum>00010-100</txtPartNum>
         <txtDescription>Monitor</txtDescription>
         <numQty>1</numQty>
         <numUnitPrice>350.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the desk lamp>
         <txtPartNum>00010-200</txtPartNum>
         <txtDescription>Desk lamps</txtDescription>
         <numQty>3</numQty>
         <numUnitPrice>55.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the Phone>
             <txtPartNum>00025-275</txtPartNum>
             <txtDescription>Phone</txtDescription>
             <numQty>5</numQty>
             <numUnitPrice>85.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the address book>
         <txtPartNum>00300-896</txtPartNum>
         <txtDescription>Address book</txtDescription>
         <numQty>2</numQty>
         <numUnitPrice>15.00</numUnitPrice>
     </detail>

Tenga en cuenta que cada subgrupo de datos contiene cuatro elementos XML que se corresponden con esta información:

  • Número de pieza de artículos
  • Descripción de elementos
  • Cantidad de artículos
  • Precio unitario

El nombre del elemento XML principal de un subgrupo de datos debe coincidir con el nombre del subformulario que se encuentra en el diseño de formulario. Por ejemplo, en el diagrama anterior, observe que el nombre del elemento XML principal del subgrupo de datos es detail. Corresponde al nombre del subformulario que se encuentra en el diseño de formulario en el que se basa el formulario de pedido de compra. Si el nombre del elemento XML principal del subgrupo de datos y el subformulario no coinciden, no se rellenará previamente un formulario del lado del servidor.

Cada subgrupo de datos debe contener elementos XML que coincidan con los nombres de campo del subformulario. El detail El subformulario del diseño de formulario contiene los campos siguientes:

  • txtPartNum
  • txtDescription
  • numQty
  • numUnitPrice
NOTE
Si intenta rellenar previamente un formulario con un origen de datos que contiene elementos XML repetidos y establece el RenderAtClient opción para No, solo se combinará el primer registro de datos en el formulario. Para asegurarse de que todos los registros de datos se combinan en el formulario, establezca el RenderAtClient hasta Yes. Para obtener más información sobre RenderAtClient opción, consulte Procesar Forms en el cliente.
NOTE
Para obtener más información sobre el servicio Forms, consulte Referencia de servicios para AEM Forms.

Resumen de los pasos summary-of-steps

Para rellenar previamente un formulario con un diseño variable, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Crear una fuente de datos XML en memoria.
  3. Convertir la fuente de datos XML.
  4. Procesar un formulario rellenado previamente.

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.

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.

Crear una fuente de datos XML en memoria

Puede utilizar org.w3c.dom clases para crear un origen de datos XML en memoria para rellenar previamente un formulario con un diseño variable. Coloque los datos en una fuente de datos XML que se ajuste al formulario. Para obtener información sobre la relación entre un formulario con un diseño variable y la fuente de datos XML, consulte Explicación de los subgrupos de datos.

Conversión de la fuente de datos XML

Fuente de datos XML en memoria que se crea mediante org.w3c.dom Las clases se pueden convertir en un com.adobe.idp.Document antes de poder utilizarlo para rellenar previamente un formulario. Una fuente de datos XML en memoria se puede convertir mediante clases de transformación XML de Java.

NOTE
Si utiliza el WSDL del servicio Forms para rellenar previamente un formulario, debe convertir un org.w3c.dom.Document objeto en un BLOB objeto.

Procesar un formulario rellenado previamente

Puede procesar un formulario rellenado previamente como cualquier otro formulario. La única diferencia es que se usa la variable com.adobe.idp.Document que contiene el origen de datos XML para rellenar previamente el formulario.

Consulte también

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Inicio rápido de la API del servicio de Forms

Procesar formularios PDF interactivos

Crear aplicaciones web que procesen Forms

Rellenado previo de formularios con la API de Java prepopulating-forms-using-the-java-api

Para rellenar previamente un formulario con un diseño variable mediante la API de Forms (Java), realice los siguientes pasos:

  1. 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 acerca de la ubicación de estos archivos, consulte Incluir archivos de biblioteca Java de AEM Forms.

  2. Crear una fuente de datos XML en memoria

    • Crear un Java DocumentBuilderFactory llamando a la función DocumentBuilderFactory class' newInstance método.

    • Crear un Java DocumentBuilder llamando a la función DocumentBuilderFactory del objeto newDocumentBuilder método.

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

    • Cree el elemento raíz de la fuente de datos XML invocando el org.w3c.dom.Document del objeto createElement método. Esto crea un Element que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento a createElement método. Convierta el valor devuelto en Element. A continuación, anexe el elemento raíz al documento llamando a la función Document del objeto appendChild 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 de la fuente de datos XML llamando a la variable Document del objeto createElement método. Pase un valor de cadena que represente el nombre del elemento a createElement método. Convierta el valor devuelto en Element. A continuación, añada el elemento header al elemento raíz llamando a la variable root del objeto appendChild y pase el objeto header element como un 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 a la variable Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Convierta el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el método 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 header llamando al método 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 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 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 createElement método. Convierta el valor devuelto en 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 de elemento de detalle 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 a la variable Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Convierta el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el método 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 del 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 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.

  3. Conversión de la fuente de datos XML

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

    Invoque el FormsServiceClient del objeto renderPDFForm y pasar los siguientes valores:

    • Un valor de cadena que especifica el nombre del diseño del formulario, incluida la extensión del nombre de archivo.
    • A com.adobe.idp.Document que contiene datos para combinar con el formulario. Asegúrese de utilizar el 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 requeridos por el servicio de 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.

    El renderPDFForm El método devuelve un valor FormsResult que contiene un flujo de datos de formulario que debe escribirse en el explorador web cliente.

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

Consulte también

Inicio rápido (modo SOAP): Rellenado previo de Forms con diseños flexibles mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Rellenado previo de formularios mediante la API de servicio web prepopulating-forms-using-the-web-service-api

Para rellenar previamente un formulario con un diseño variable mediante la API de Forms (servicio web), realice los siguientes pasos:

  1. Incluir archivos de proyecto

  2. Crear una fuente de datos XML en memoria

    • Crear un Java DocumentBuilderFactory llamando a la función DocumentBuilderFactory class' newInstance método.

    • Crear un Java DocumentBuilder llamando a la función DocumentBuilderFactory del objeto newDocumentBuilder método.

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

    • Cree el elemento raíz de la fuente de datos XML invocando el org.w3c.dom.Document del objeto createElement método. Esto crea un Element que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento a createElement método. Convierta el valor devuelto en Element. A continuación, anexe el elemento raíz al documento llamando a la función Document del objeto appendChild 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 de la fuente de datos XML llamando a la variable Document del objeto createElement método. Pase un valor de cadena que represente el nombre del elemento a createElement método. Convierta el valor devuelto en Element. A continuación, añada el elemento header al elemento raíz llamando a la variable root del objeto appendChild y pase el objeto header element como un 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 a la variable Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Convierta el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el método 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 header llamando al método 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 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 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 createElement método. Convierta el valor devuelto en 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 de elemento de detalle 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 a la variable Document del objeto createElement y pase un valor de cadena que represente el nombre del elemento. Convierta el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su appendChild y pase el método 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 del 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 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.

  3. Conversión de la fuente de datos XML

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

    Invoque el FormsService del objeto renderPDFForm y pasar los siguientes valores:

    • Un valor de cadena que especifica el nombre del diseño del formulario, incluida la extensión del nombre de archivo.
    • A BLOB que contiene datos para combinar con el formulario. Asegúrese de utilizar el BLOB objeto que se creó 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 API de AEM Forms.
    • A URLSpec que contiene valores de URI requeridos por el servicio de 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 en el 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.

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

    • Crear un FormResult al obtener el valor de la variable com.adobe.idp.services.holders.FormsResultHolder del objeto value miembro de datos.
    • Crear un BLOB que contiene datos de formulario invocando el FormsResult del objeto getOutputContent método.
    • Obtenga el tipo de contenido del BLOB invocando su objeto getContentType método.
    • Configure las variables javax.servlet.http.HttpServletResponse tipo de contenido del objeto invocando su setContentType y pasando el tipo de contenido del BLOB objeto.
    • Crear un javax.servlet.ServletOutputStream objeto utilizado para escribir el flujo de datos de formulario en el explorador web del cliente invocando el javax.servlet.http.HttpServletResponse del objeto getOutputStream método.
    • Cree una matriz de bytes y rellénela invocando el método BLOB del objeto getBinaryData método. Esta tarea asigna el contenido del FormsResult a la matriz de bytes.
    • Invoque el javax.servlet.http.HttpServletResponse del objeto write para enviar el flujo de datos de formulario al explorador web del cliente. Pase la matriz de bytes a write método.
    note note
    NOTE
    El renderPDFForm rellena el método 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.

Consulte también

Invocar AEM Forms con codificación Base64

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2