Los ejemplos y ejemplos de este documento son solo para AEM Forms en un entorno JEE.
El servicio de códigos de barras de formularios automatiza la captura de datos de formularios de relleno e impresión e integra la información capturada en los sistemas informáticos principales de una organización.
Con el servicio de códigos de barras de formularios, se pueden agregar códigos de barras unidimensionales y bidimensionales a los PDF forms interactivos. A continuación, puede publicar los formularios con códigos de barras en un sitio web o distribuirlos por correo electrónico o CD. Cuando un usuario rellena un formulario con códigos de barras utilizando Adobe Reader, Acrobat Professional o Acrobat Standard, el código de barras se actualiza automáticamente para codificar los datos del formulario proporcionados por el usuario. El usuario puede enviar el formulario electrónicamente o imprimirlo en papel y enviarlo por correo, fax o mano. Posteriormente, se pueden extraer los datos suministrados por el usuario como parte de un flujo de trabajo automatizado, lo que enruta los datos entre los procesos de aprobación y los sistemas empresariales.
Para obtener más información sobre el servicio de formularios con códigos de barras, consulte Referencia de servicios para AEM Forms.
Puede utilizar la API de servicio de formularios con códigos de barras para descodificar datos de un formulario PDF o una imagen que contenga un código de barras. Descodificar datos de formulario significa extraer datos que se encuentran en el código de barras. Para poder decodificar los datos de un formulario PDF (o imagen), el usuario debe rellenar el formulario con datos.
Para obtener más información sobre el servicio de formularios con códigos de barras, consulte Referencia de servicios para AEM Forms.
Para descodificar datos de un formulario 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 utilizando Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.
Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:
Si AEM Forms se implementa en un servidor de aplicaciones J2EE compatible que no sea JBOSS, deberá reemplazar adobe-Utilities.jar y jbossall-client.jar por archivos JAR específicos del servidor de aplicaciones J2EE en el que se implementa AEM Forms. Para obtener información sobre la ubicación de todos los archivos JAR de AEM Forms, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de API de cliente de formularios con códigos de barras
Para poder realizar una operación de servicio de formularios con códigos de barras mediante programación, debe crear un cliente de servicio de Forms con códigos de barras. Si utiliza la API de Java, cree un objeto BarcodedFormsServiceClient
. Si utiliza la API de servicio web de formularios con códigos de barras, cree un objeto BarcodedFormsServiceService
.
Obtener un formulario PDF que contenga datos codificados con barras
Debe obtener un formulario PDF que contenga un código de barras que se haya rellenado con datos de usuario.
Descodificar los datos del formulario PDF
Después de obtener un formulario PDF (o imagen) que contenga un código de barras, puede descodificar los datos. El servicio Forms con códigos de barras es compatible con los siguientes tipos de códigos de barras:
La entrada de conjuntos de caracteres como hexadecimal en la API de decodificación implica que el contenido del código de barras se codifica como una cadena hexadecimal. Por ejemplo, si UTF-8 se especifica como codificación de caracteres en el formulario y Hex se especifica en la operación de descodificación, el contenido del código de barras se codifica como una cadena Hex en el elemento < xb:content
> de la salida descodificada. Puede convertir este valor Hex para obtener el contenido original creando lógica de aplicación en la aplicación cliente.
Convertir los datos en un origen de datos XML
Después de decodificar los datos de formulario, puede convertirlos en datos XDP o XFDF. Por ejemplo, supongamos que desea importar los datos en otro formulario. Para importar los datos en un formulario XFA, debe convertirlos en datos XDP. Para obtener más información, consulte Importación de datos de formulario.
Procesamiento de los datos decodificados
Puede procesar los datos convertidos para satisfacer los requisitos empresariales. Por ejemplo, después de decodificar y convertir los datos, puede guardarlos en un archivo, guardarlos en una base de datos empresarial, rellenar otro formulario, etc. En esta sección se explica cómo guardar los datos convertidos como un archivo XML.
El servicio de códigos de barras no descodifica los datos del código de barras cuando los parámetros delimitador de línea y delimitador de campo tienen el mismo valor
Consulte también
Descodificar datos de formulario codificados mediante la API de Java
Descodificar datos de formulario codificados mediante la API de servicio web
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Descodificar datos de formulario utilizando la API de formularios con códigos de barras (Java):
Incluir archivos de proyecto
Incluya archivos JAR de cliente en la ruta de clase de su proyecto Java.
Crear un objeto de API de cliente de formularios con códigos de barras
Cree un objeto BarcodedFormsServiceClient
utilizando su constructor y pasando un objeto ServiceClientFactory
que contenga propiedades de conexión.
Obtener un formulario PDF que contenga datos codificados con barras
java.io.FileInputStream
que represente el formulario PDF que contiene datos con códigos de barras utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.com.adobe.idp.Document
utilizando su constructor y pasando el objeto java.io.FileInputStream
.Descodificar los datos del formulario PDF
Descodificar los datos del formulario invocando el método BarcodedFormsServiceClient
del objeto decode
y pasando los siguientes valores:
com.adobe.idp.Document
que contiene el formulario PDF.java.lang.Boolean
que especifica si se descodifica un código de barras PDF417.java.lang.Boolean
que especifica si se descodifica un código de barras de matriz de datos.java.lang.Boolean
que especifica si se descodifica un código de barras de código QR.java.lang.Boolean
que especifica si se descodificará un código de barras de código de barras.java.lang.Boolean
que especifica si se descodifica un código de barras de código 128.java.lang.Boolean
que especifica si se descodifica un código de barras de código 39.java.lang.Boolean
que especifica si se descodifica un código de barras EAN-13.java.lang.Boolean
que especifica si se descodifica un código de barras EAN-8.com.adobe.livecycle.barcodedforms.CharSet
que especifica el valor de codificación del conjunto de caracteres utilizado en el código de barras.El método decode
devuelve un objeto org.w3c.dom.Document
que contiene datos de formulario decodificados.
Convertir los datos en un origen de datos XML
Convierta los datos decodificados en datos XDP o XFDF invocando el método BarcodedFormsServiceClient
del objeto extractToXML
y pasando los siguientes valores:
org.w3c.dom.Document
que contiene datos decodificados (asegúrese de utilizar el valor devuelto del método decode
).com.adobe.livecycle.barcodedforms.Delimiter
que especifica el delimitador de línea. Se recomienda especificar Delimiter.Carriage_Return
.com.adobe.livecycle.barcodedforms.Delimiter
que especifica el delimitador de campo. Por ejemplo, especifique Delimiter.Tab
.com.adobe.livecycle.barcodedforms.XMLFormat
que especifica si se deben convertir los datos del código de barras en datos XML XDP o XFDF. Por ejemplo, especifique XMLFormat.XDP
para convertir los datos a datos XDP.No especifique los mismos valores para los parámetros delimitador de línea y delimitador de campo.
El método extractToXML
devuelve un objeto java.util.List
donde cada elemento es un objeto org.w3c.dom.Document
. Hay un elemento independiente para cada código de barras que se encuentra en el formulario. Es decir, si hay cuatro códigos de barras en el formulario, hay cuatro elementos en el objeto java.util.List
devuelto.
Procesamiento de los datos decodificados
java.util.List
para obtener cada objeto org.w3c.dom.Document
que se encuentre en la lista.org.w3c.dom.Document
en un objeto com.adobe.idp.Document
. (La lógica de aplicación que convierte un objeto org.w3c.dom.Document
en un objeto com.adobe.idp.Document
se muestra en los datos de formulario codificados con barras Decoding utilizando el ejemplo de API de Java).com.adobe.idp.Document
objeto copyToFile
y pasando un objeto File que represente el archivo XML.Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Configuración de las propiedades de conexión
Descodificar datos de formulario utilizando la API de formularios con códigos de barras (servicio web):
Incluir archivos de proyecto
Crear un objeto de API de cliente de formularios con códigos de barras
Utilizando el ensamblado cliente de Microsoft .NET que consume el WSDL del servicio de formularios codificados de barras, cree un objeto BarcodedFormsServiceService
invocando su constructor predeterminado.
Obtener un formulario PDF que contenga datos codificados con barras
BLOB
utilizando su constructor. El objeto BLOB
se utiliza para almacenar un documento PDF que contiene un código de barras.System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF y el modo en que se abre el archivo.System.IO.FileStream
. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad System.IO.FileStream
del objeto Length
.System.IO.FileStream
del objeto Read
y pasando la matriz de bytes, la posición de inicio y la longitud de flujo para leer.BLOB
asignando su propiedad binaryData
con el contenido de la matriz de bytes.Descodificar los datos del formulario PDF
Descodificar los datos del formulario invocando el método BarcodedFormsServiceService
del objeto decode
y pasando los siguientes valores:
BLOB
que contiene el formulario PDF.Boolean
que especifica si se descodifica un código de barras PDF417.Boolean
que especifica si se descodifica un código de barras de matriz de datos.Boolean
que especifica si se descodifica un código de barras de código QR.Boolean
que especifica si se descodificará un código de barras de código de barras.Boolean
que especifica si se descodifica un código de barras de código 128.Bolean
que especifica si se descodifica un código de barras de código 39.Boolean
que especifica si se descodifica un código de barras EAN-13.Boolean
que especifica si se descodifica un código de barras EAN-8.CharSet
que especifica el valor de codificación del conjunto de caracteres utilizado en el código de barras.El método decode
devuelve un valor de cadena que contiene datos de formulario decodificados.
Convertir los datos en un origen de datos XML
Convierta los datos decodificados en datos XDP o XFDF invocando el método BarcodedFormsServiceService
del objeto extractToXML
y pasando los siguientes valores:
decode
).Delimiter
que especifica el delimitador de línea. Se recomienda especificar Delimiter.Carriage_Return
.Delimiter
que especifica el delimitador de campo. Por ejemplo, especifique Delimiter.Tab
.XMLFormat
que especifica si se deben convertir los datos del código de barras en datos XML XDP o XFDF. Por ejemplo, especifique XMLFormat.XDP
para convertir los datos a datos XDP.No especifique los mismos valores para los parámetros delimitador de línea y delimitador de campo.
El método extractToXML
devuelve una matriz Object
donde cada elemento es una instancia BLOB
. Hay un elemento independiente para cada código de barras que se encuentra en el formulario. Es decir, si hay cuatro códigos de barras en el formulario, hay cuatro elementos en la matriz Object
devuelta.
Procesamiento de los datos decodificados
System.IO.FileStream
invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF protegido.BLOB
que el método encryptPDFUsingPassword
devolvió. Rellene la matriz de bytes obteniendo el valor del miembro de datos BLOB
del objeto binaryData
.System.IO.BinaryWriter
invocando su constructor y pasando el objeto System.IO.FileStream
.System.IO.BinaryWriter
del objeto Write
y pasando la matriz de bytes.Consulte también