Los ejemplos de este documento solo son para AEM Forms en un entorno JEE.
El servicio de integración de datos de formulario puede importar datos en un formulario de PDF y exportarlos desde un formulario de PDF. Las operaciones de importación y exportación admiten dos tipos de PDF forms:
Los datos de formulario pueden existir en uno de los siguientes formatos según el tipo de formulario del PDF:
Puede realizar estas tareas mediante el servicio de integración de datos de formulario:
Para obtener más información sobre el servicio de integración de datos de formulario, consulte Referencia de servicios para AEM Forms.
Puede importar datos de formulario en PDF forms interactivos mediante el servicio de integración de datos de formulario. Un formulario PDF interactivo es un documento de PDF que contiene uno o más campos para recopilar información de un usuario o para mostrar información personalizada. El servicio de integración de datos de formulario no admite cálculos de formulario, validación ni scripts.
Para importar datos en un formulario creado en Designer, debe hacer referencia a un origen de datos XML XDP válido. Veamos el siguiente ejemplo de formulario de solicitud de hipoteca.
Para importar valores de datos en este formulario, debe tener una fuente de datos XML XDP válida que corresponda al formulario. No se puede utilizar una fuente de datos XML arbitraria para importar datos a un formulario mediante el servicio de integración de datos de formulario. La diferencia entre una fuente de datos XML arbitraria y una fuente de datos XML XDP es que una fuente de datos XDP se ajusta a la arquitectura Forms XML (XFA). El siguiente XML representa una fuente de datos XML XDP que corresponde al formulario de aplicación hipotecaria de ejemplo.
<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
- <Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
- <Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
Para obtener más información sobre el servicio de integración de datos de formulario, consulte Referencia de servicios para AEM Forms.
Para importar datos de formulario en un formulario de PDF, realice los siguientes pasos:
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.
Los siguientes archivos JAR deben añadirse a la ruta de clase del proyecto:
Para obtener información sobre la ubicación de estos archivos JAR, consulte Incluir archivos de biblioteca Java de AEM Forms.
Crear un cliente del servicio de integración de datos de formulario
Para poder importar datos mediante programación en una API de cliente de formulario de PDF, debe crear un cliente de servicio de integración de datos. Al crear un cliente de servicios, define la configuración de conexión necesaria para invocar un servicio. Para obtener más información, consulte Estableciendo propiedades de conexión.
Referencia a un formulario de PDF
Para importar datos en un formulario de PDF, debe hacer referencia a un formulario XML creado en Designer o a un formulario de Acrobat creado en Acrobat.
Hacer referencia a una fuente de datos XML
Para importar datos de formulario, debe hacer referencia a una fuente de datos válida. Para importar datos en un formulario XML XFA creado en Designer, debe utilizar una fuente de datos XML XDP. Si hace referencia a un formulario de Acrobat, debe utilizar una fuente de datos XFDF. Para cada campo en el que desee importar datos, se debe especificar un valor. Si un elemento ubicado en la fuente de datos XML no se corresponde con un campo del formulario, el elemento se ignora.
Importación de datos en el formulario de PDF
Después de hacer referencia a un formulario de PDF y a una fuente de datos XML válida, puede importar los datos en el formulario de PDF.
Guarde el formulario de PDF como archivo de PDF
Después de importar los datos en un formulario, puede guardarlo como un archivo de PDF. Una vez guardado como archivo de PDF, un usuario puede abrir el formulario en Adobe Reader o Acrobat y verlo con los datos importados.
Consulte también
Importar datos de formulario mediante la API de Java
Importación de datos de formulario mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicio rápido de la API del servicio de integración de datos de formulario
Exportación de datos de formulario
Importar datos de formulario mediante la API de integración de datos de formulario (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-formdataintegration-client.jar, en la ruta de clase del proyecto Java.
Cree un cliente del servicio de integración de datos de formulario.
ServiceClientFactory
que contiene las propiedades de conexión.FormDataIntegrationClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a un formulario de PDF.
java.io.FileInputStream
mediante su constructor. Pase un valor de cadena que especifique la ubicación del formulario de PDF.com.adobe.idp.Document
que almacena el formulario de PDF mediante el objeto com.adobe.idp.Document
constructor. Pase el java.io.FileInputStream
que contiene el formulario PDF al constructor.Hacer referencia a una fuente de datos XML.
java.io.FileInputStream
mediante su constructor y pase un valor de cadena que especifique la ubicación del archivo XML que contiene los datos que se van a importar al formulario.com.adobe.idp.Document
que almacena datos de formulario utilizando com.adobe.idp.Document
constructor. Pase el java.io.FileInputStream
que contiene datos de formulario al constructor.Importe datos en el formulario de PDF.
Importe datos en el formulario de PDF invocando el FormDataIntegrationClient
del objeto importData
y pasando los siguientes valores:
com.adobe.idp.Document
que almacena el formulario de PDF.com.adobe.idp.Document
que almacena datos de formulario.El importData
El método devuelve un valor com.adobe.idp.Document
que almacena un formulario de PDF que contiene los datos ubicados en el origen de datos XML.
Guarde el formulario de PDF como archivo de PDF.
java.io.File
y asegúrese de que la extensión del archivo es ".PDF".Document
del objeto copyToFile
para copiar el contenido del Document
al archivo (asegúrese de utilizar la variable Document
objeto que ha devuelto el importData
método).Consulte también
Inicio rápido (modo SOAP): Importación de datos de formulario mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Importar datos de formulario mediante la API de integración de datos de formulario (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.
Reemplazar localhost
con la dirección IP del servidor que aloja AEM Forms.
Cree un cliente del servicio de integración de datos de formulario.
Crear un FormDataIntegrationClient
mediante su constructor predeterminado.
Crear un FormDataIntegrationClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable FormDataIntegrationClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
.FormDataIntegrationClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a un formulario de PDF.
BLOB
mediante su constructor. Esta BLOB
se utiliza para almacenar el formulario de PDF.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que especifique la ubicación del formulario del PDF y el modo en que se abrirá el archivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
método. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Hacer referencia a una fuente de datos XML.
BLOB
mediante su constructor. Esta BLOB
se utiliza para almacenar los datos importados en el formulario.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que especifique la ubicación del archivo XML que contiene los datos que se van a importar y el modo en que se va a abrir el archivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
método. Pase a leer la matriz de bytes, la posición inicial y la longitud de la secuencia.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Importe datos en el formulario de PDF.
Importe datos al formulario de PDF invocando el FormDataIntegrationClient
del objeto importData
y pasando los siguientes valores:
BLOB
que almacena el formulario de PDF.BLOB
que almacena datos de formulario.El importData
El método devuelve un valor BLOB
que almacena un formulario de PDF que contiene los datos ubicados en el origen de datos XML.
Guarde el formulario de PDF como archivo de PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación de archivo del archivo PDF.BLOB
objeto que ha devuelto el importData
método. Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
field.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Puede exportar datos de formulario desde un formulario de PDF interactivo mediante el servicio de integración de datos de formulario. El formato de los datos exportados depende del tipo de formulario. Si el tipo de formulario es un formulario de Acrobat creado en Acrobat, los datos exportados serán XFDF. Si el tipo de formulario es un formulario XML creado en Designer, los datos exportados son XDP.
Para obtener más información sobre el servicio de integración de datos de formulario, consulte Referencia de servicios para AEM Forms.
Para exportar datos de formulario desde un formulario de PDF, realice los siguientes pasos:
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.
Los siguientes archivos JAR deben añadirse a la ruta de clase del proyecto:
Crear un cliente del servicio de integración de datos de formulario
Para poder importar datos mediante programación en una API de cliente de formulario de PDF, debe crear un cliente del servicio de integración de datos. Al crear un cliente de servicios, define la configuración de conexión necesaria para invocar un servicio. Para obtener más información, Estableciendo propiedades de conexión.
Referencia a un formulario de PDF
Para exportar datos desde un formulario de PDF, debe hacer referencia al formulario de PDF que se creó en Designer o Acrobat y que contiene datos de formulario. Si intenta exportar datos desde un formulario PDF vacío, obtendrá un esquema XML vacío.
Exportación de datos desde el formulario de PDF
Después de hacer referencia a un formulario de PDF que contiene datos de formulario, puede exportar los datos desde el formulario. Los datos se exportan dentro de un esquema XML basado en el formulario.
Guardar los datos del formulario como un archivo XML
Después de exportar los datos del formulario, puede guardarlos como un archivo XML. Una vez guardado como archivo XML, puede abrirlo en un visor XML para ver los datos del formulario.
Consulte también
Exportar datos de formulario mediante la API de Java
Exportación de datos de formulario mediante la API de servicio web
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Inicio rápido de la API del servicio de integración de datos de formulario
Importación de datos de formulario
Exportar datos de formulario mediante la API de integración de datos de formulario (Java):
Incluir archivos de proyecto.
Incluya archivos JAR de cliente, como adobe-formdataintegration-client.jar, en la ruta de clase del proyecto Java.
Cree un cliente del servicio de integración de datos de formulario.
ServiceClientFactory
que contiene las propiedades de conexión.FormDataIntegrationClient
usando su constructor y pasando el objeto ServiceClientFactory
objeto.Hacer referencia a un formulario de PDF.
java.io.FileInputStream
mediante su constructor y pase un valor de cadena que especifique la ubicación del formulario de PDF que contiene los datos que se van a exportar.com.adobe.idp.Document
que almacena el formulario de PDF mediante el objeto com.adobe.idp.Document
constructor. Pase el java.io.FileInputStream
que contiene el formulario PDF al constructor.Exporte datos desde el formulario de PDF.
Exportar datos de formulario invocando el FormDataIntegrationClient
del objeto exportData
y pase el com.adobe.idp.Document
que almacena el formulario de PDF. Este método devuelve un com.adobe.idp.Document
que almacena datos de formulario como un esquema XML.
Guarde el formulario de PDF como archivo de PDF.
java.io.File
y asegúrese de que la extensión del archivo es XML.Document
del objeto copyToFile
para copiar el contenido del Document
al archivo (asegúrese de utilizar la variable Document
objeto que ha devuelto el exportData
método).Consulte también
Inicio rápido (modo SOAP): Exportación de datos de formulario mediante la API de Java
Incluir archivos de biblioteca Java de AEM Forms
Estableciendo propiedades de conexión
Exportar datos de formulario mediante la API de integración de datos de formulario (servicio web):
Incluir archivos de proyecto.
Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL: http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.
localhost
con la dirección IP del servidor que aloja AEM Forms.Cree un cliente del servicio de integración de datos de formulario.
Crear un FormDataIntegrationClient
mediante su constructor predeterminado.
Crear un FormDataIntegrationClient.Endpoint.Address
mediante el uso del objeto System.ServiceModel.EndpointAddress
constructor. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) No es necesario que utilice el lc_version
atributo. Este atributo se utiliza al crear una referencia de servicio. Sin embargo, especifique ?blob=mtom
para utilizar MTOM.
Crear un System.ServiceModel.BasicHttpBinding
al obtener el valor de la variable FormDataIntegrationClient.Endpoint.Binding
field. Convierta el valor devuelto en BasicHttpBinding
.
Configure las variables System.ServiceModel.BasicHttpBinding
del objeto MessageEncoding
field a WSMessageEncoding.Mtom
. Este valor garantiza que se utiliza MTOM.
Habilite la autenticación HTTP básica realizando las siguientes tareas:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
.FormDataIntegrationClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
al campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
al campo BasicHttpBindingSecurity.Security.Mode
.Hacer referencia a un formulario de PDF.
BLOB
mediante su constructor. Esta BLOB
se utiliza para almacenar el formulario de PDF desde el que se exportan los datos.System.IO.FileStream
invocando su constructor. Pase un valor de cadena que especifique la ubicación del formulario del PDF y el modo en que se abrirá el archivo.System.IO.FileStream
objeto. Puede determinar el tamaño de la matriz de bytes obteniendo el System.IO.FileStream
del objeto Length
propiedad.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición inicial y la longitud de la secuencia que se va a leer.BLOB
al asignar su MTOM
con el contenido de la matriz de bytes.Exporte datos desde el formulario de PDF.
Importe datos en el formulario de PDF invocando el FormDataIntegrationClient
del objeto exportData
y pase el BLOB
que almacena el formulario de PDF. Este método devuelve un BLOB
que almacena datos de formulario como un esquema XML.
Guarde el formulario de PDF como archivo de PDF.
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo XML.BLOB
objeto que ha devuelto el exportData
método. Rellene la matriz de bytes obteniendo el valor de BLOB
del objeto MTOM
field.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
objeto.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también
Invocar AEM Forms mediante MTOM
Invocar AEM Forms mediante SwaRef