Show Menu
TEMAS×

Uso de formularios con código de barras

Acerca del servicio de formularios con códigos de barras

El servicio de formularios con códigos de barras 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 formularios con códigos de barras, puede agregar códigos de barras unidimensionales y bidimensionales a formularios PDF 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 con 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 electrónico, fax o mano. Más adelante, puede extraer los datos suministrados por el usuario como parte de un flujo de trabajo automatizado, lo que distribuye 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 .

Descodificación de datos de formulario codificados con barras

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 que los datos se puedan descodificar desde 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 .

Resumen de los pasos

Para descodificar datos de un formulario PDF, lleve a cabo los siguientes pasos:
  1. Incluir archivos de proyecto.
  2. Cree un objeto de API formClient con códigos de barras.
  3. Obtenga un formulario PDF que contenga datos codificados por barras.
  4. Descodificar los datos del formulario PDF.
  5. Convierta los datos a un origen de datos XML.
  6. Procese los datos descodificados.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, asegúrese de incluir los archivos proxy.
Se deben agregar los siguientes archivos JAR a la ruta de clases del proyecto:
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-barcodedforms-client.jar
  • adobe-utilities.jar (obligatorio si AEM Forms se implementa en JBoss)
  • jbossall-client.jar (obligatorio si AEM Forms se implementa en JBoss)
  • xercesImpl.jar (ubicado en <directorio de instalación>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
Si AEM Forms se implementa en un servidor de aplicaciones J2EE compatible que no es 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.
Creación de un objeto API de cliente de formularios con código de barras
Para poder realizar mediante programación una operación de servicio de formularios con códigos de barras, debe crear un cliente de servicio de formularios con códigos de barras. Si utiliza la API de Java, cree un BarcodedFormsServiceClient objeto. Si utiliza la API de servicio web de formularios con códigos de barras, cree un BarcodedFormsServiceService objeto.
Obtener un formulario PDF que contiene 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 una imagen) que contenga un código de barras, puede descodificar los datos. El servicio Barcoded Forms admite los siguientes tipos de códigos de barras:
  • Códigos de barras PDF417.
  • Códigos de barras de la matriz de datos.
  • Códigos de barras QR.
  • Códigos de barras de Codabar.
  • Códigos de barras Código 128.
  • Códigos de barras Código 39.
  • Códigos de barras EAN-13.
  • Códigos de barras EAN-8.
La entrada de conjuntos 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 se especifica 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 la lógica de la aplicación en la aplicación cliente.
Convertir los datos en un origen de datos XML
Después de decodificar 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 convertir los datos 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 los requisitos 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.
El servicio de formularios con códigos de barras no puede descodificar 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 con código de barras mediante la API de Java

