Descodificación de datos de formulario con códigos de barras
Puede utilizar la API del servicio de formularios con códigos de barras para descodificar datos de un formulario de PDF o de 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 descodificar los datos de un formulario (o imagen) de PDF, un usuario debe rellenar el formulario con datos.
Resumen de los pasos
Para descodificar datos de un formulario de PDF, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de API formsClient con códigos de barras.
- Obtenga un formulario de PDF que contenga datos con códigos de barras.
- Descodificar los datos del formulario de PDF.
- Convertir los datos en una fuente de datos XML.
- Procese los datos descodificados.
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 agregarse a la ruta de clase del proyecto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-barcodedforms-client.jar
- adobe-utilities.jar (obligatorio si AEM Forms está implementado en JBoss)
- jbossall-client.jar (requerido si AEM Forms está implementado en JBoss)
- xercesImpl.jar (en <directorio de instalación>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\third-party)
Si AEM Forms se implementa en un servidor de aplicaciones J2EE compatible que no sea JBOSS, debe reemplazar adobe-utilities.jar y jbossall-client.jar por archivos JAR específicos del servidor de aplicaciones J2EE en el que está implementado AEM Forms. Para obtener información sobre la ubicación de todos los archivos JAR de AEM Forms, consulte Incluyendo los archivos de la biblioteca Java de AEM Forms.
Crear un objeto de API de cliente de formularios con códigos de barras
Para poder realizar mediante programación una operación de servicio de Forms con códigos de barras, debe crear un cliente de servicio de Forms con códigos de barras. Si está usando la API de Java, cree un objeto BarcodedFormsServiceClient
. Si utiliza la API del servicio web de formularios con códigos de barras, cree un objeto BarcodedFormsServiceService
.
Obtener un formulario de PDF que contenga datos con códigos de barras
Obtenga un formulario de PDF que contenga un código de barras que se haya rellenado con datos de usuario.
Descodificar los datos del formulario de PDF
Después de obtener un formulario (o una imagen) de PDF que contiene un código de barras, puede descodificar los datos. El servicio de Forms con códigos de barras es compatible con los siguientes tipos de códigos de barras:
- Códigos de barras PDF 417.
- Códigos de barras de matriz de datos.
- Códigos de barras QR.
- Códigos de barras de Codabar.
- Código 128 códigos de barras.
- Código 39 códigos de barras.
- Códigos de barras EAN-13.
- Códigos de barras EAN-8.
La entrada de conjunto de caracteres como hexadecimal en la API de descodificación implica que el contenido del código de barras se codifica como una cadena hexadecimal. Por ejemplo, si se especifica UTF-8 como codificación de caracteres en el formulario y Hex 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 hexadecimal para obtener el contenido original creando lógica de aplicación en la aplicación cliente.
Convertir los datos en una fuente de datos XML
Después de descodificar los datos del 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.
Procesar los datos descodificados
Puede procesar los datos convertidos para satisfacer sus necesidades comerciales. Por ejemplo, después de descodificar y convertir los datos, puede guardarlos en un archivo, almacenarlos 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.
Descodificar datos de formulario con códigos de barras mediante la API de Java
Descodificar datos de formulario mediante la API de formularios con códigos de barras (Java):
-
Incluir archivos de proyecto
Incluya archivos JAR de cliente en la ruta de clase del 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 objetoServiceClientFactory
que contenga propiedades de conexión. -
Obtenga un formulario de PDF que contenga datos con códigos de barras
- Cree un objeto
java.io.FileInputStream
que represente el formulario de PDF que contiene datos con códigos de barras utilizando su constructor y pasando un valor de cadena que especifica la ubicación del documento de PDF. - Cree un objeto
com.adobe.idp.Document
utilizando su constructor y pasando el objetojava.io.FileInputStream
.
- Cree un objeto
-
Descodificar los datos del formulario de PDF
Descodificar los datos del formulario invocando el método
decode
del objetoBarcodedFormsServiceClient
y pasando los siguientes valores:- El objeto
com.adobe.idp.Document
que contiene el formulario de PDF. - Un objeto
java.lang.Boolean
que especifica si se va a descodificar un código de barras PDF 417. - Un objeto
java.lang.Boolean
que especifica si se debe descodificar un código de barras de matriz de datos. - Un objeto
java.lang.Boolean
que especifica si se debe descodificar un código de barras de código QR. - Un objeto
java.lang.Boolean
que especifica si se va a descodificar un código de barras de la barra de códigos. - Un objeto
java.lang.Boolean
que especifica si se debe descodificar un código de barras 128. - Un objeto
java.lang.Boolean
que especifica si se debe descodificar un código de barras 39. - Un objeto
java.lang.Boolean
que especifica si se debe descodificar un código de barras EAN-13. - Un objeto
java.lang.Boolean
que especifica si se debe descodificar un código de barras EAN-8. - Valor de enumeración
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 objetoorg.w3c.dom.Document
que contiene datos de formulario descodificados. - El objeto
-
Convertir los datos en una fuente de datos XML
Convierta los datos descodificados en datos XDP o XFDF invocando el método
extractToXML
del objetoBarcodedFormsServiceClient
y pasando los siguientes valores:- El objeto
org.w3c.dom.Document
que contiene datos descodificados (asegúrese de utilizar el valor devuelto del métododecode
). - Valor de enumeración
com.adobe.livecycle.barcodedforms.Delimiter
que especifica el delimitador de línea. Se recomienda especificarDelimiter.Carriage_Return
. - Valor de enumeración
com.adobe.livecycle.barcodedforms.Delimiter
que especifica el delimitador de campo. Por ejemplo, especifiqueDelimiter.Tab
. - Valor de enumeración
com.adobe.livecycle.barcodedforms.XMLFormat
que especifica si se convierten los datos de código de barras en datos XML XDP o XFDF. Por ejemplo, especifiqueXMLFormat.XDP
para convertir los datos en datos XDP.
NOTA
No especifique los mismos valores para los parámetros de delimitador de línea y delimitador de campo.El método
extractToXML
devuelve un objetojava.util.List
donde cada elemento es un objetoorg.w3c.dom.Document
. Hay un elemento independiente para cada código de barras ubicado en el formulario. Es decir, si el formulario tiene cuatro códigos de barras, el objetojava.util.List
devuelto contiene cuatro elementos. - El objeto
-
Procesamiento de los datos descodificados
- Recorra en iteración el objeto
java.util.List
para obtener cada objetoorg.w3c.dom.Document
que se encuentra en la lista. - Para cada elemento de la lista, convierta el objeto
org.w3c.dom.Document
en un objetocom.adobe.idp.Document
. (La lógica de la aplicación que convierte un objetoorg.w3c.dom.Document
en un objetocom.adobe.idp.Document
se muestra en el ejemplo de la API de Java Descodificación de datos de formulario con códigos de barras). - Guarde los datos XML como un archivo XML invocando
copyToFile
del objetocom.adobe.idp.Document
y pasando un objeto File que represente el archivo XML.
- Recorra en iteración el objeto