Trabalhar com formulários com códigos de barras working-with-barcoded-forms
Exemplos e exemplos neste documento são somente para AEM Forms no ambiente JEE.
Sobre o serviço de formulários com código de barras about-the-barcoded-forms-service
O serviço de formulários com código de barras automatiza a captura de dados de formulários de preenchimento e impressão e integra as informações capturadas aos principais sistemas de TI de uma organização.
Usando o serviço de formulários com código de barras, é possível adicionar códigos de barras unidimensionais e bidimensionais aos PDF forms interativos. Em seguida, você pode publicar os formulários com código de barras em um site ou distribuí-los por email ou CD. Quando um usuário preenche um formulário com código de barras usando o Adobe Reader, o Acrobat Professional ou o Acrobat Standard, o código de barras é atualizado automaticamente para codificar os dados de formulário fornecidos pelo usuário. O usuário pode enviar o formulário eletronicamente ou imprimi-lo em papel e enviá-lo por correio, fax ou mão. Posteriormente, você pode extrair os dados fornecidos pelo usuário como parte de um fluxo de trabalho automatizado, roteando os dados entre processos de aprovação e sistemas de negócios.
Para obter mais informações sobre o serviço de formulários com código de barras, consulte Referência de serviços para o AEM Forms.
Decodificação de dados de formulário com código de barras decoding-barcoded-form-data
Você pode usar a API do serviço de formulários com código de barras para decodificar dados de um formulário PDF ou imagem que contenha um código de barras. Decodificar dados do formulário significa extrair dados que estão no código de barras. Antes que os dados possam ser decodificados de um formulário (ou imagem) PDF, um usuário precisa preencher o formulário com dados.
Resumo das etapas summary-of-steps
Para decodificar dados de um formulário PDF, execute as seguintes etapas:
- Incluir arquivos de projeto.
- Crie um objeto de API formsClient com código de barras.
- Obtenha um formulário PDF que contenha dados com código de barras.
- Decodifique os dados do formulário PDF.
- Converta os dados em uma fonte de dados XML.
- Processe os dados decodificados.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação cliente usando Java, inclua os arquivos JAR necessários. Se você estiver usando serviços da Web, certifique-se de incluir os arquivos proxy.
Os seguintes arquivos JAR devem ser adicionados ao classpath do projeto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-barcodedforms-client.jar
- adobe-utilities.jar (obrigatório se o AEM Forms for implantado no JBoss)
- jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss)
- xercesImpl.jar (em <diretório de instalação>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
Se o AEM Forms for disponibilizado em um servidor de aplicativos J2EE compatível que não seja JBOSS, você deverá substituir adobe-utilities.jar e jbossall-client.jar por arquivos JAR específicos para o servidor de aplicativos J2EE no qual o AEM Forms é disponibilizado. Para obter informações sobre a localização de todos os arquivos JAR do AEM Forms, consulte Incluindo arquivos da biblioteca Java do AEM Forms.
Criar um objeto de API do Cliente de formulários com código de barras
Antes de executar programaticamente uma operação do serviço de formulários com código de barras, você deve criar um cliente de serviço do Forms com código de barras. Se você estiver usando a API Java, crie um objeto BarcodedFormsServiceClient
. Se você estiver usando a API do serviço Web de formulários com código de barras, crie um objeto BarcodedFormsServiceService
.
Obter um formulário PDF que contenha dados com código de barras
Obtenha um formulário PDF que contenha um código de barras que tenha sido preenchido com dados do usuário.
Decodificar os dados do formulário PDF
Depois de obter um formulário (ou imagem) PDF que contém um código de barras, você pode decodificar os dados. O serviço Forms com código de barras é compatível com os seguintes tipos de códigos de barras:
- códigos de barras PDF417.
- Códigos de barras da matriz de dados.
- Códigos de barras do código 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.
A entrada do conjunto de caracteres como hexadecimal na API de decodificação implica que o conteúdo do código de barras é codificado como uma string hexadecimal. Por exemplo, se UTF-8 for especificado como a codificação de caracteres no formulário e Hex for especificado na operação de decodificação, o conteúdo do código de barras será codificado como uma cadeia de caracteres Hex no elemento < xb:content
> na saída decodificada. É possível converter esse valor hexadecimal para obter o conteúdo original criando a lógica do aplicativo no aplicativo cliente.
Converter os dados em uma fonte de dados XML
Após decodificar os dados do formulário, é possível convertê-los em dados XDP ou XFDF. Por exemplo, suponha que você deseja importar os dados para outro formulário. Para importar os dados em um formulário XFA, é necessário converter os dados em dados XDP. Para obter informações, consulte Importando dados do formulário.
Processar os dados decodificados
Você pode processar os dados convertidos para atender aos requisitos da sua empresa. Por exemplo, depois de decodificar e converter os dados, você pode salvá-los em um arquivo, armazená-los em um banco de dados corporativo, preencher outro formulário e assim por diante. Esta seção discute como salvar os dados convertidos em um arquivo XML.
Consulte também
Decodificar dados de formulário com código de barras usando a API do Java
Decodificar dados de formulário com código de barras usando a API do serviço Web
Decodificar dados de formulário com código de barras usando a API do Java decode-barcoded-form-data-using-the-java-api
Decodifique dados de formulário usando a API de formulários com código de barras (Java):
-
Incluir arquivos de projeto
Inclua arquivos JAR do cliente no caminho de classe do projeto Java.
-
Criar um objeto de API do cliente de formulários com código de barras
Crie um objeto
BarcodedFormsServiceClient
usando seu construtor e transmitindo um objetoServiceClientFactory
que contenha propriedades de conexão. -
Obtenha um formulário PDF que contenha dados com código de barras
- Crie um objeto
java.io.FileInputStream
que represente o formulário PDF que contém dados com código de barras usando seu construtor e transmitindo um valor de cadeia de caracteres que especifique o local do documento PDF. - Crie um objeto
com.adobe.idp.Document
usando seu construtor e transmitindo o objetojava.io.FileInputStream
.
- Crie um objeto
-
Decodifique os dados do formulário PDF
Decodifique os dados do formulário chamando o método
decode
do objetoBarcodedFormsServiceClient
e transmitindo os seguintes valores:- O objeto
com.adobe.idp.Document
que contém a forma PDF. - Um objeto
java.lang.Boolean
que especifica se um código de barras PDF417 deve ser decodificado. - Um objeto
java.lang.Boolean
que especifica se um código de barras de matriz de dados deve ser decodificado. - Um objeto
java.lang.Boolean
que especifica se um código de barras QR deve ser decodificado. - Um objeto
java.lang.Boolean
que especifica se deve ser decodificado um código de barras de barra de código. - Um objeto
java.lang.Boolean
que especifica se um código de barras 128 deve ser decodificado. - Um objeto
java.lang.Boolean
que especifica se um código de barras 39 deve ser decodificado. - Um objeto
java.lang.Boolean
que especifica se um código de barras EAN-13 deve ser decodificado. - Um objeto
java.lang.Boolean
que especifica se um código de barras EAN-8 deve ser decodificado. - Um valor de enumeração
com.adobe.livecycle.barcodedforms.CharSet
que especifica o valor de codificação do conjunto de caracteres usado no código de barras.
O método
decode
retorna um objetoorg.w3c.dom.Document
que contém dados de formulário decodificados. - O objeto
-
Converter os dados em uma fonte de dados XML
Converta os dados decodificados em dados XDP ou XFDF invocando o método
extractToXML
do objetoBarcodedFormsServiceClient
e transmitindo os seguintes valores:- O objeto
org.w3c.dom.Document
que contém dados decodificados (certifique-se de usar o valor de retorno do métododecode
). - Um valor de enumeração
com.adobe.livecycle.barcodedforms.Delimiter
que especifica o delimitador de linha. É recomendável especificarDelimiter.Carriage_Return
. - Um valor de enumeração
com.adobe.livecycle.barcodedforms.Delimiter
que especifica o delimitador de campo. Por exemplo, especifiqueDelimiter.Tab
. - Um valor de enumeração
com.adobe.livecycle.barcodedforms.XMLFormat
que especifica se os dados de código de barras devem ser convertidos em dados XML XDP ou XFDF. Por exemplo, especifiqueXMLFormat.XDP
para converter os dados em dados XDP.
note note NOTE Não especifique os mesmos valores para os parâmetros delimitador de linha e delimitador de campo. O método
extractToXML
retorna um objetojava.util.List
em que cada elemento é um objetoorg.w3c.dom.Document
. Há um elemento separado para cada código de barras localizado no formulário. Ou seja, se houver quatro códigos de barras no formulário, haverá quatro elementos no objetojava.util.List
retornado. - O objeto
-
Processar os dados decodificados
- Repita o objeto
java.util.List
para obter cada objetoorg.w3c.dom.Document
que esteja na lista. - Para cada elemento na lista, converta o objeto
org.w3c.dom.Document
em um objetocom.adobe.idp.Document
. (A lógica do aplicativo que converte um objetoorg.w3c.dom.Document
em um objetocom.adobe.idp.Document
é mostrada na Decodificação de dados de formulário com código de barras usando o exemplo da API Java). - Salve os dados XML como um arquivo XML invocando o
copyToFile
do objetocom.adobe.idp.Document
e transmitindo um objeto File que representa o arquivo XML.
- Repita o objeto
Consulte também
Decodificar dados de formulário com código de barras usando a API do serviço Web decode-barcoded-form-data-using-the-web-service-api
Decodifique dados de formulário usando a API de formulários com código de barras (serviço da Web):
-
Incluir arquivos de projeto
- Crie um assembly cliente Microsoft .NET que consuma o WSDL do serviço de formulários com código de barras. Para obter informações, consulte Chamar o AEM Forms usando a codificação Base64.
- Referencie o assembly do cliente Microsoft .NET. Para obter informações, consulte "Referenciando o assembly do cliente .NET" em Chamando o AEM Forms usando a codificação Base64.
-
Criar um objeto de API do cliente de formulários com código de barras
Usando o assembly do cliente Microsoft .NET que consome o WSDL do serviço de formulários com código de barras, crie um objeto
BarcodedFormsServiceService
invocando seu construtor padrão. -
Obtenha um formulário PDF que contenha dados com código de barras
- Crie um objeto
BLOB
usando seu construtor. O objetoBLOB
é usado para armazenar um documento PDF que contém um código de barras. - Crie um objeto
System.IO.FileStream
chamando seu construtor e transmitindo um valor de cadeia de caracteres que representa o local do arquivo do documento PDF e o modo no qual o arquivo será aberto. - Crie uma matriz de bytes que armazene o conteúdo do objeto
System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedadeLength
do objetoSystem.IO.FileStream
. - Preencha a matriz de bytes com dados de fluxo invocando o método
Read
do objetoSystem.IO.FileStream
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura. - Preencha o objeto
BLOB
atribuindo sua propriedadebinaryData
com o conteúdo da matriz de bytes.
- Crie um objeto
-
Decodifique os dados do formulário PDF
Decodifique os dados do formulário chamando o método
decode
do objetoBarcodedFormsServiceService
e transmitindo os seguintes valores:- O objeto
BLOB
que contém a forma PDF. - Um objeto
Boolean
que especifica se um código de barras PDF417 deve ser decodificado. - Um objeto
Boolean
que especifica se um código de barras de matriz de dados deve ser decodificado. - Um objeto
Boolean
que especifica se um código de barras QR deve ser decodificado. - Um objeto
Boolean
que especifica se deve ser decodificado um código de barras de barra de código. - Um objeto
Boolean
que especifica se um código de barras 128 deve ser decodificado. - Um objeto
Bolean
que especifica se um código de barras 39 deve ser decodificado. - Um objeto
Boolean
que especifica se um código de barras EAN-13 deve ser decodificado. - Um objeto
Boolean
que especifica se um código de barras EAN-8 deve ser decodificado. - Um valor de enumeração
CharSet
que especifica o valor de codificação do conjunto de caracteres usado no código de barras.
O método
decode
retorna um valor de cadeia de caracteres que contém dados de formulário decodificados. - O objeto
-
Converter os dados em uma fonte de dados XML
Converta os dados decodificados em dados XDP ou XFDF invocando o método
extractToXML
do objetoBarcodedFormsServiceService
e transmitindo os seguintes valores:- Um valor de cadeia de caracteres que contém dados decodificados (certifique-se de usar o valor de retorno do método
decode
). - Um valor de enumeração
Delimiter
que especifica o delimitador de linha. É recomendável especificarDelimiter.Carriage_Return
. - Um valor de enumeração
Delimiter
que especifica o delimitador de campo. Por exemplo, especifiqueDelimiter.Tab
. - Um valor de enumeração
XMLFormat
que especifica se os dados de código de barras devem ser convertidos em dados XML XDP ou XFDF. Por exemplo, especifiqueXMLFormat.XDP
para converter os dados em dados XDP.
note note NOTE Não especifique os mesmos valores para os parâmetros delimitador de linha e delimitador de campo. O método
extractToXML
retorna uma matrizObject
em que cada elemento é uma instânciaBLOB
. Há um elemento separado para cada código de barras localizado no formulário. Ou seja, se houver quatro códigos de barras no formulário, então haverá quatro elementos na matrizObject
retornada. - Um valor de cadeia de caracteres que contém dados decodificados (certifique-se de usar o valor de retorno do método
-
Processar os dados decodificados
- Crie um objeto
System.IO.FileStream
chamando seu construtor e transmitindo um valor de cadeia de caracteres que representa o local do arquivo do documento PDF seguro. - Crie uma matriz de bytes que armazene o conteúdo de dados do objeto
BLOB
retornado pelo métodoencryptPDFUsingPassword
. Popular a matriz de bytes obtendo o valor do membro de dadosbinaryData
do objetoBLOB
. - Crie um objeto
System.IO.BinaryWriter
invocando seu construtor e transmitindo o objetoSystem.IO.FileStream
. - Grave o conteúdo da matriz de bytes em um arquivo PDF, chamando o método
Write
do objetoSystem.IO.BinaryWriter
e transmitindo a matriz de bytes.
- Crie um objeto
Consulte também
Chamada de AEM Forms usando codificação Base64