Descodificar datos de formulario mediante la API de formularios codificados (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Creación de un objeto API de cliente de formularios con código de barras
    Cree un BarcodedFormsServiceClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Obtener un formulario PDF que contiene datos codificados con barras
    • Cree un java.io.FileInputStream objeto que represente el formulario PDF que contiene datos codificados con barras utilizando su constructor y pasando un valor de cadena que especifique la ubicación del documento PDF.
    • Cree un com.adobe.idp.Document objeto utilizando su constructor y pasando el java.io.FileInputStream objeto.
  4. Descodificar los datos del formulario PDF
    Para descodificar los datos del formulario, invoque el BarcodedFormsServiceClient método del decode objeto y pase los valores siguientes:
    • El com.adobe.idp.Document objeto que contiene el formulario PDF.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras PDF417.
    • Objeto java.lang.Boolean que especifica si se descodifica un código de barras de matriz de datos.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras de código QR.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras de código de barras.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras 128.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras de código 39.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras EAN-13.
    • Un java.lang.Boolean objeto que especifica si se descodifica un código de barras EAN-8.
    • Un valor com.adobe.livecycle.barcodedforms.CharSet de enumeración que especifica el valor de codificación del conjunto de caracteres utilizado en el código de barras. El decode método devuelve un org.w3c.dom.Document objeto que contiene datos de formulario descodificados.
  5. Convertir los datos en un origen de datos XML
    Convierta los datos descodificados en datos XDP o XFDF invocando el BarcodedFormsServiceClient método del extractToXML objeto y pasando los siguientes valores:
    • El org.w3c.dom.Document objeto que contiene datos descodificados (asegúrese de utilizar el valor devuelto por el decode método).
    • Un valor com.adobe.livecycle.barcodedforms.Delimiter de enumeración que especifica el delimitador de línea. Se recomienda especificar Delimiter.Carriage_Return .
    • Un valor com.adobe.livecycle.barcodedforms.Delimiter de enumeración que especifica el delimitador de campo. Por ejemplo, especifique Delimiter.Tab .
    • Un valor com.adobe.livecycle.barcodedforms.XMLFormat de enumeración que especifica si se deben convertir los datos del código de barras en datos XDP o XFDF XML. Por ejemplo, especifique XMLFormat.XDP para convertir los datos en datos XDP.
    No especifique los mismos valores para los parámetros delimitador de línea y delimitador de campo.
    El extractToXML método devuelve un java.util.List objeto en el que cada elemento es un org.w3c.dom.Document objeto. Hay un elemento independiente para cada código de barras ubicado en el formulario. Es decir, si hay cuatro códigos de barras en el formulario, hay cuatro elementos en el java.util.List objeto devuelto.
  6. Procesar los datos descodificados
    • Repita el java.util.List objeto para obtener cada org.w3c.dom.Document objeto ubicado en la lista.
    • Para cada elemento de la lista, convierta el org.w3c.dom.Document objeto en un com.adobe.idp.Document objeto. (La lógica de la aplicación que convierte un org.w3c.dom.Document objeto en un com.adobe.idp.Document objeto se muestra en los datos de formulario codificados con código de barras Decoding mediante el ejemplo de la API de Java).
    • Guarde los datos XML como archivo XML invocando el com.adobe.idp.Document objeto copyToFile y pasando un objeto File que represente el archivo XML.
Consulte también

Descodificar datos de formulario con código de barras mediante la API de servicio Web

Descodificar datos de formulario mediante la API de formularios codificados (servicio Web):
  1. Incluir archivos de proyecto
  2. Creación de un objeto API de cliente de formularios con código de barras
    Mediante el ensamblado de cliente de Microsoft .NET que utiliza el WSDL del servicio de formularios con códigos de barras, cree un BarcodedFormsServiceService objeto invocando su constructor predeterminado.
  3. Obtener un formulario PDF que contiene datos codificados con barras
    • Cree un BLOB objeto con su constructor. El BLOB objeto se utiliza para almacenar un documento PDF que contiene un código de barras.
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que representa la ubicación del archivo del documento PDF y el modo en que se abre el archivo.
    • Cree una matriz de bytes que almacene el contenido del System.IO.FileStream objeto. Puede determinar el tamaño de la matriz de bytes obteniendo la System.IO.FileStream propiedad del Length objeto.
    • Rellene la matriz de bytes con datos de flujo invocando el System.IO.FileStream método Read del objeto y pasando la matriz de bytes, la posición inicial y la longitud de flujo que se va a leer.
    • Rellene el BLOB objeto asignando su binaryData propiedad con el contenido de la matriz de bytes.
  4. Descodificar los datos del formulario PDF
    Para descodificar los datos del formulario, invoque el BarcodedFormsServiceService método del decode objeto y pase los valores siguientes:
    • El BLOB objeto que contiene el formulario PDF.
    • Un Boolean objeto que especifica si se descodifica un código de barras PDF417.
    • Objeto Boolean que especifica si se descodifica un código de barras de matriz de datos.
    • Un Boolean objeto que especifica si se descodifica un código de barras de código QR.
    • Un Boolean objeto que especifica si se descodifica un código de barras de código de barras.
    • Un Boolean objeto que especifica si se descodifica un código de barras 128.
    • Un Bolean objeto que especifica si se descodifica un código de barras de código 39.
    • Un Boolean objeto que especifica si se descodifica un código de barras EAN-13.
    • Un Boolean objeto que especifica si se descodifica un código de barras EAN-8.
    • Un valor CharSet de enumeración que especifica el valor de codificación del conjunto de caracteres utilizado en el código de barras. El decode método devuelve un valor de cadena que contiene datos de formulario descodificados.
  5. Convertir los datos en un origen de datos XML
    Convierta los datos descodificados en datos XDP o XFDF invocando el BarcodedFormsServiceService método del extractToXML objeto y pasando los siguientes valores:
    • Un valor de cadena que contiene datos descodificados (asegúrese de utilizar el valor devuelto por el decode método).
    • Un valor Delimiter de enumeración que especifica el delimitador de línea. Se recomienda especificar Delimiter.Carriage_Return .
    • Un valor Delimiter de enumeración que especifica el delimitador de campo. Por ejemplo, especifique Delimiter.Tab .
    • Un valor XMLFormat de enumeración que especifica si se deben convertir los datos del código de barras en datos XDP o XFDF XML. Por ejemplo, especifique XMLFormat.XDP para convertir los datos en datos XDP.
    No especifique los mismos valores para los parámetros delimitador de línea y delimitador de campo.
    El extractToXML método devuelve una Object matriz donde cada elemento es una BLOB instancia. Hay un elemento independiente para cada código de barras ubicado en el formulario. Es decir, si hay cuatro códigos de barras en el formulario, hay cuatro elementos en la Object matriz devuelta.
  6. Procesar los datos descodificados
    • Cree un System.IO.FileStream objeto invocando su constructor y pasando un valor de cadena que represente la ubicación del archivo del documento PDF protegido.
    • Cree una matriz de bytes que almacene el contenido de datos del BLOB objeto devuelto por el encryptPDFUsingPassword método. Rellene la matriz de bytes obteniendo el valor del miembro de BLOB datos del binaryData objeto.
    • Cree un System.IO.BinaryWriter objeto invocando su constructor y pasando el System.IO.FileStream objeto.
    • Escriba el contenido de la matriz de bytes en un archivo PDF invocando el System.IO.BinaryWriter método Write del objeto y pasando la matriz de bytes.
Consulte también