Trabalho com formulários com códigos de barras working-with-barcoded-forms
Sobre o serviço de formulários com códigos de barras about-the-barcoded-forms-service
O serviço de formulários com códigos de barras automatiza a captura de dados de formulários preenchidos e impressos e integra informações capturadas nos principais sistemas de TI de uma organização.
Usando o serviço de formulários com códigos de barras, é possível adicionar códigos de barras unidimensionais e bidimensionais a PDF forms interativos. Em seguida, você pode publicar os formulários com códigos de barras em um site ou distribuí-los por email ou CD. Quando um usuário preenche um formulário com códigos de barras usando o Adobe Reader, Acrobat Professional ou 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 email, fax ou à mão. Posteriormente, é possível 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 comerciais.
Para obter mais informações sobre o serviço de formulários com códigos 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ódigos de barras para decodificar dados de um formulário PDF ou de uma imagem que contenha um código de barras. Decodificar dados de formulário significa extrair dados localizados no código de barras. Para que os dados possam ser decodificados em um formulário PDF (ou imagem), o usuário precisa preencher o formulário com dados.
Resumo das etapas summary-of-steps
Para decodificar os dados de um formulário PDF, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Crie um objeto da API do cliente formsClient com códigos de barras.
- Obtenha um formulário PDF que contenha dados com códigos de barras.
- Decode os dados do formulário PDF.
- Converta os dados em uma fonte de dados XML.
- Processar os dados decodificados.
Incluir arquivos de projeto
Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando um aplicativo 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 seu projeto:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-barcodedforms-client.jar
- adobe-utilities.jar (obrigatório se o AEM Forms estiver implantado no JBoss)
- jbossall-client.jar (obrigatório se o AEM Forms for implantado no JBoss)
- xercesImpl.jar (localizado em <install directory="">/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
Se o AEM Forms for implantado em um servidor de aplicativos J2EE compatível que não seja JBOSS, será necessário substituir adobe-utilities.jar e jbossall-client.jar por arquivos JAR específicos do servidor de aplicativos J2EE no qual o AEM Forms é implantado. Para obter informações sobre a localização de todos os arquivos AEM Forms JAR, consulte Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um objeto de API do cliente de formulários com códigos de barras
Antes de executar programaticamente uma operação de serviço de formulários com códigos de barras, é necessário criar um cliente de serviço Forms com códigos de barras. Se estiver usando a API do Java, crie um BarcodedFormsServiceClient
objeto. Se estiver usando a API do serviço da Web de formulários com códigos de barras, crie um BarcodedFormsServiceService
objeto.
Obter um formulário PDF que contenha dados com códigos de barras
Você deve obter 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
Após obter um formulário PDF (ou imagem) contendo um código de barras, é possível decodificar os dados. O serviço Forms com códigos de barras oferece suporte para 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 Codabar.
- Códigos de barras do código 128.
- Códigos de barras do código 39.
- 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 sequência de caracteres hexadecimal. Por exemplo, se UTF-8 for especificado como a Codificação de caractere 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 string hexadecimal no < xb:content
> na saída decodificada. Você pode 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 para um formulário XFA, é necessário converter os dados em dados XDP. Para obter mais informações, consulte Importação de dados de formulário.
Processar os dados decodificados
Você pode processar os dados convertidos para atender às suas necessidades de negócios. Por exemplo, após decodificar e converter os dados, é possível 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 como um arquivo XML.
Consulte também
Decodificar dados de formulário com código de barras usando a API Java
Decodificar dados de formulário com código de barras usando a API do serviço da Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Decodificar dados de formulário com código de barras usando a API Java decode-barcoded-form-data-using-the-java-api
Decode dados de formulário usando a API de formulários com códigos de barras (Java):
-
Incluir arquivos de projeto
Inclua arquivos JAR do cliente no caminho da classe do seu projeto Java.
-
Criar um objeto de API do cliente de formulários com códigos de barras
Crie um
BarcodedFormsServiceClient
usando seu construtor e transmitindo umServiceClientFactory
objeto que contém propriedades de conexão. -
Obter um formulário PDF que contenha dados com códigos de barras
- Crie um
java.io.FileInputStream
objeto que representa o formulário PDF que contém dados com códigos de barras usando seu construtor e passando um valor de string que especifica o local do documento PDF. - Crie um
com.adobe.idp.Document
usando seu construtor e passando ojava.io.FileInputStream
objeto.
- Crie um
-
Decodificar os dados do formulário PDF
Decode os dados do formulário chamando a função
BarcodedFormsServiceClient
do objetodecode
e transmitindo os seguintes valores:- O
com.adobe.idp.Document
objeto que contém o formulário PDF. - A
java.lang.Boolean
que especifica se um código de barras PDF417 deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras da matriz de dados deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras QR deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras de codabar deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras 128 deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras 39 deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras EAN-13 deve ser decodificado. - A
java.lang.Boolean
que especifica se um código de barras EAN-8 deve ser decodificado. - A
com.adobe.livecycle.barcodedforms.CharSet
valor de enumeração que especifica o valor de codificação do conjunto de caracteres usado no código de barras.
O
decode
retorna um métodoorg.w3c.dom.Document
objeto que contém dados de formulário decodificados. - O
-
Converter os dados em uma fonte de dados XML
Converta os dados decodificados em dados XDP ou XFDF chamando o
BarcodedFormsServiceClient
do objetoextractToXML
e transmitindo os seguintes valores:- O
org.w3c.dom.Document
objeto que contém dados decodificados (certifique-se de usar a variáveldecode
valor de retorno do método). - A
com.adobe.livecycle.barcodedforms.Delimiter
valor de enumeração que especifica o delimitador de linha. É recomendável especificarDelimiter.Carriage_Return
. - A
com.adobe.livecycle.barcodedforms.Delimiter
valor de enumeração que especifica o delimitador de campo. Por exemplo, especifiqueDelimiter.Tab
. - A
com.adobe.livecycle.barcodedforms.XMLFormat
valor de enumeração que especifica se os dados do 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
extractToXML
método retorna umjava.util.List
objeto no qual cada elemento é umorg.w3c.dom.Document
objeto. 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 no formulário retornadojava.util.List
objeto. - O
-
Processar os dados decodificados
- Iterar por meio do
java.util.List
objeto para obter cadaorg.w3c.dom.Document
objeto localizado na lista. - Para cada elemento na lista, converta o
org.w3c.dom.Document
para umcom.adobe.idp.Document
objeto. (A lógica do aplicativo que converte umaorg.w3c.dom.Document
em umcom.adobe.idp.Document
é mostrado em Decoding barcoded form data using the Java API example). - Salve os dados XML como um arquivo XML chamando a variável
com.adobe.idp.Document
do objetocopyToFile
e transmitindo um objeto File que representa o arquivo XML.
- Iterar por meio do
Consulte também
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Decodificar dados de formulário com código de barras usando a API do serviço da Web decode-barcoded-form-data-using-the-web-service-api
Decode dados de formulário usando a API de formulários com códigos de barras (serviço da Web):
-
Incluir arquivos de projeto
- Crie um conjunto de clientes Microsoft .NET que consuma o WSDL do serviço de formulários com códigos de barras. Para obter mais informações, consulte Chamada de AEM Forms usando codificação Base64.
- Faça referência ao assembly do cliente Microsoft .NET. Para obter informações, consulte "Fazendo referência ao assembly do cliente .NET" em Chamada de AEM Forms usando codificação Base64.
-
Criar um objeto de API do cliente de formulários com códigos de barras
Usando o conjunto de clientes Microsoft .NET que consome o WSDL do serviço de formulários com códigos de barras, crie um
BarcodedFormsServiceService
chamando seu construtor padrão. -
Obter um formulário PDF que contenha dados com códigos de barras
- Crie um
BLOB
usando seu construtor. OBLOB
é usado para armazenar um documento PDF que contém um código de barras. - Crie um
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento PDF e o modo no qual o arquivo deve ser aberto. - Crie uma matriz de bytes que armazene o conteúdo da variável
System.IO.FileStream
objeto. Você pode determinar o tamanho da matriz de bytes obtendo a variávelSystem.IO.FileStream
do objetoLength
propriedade. - Preencha a matriz de bytes com dados de fluxo chamando a variável
System.IO.FileStream
do objetoRead
e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido. - Preencha o
BLOB
ao atribuir seubinaryData
com o conteúdo da matriz de bytes.
- Crie um
-
Decodificar os dados do formulário PDF
Decode os dados do formulário chamando a função
BarcodedFormsServiceService
do objetodecode
e transmitindo os seguintes valores:- O
BLOB
objeto que contém o formulário PDF. - A
Boolean
que especifica se um código de barras PDF417 deve ser decodificado. - A
Boolean
que especifica se um código de barras da matriz de dados deve ser decodificado. - A
Boolean
que especifica se um código de barras QR deve ser decodificado. - A
Boolean
que especifica se um código de barras de codabar deve ser decodificado. - A
Boolean
que especifica se um código de barras 128 deve ser decodificado. - A
Bolean
que especifica se um código de barras 39 deve ser decodificado. - A
Boolean
que especifica se um código de barras EAN-13 deve ser decodificado. - A
Boolean
que especifica se um código de barras EAN-8 deve ser decodificado. - A
CharSet
valor de enumeração que especifica o valor de codificação do conjunto de caracteres usado no código de barras.
O
decode
retorna um valor de string que contém dados de formulário decodificados. - O
-
Converter os dados em uma fonte de dados XML
Converta os dados decodificados em dados XDP ou XFDF chamando o
BarcodedFormsServiceService
do objetoextractToXML
e transmitindo os seguintes valores:- Um valor de string que contém dados decodificados (certifique-se de usar a variável
decode
valor de retorno do método). - A
Delimiter
valor de enumeração que especifica o delimitador de linha. É recomendável especificarDelimiter.Carriage_Return
. - A
Delimiter
valor de enumeração que especifica o delimitador de campo. Por exemplo, especifiqueDelimiter.Tab
. - A
XMLFormat
valor de enumeração que especifica se os dados do 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
extractToXML
retorna um métodoObject
matriz em que cada elemento é umBLOB
instância. 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 no formulário retornadoObject
matriz. - Um valor de string que contém dados decodificados (certifique-se de usar a variável
-
Processar os dados decodificados
- Crie um
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do documento de PDF seguro. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOB
objeto retornado peloencryptPDFUsingPassword
método . Preencha a matriz de bytes obtendo o valor da variávelBLOB
do objetobinaryData
membro de dados. - Crie um
System.IO.BinaryWriter
chamando seu construtor e passando oSystem.IO.FileStream
objeto. - Escreva o conteúdo da matriz de bytes em um arquivo PDF chamando o
System.IO.BinaryWriter
do objetoWrite
e transmitindo a matriz de bytes.
- Crie um
Consulte também
Chamada de AEM Forms usando codificação Base64