Importação e exportação de dados importing-and-exporting-data
Sobre o serviço de integração de dados de formulário about-the-form-data-integration-service
O serviço de Integração de dados de formulário pode importar dados para um formulário PDF e exportar dados de um formulário PDF. As operações de importação e exportação são compatíveis com dois tipos de PDF forms:
- Um formulário Acrobat (criado no Acrobat) é um documento PDF que contém campos de formulário.
- Um formulário Adobe XML (criado no Designer) é um documento PDF que está em conformidade com o XML Adobe XML Forms Architecture (XFA).
Os dados do formulário podem existir em um dos seguintes formatos, dependendo do tipo de formulário PDF:
- Um arquivo XFDF, que é uma versão XML do formato de dados de formulário Acrobat.
- Um arquivo XDP, que é um arquivo XML que contém definições de campos de formulário. Ele também pode conter dados de campos de formulário e um arquivo PDF incorporado. Um arquivo XDP gerado pelo Designer só poderá ser usado se ele tiver um documento de PDF codificado em base 64 incorporado.
Você pode realizar essas tarefas usando o serviço de Integração de dados de formulário :
- Importe dados para o PDF forms. Para obter mais informações, consulte Importação de dados de formulário.
- Exportar dados do PDF forms. Para obter mais informações, consulte Exportar dados de formulário.
Importação de dados de formulário importing-form-data
É possível importar dados de formulário para o PDF forms interativo usando o serviço de Integração de dados de formulário . Um formulário PDF interativo é um documento PDF que contém um ou mais campos para coletar informações de um usuário ou para exibir informações personalizadas. O serviço Integração de dados de formulário não oferece suporte a cálculos, validação ou scripts de formulários.
Para importar dados para um formulário criado no Designer, é necessário fazer referência a uma fonte de dados XML XDP válida. Considere o seguinte exemplo de formulário de aplicativo de hipoteca.
Para importar valores de dados para esse formulário, é necessário ter uma fonte de dados XML XDP válida que corresponda ao formulário. Não é possível usar uma fonte de dados XML arbitrária para importar dados em um formulário usando o serviço de Integração de dados de formulário . A diferença entre uma fonte de dados XML arbitrária e uma fonte de dados XML XDP é que uma fonte de dados XDP está em conformidade com a XML Forms Architecture (XFA). O XML a seguir representa uma fonte de dados XML XDP que corresponde ao formulário de aplicativo de hipoteca de exemplo.
<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
- <Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
- <Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
Resumo das etapas summary-of-steps
Para importar dados de formulário para um formulário PDF, execute as seguintes etapas:
- Inclua arquivos de projeto.
- Criar um cliente de serviço de Integração de dados de formulário .
- Referência a um formulário PDF.
- Faça referência a uma fonte de dados XML.
- Importe dados para o formulário PDF.
- Salve o formulário PDF como um arquivo PDF.
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-formdataintegration-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)
Para obter informações sobre a localização desses arquivos JAR, consulte Inclusão de arquivos da biblioteca Java do AEM Forms.
Criar um cliente de serviço de Integração de dados de formulário
Antes de poder importar dados de forma programática para uma API do cliente do PDF, é necessário criar um cliente do serviço de Integração de dados. Ao criar um cliente de serviço, você define as configurações de conexão necessárias para chamar um serviço. Para obter mais informações, consulte Configuração das propriedades de conexão.
Referência a um formulário PDF
Para importar dados para um formulário PDF, é necessário fazer referência a um formulário XML criado no Designer ou a um formulário Acrobat criado no Acrobat.
Referência a uma fonte de dados XML
Para importar dados de formulário, é necessário referenciar uma fonte de dados válida. Para importar dados para um formulário XML XFA criado no Designer, é necessário usar uma fonte de dados XML XDP. Se você fizer referência a um formulário Acrobat, deverá usar uma fonte de dados XFDF. Para cada campo para o qual você deseja importar dados, um valor deve ser especificado. Se um elemento localizado na fonte de dados XML não corresponder a um campo no formulário, o elemento será ignorado.
Importar dados para o formulário PDF
Depois de fazer referência a um formulário PDF e uma fonte de dados XML válida, é possível importar os dados para o formulário PDF.
Salve o formulário PDF como um arquivo PDF
Depois de importar os dados para um formulário, é possível salvá-lo como um arquivo PDF. Depois de salvo como um arquivo PDF, um usuário pode abrir o formulário no Adobe Reader ou Acrobat e ver o formulário com os dados importados.
Consulte também
Importar dados de formulário usando a API do Java
Importar dados de formulário usando a API de serviço da Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Início rápido da API do Serviço de integração de dados de formulário
Importar dados de formulário usando a API do Java import-form-data-using-the-java-api
Importe dados do formulário usando a API de integração de dados de formulário (Java):
-
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-formdataintegration-client.jar, no caminho de classe do seu projeto Java.
-
Criar um cliente de serviço de Integração de dados de formulário .
- Crie um
ServiceClientFactory
objeto que contém propriedades de conexão. - Crie um
FormDataIntegrationClient
usando seu construtor e passando oServiceClientFactory
objeto.
- Crie um
-
Referência a um formulário PDF.
- Crie um
java.io.FileInputStream
usando seu construtor. Passe um valor de string que especifica o local do formulário PDF. - Crie um
com.adobe.idp.Document
que armazena o formulário PDF usando ocom.adobe.idp.Document
construtor. Passe ojava.io.FileInputStream
objeto que contém o PDF para o construtor.
- Crie um
-
Faça referência a uma fonte de dados XML.
- Crie um
java.io.FileInputStream
usando seu construtor e transmitindo um valor de string que especifica o local do arquivo XML que contém dados a serem importados para o formulário. - Crie um
com.adobe.idp.Document
objeto que armazena dados de formulário usando ocom.adobe.idp.Document
construtor. Passe ojava.io.FileInputStream
objeto que contém dados de formulário para o construtor.
- Crie um
-
Importe dados para o formulário PDF.
Importe dados para o formulário PDF chamando o
FormDataIntegrationClient
do objetoimportData
e transmitindo os seguintes valores:- O
com.adobe.idp.Document
que armazena o formulário PDF. - O
com.adobe.idp.Document
que armazena dados de formulário.
O
importData
método retorna umcom.adobe.idp.Document
objeto que armazena um formulário PDF que contém os dados localizados na fonte de dados XML. - O
-
Salve o formulário PDF como um arquivo PDF.
- Crie um
java.io.File
e verifique se a extensão do arquivo é ".PDF". - Chame o
Document
do objetocopyToFile
para copiar o conteúdo daDocument
para o arquivo (certifique-se de usar a variávelDocument
objeto retornado peloimportData
método ).
- Crie um
Consulte também
Início rápido (modo SOAP): Importação de dados de formulário usando a API Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Importar dados de formulário usando a API de serviço da Web import-form-data-using-the-web-service-api
Importe dados do formulário usando a API de integração de dados de formulário (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL:
http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.note note NOTE Substituir localhost
com o endereço IP do servidor que hospeda a AEM Forms. -
Criar um cliente de serviço de Integração de dados de formulário .
-
Crie um
FormDataIntegrationClient
usando seu construtor padrão. -
Crie um
FormDataIntegrationClient.Endpoint.Address
usando oSystem.ServiceModel.EndpointAddress
construtor. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo,http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) Não é necessário usar a variávellc_version
atributo. Esse atributo é usado ao criar uma referência de serviço. No entanto, especifique?blob=mtom
para usar MTOM. -
Crie um
System.ServiceModel.BasicHttpBinding
obtendo o valor da variávelFormDataIntegrationClient.Endpoint.Binding
campo. Converta o valor de retorno paraBasicHttpBinding
. -
Defina as
System.ServiceModel.BasicHttpBinding
do objetoMessageEncoding
campo paraWSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
FormDataIntegrationClient.ClientCredentials.UserName.UserName
. - Atribua o valor correspondente da senha ao campo
FormDataIntegrationClient.ClientCredentials.UserName.Password
. - Atribuir o valor constante
HttpClientCredentialType.Basic
ao campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnly
ao campoBasicHttpBindingSecurity.Security.Mode
.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
-
Referência a um formulário PDF.
- Crie um
BLOB
usando seu construtor. EssaBLOB
é usado para armazenar o formulário PDF. - Crie um
System.IO.FileStream
chamando seu construtor. Passe um valor de string que especifica o local do formulário 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
método . Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler. - Preencha o
BLOB
ao atribuir seuMTOM
com o conteúdo da matriz de bytes.
- Crie um
-
Faça referência a uma fonte de dados XML.
- Crie um
BLOB
usando seu construtor. EssaBLOB
é usado para armazenar os dados importados para o formulário. - Crie um
System.IO.FileStream
chamando seu construtor. Passe um valor de string que especifica o local do arquivo XML que contém os dados a serem importados 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
método . Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler. - Preencha o
BLOB
ao atribuir seuMTOM
com o conteúdo da matriz de bytes.
- Crie um
-
Importe dados para o formulário PDF.
Importe dados para o formulário PDF chamando o
FormDataIntegrationClient
do objetoimportData
e transmitindo os seguintes valores:- O
BLOB
que armazena o formulário PDF. - O
BLOB
que armazena dados de formulário.
O
importData
método retorna umBLOB
objeto que armazena um formulário PDF que contém os dados localizados na fonte de dados XML. - O
-
Salve o formulário PDF como um arquivo PDF.
- Crie um
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do PDF. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOB
objeto retornado peloimportData
método . Preencha a matriz de bytes obtendo o valor da variávelBLOB
do objetoMTOM
campo. - 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
Chamar o AEM Forms usando MTOM
Exportar dados de formulário exporting-form-data
É possível exportar dados de formulário de um formulário PDF interativo usando o serviço de Integração de dados de formulário . O formato dos dados exportados depende do tipo de formulário. Se o tipo de formulário for um formulário Acrobat criado no Acrobat, os dados exportados serão XFDF. Se o tipo de formulário for um formulário XML criado no Designer, os dados exportados serão XDP.
Resumo das etapas summary_of_steps-1
Para exportar dados de formulário de um formulário PDF, execute as seguintes etapas:
- Incluir arquivos de projeto
- Criar um cliente de serviço de Integração de dados de formulário .
- Referência a um formulário PDF.
- Exportar dados do formulário PDF.
- Salve os dados exportados como um arquivo XML.
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-formdataintegration-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)
Criar um cliente de serviço de Integração de dados de formulário
Antes de poder importar dados de forma programática para uma API do PDF formClient, é necessário criar um cliente do serviço de Integração de dados. Ao criar um cliente de serviço, você define as configurações de conexão necessárias para chamar um serviço. Para obter informações, Configuração das propriedades de conexão.
Referência a um formulário PDF
Para exportar dados de um formulário PDF, é necessário fazer referência a um formulário PDF criado no Designer ou Acrobat que contenha dados de formulário. Se tentar exportar dados de um formulário PDF vazio, você receberá um esquema XML vazio.
Exportar dados do formulário PDF
Depois de fazer referência a um formulário PDF que contém dados de formulário, é possível exportar os dados desse formulário. Os dados são exportados dentro de um esquema XML baseado no formulário.
Salve os dados do formulário como um arquivo XML
Após exportar os dados do formulário, é possível salvá-los como um arquivo XML. Depois de salvo como um arquivo XML, você pode abrir o arquivo XML em um visualizador XML para exibir os dados do formulário.
Consulte também
Exportar dados de formulário usando a API Java
Exportar dados de formulário usando a API de serviço da Web
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Início rápido da API do Serviço de integração de dados de formulário
Importação de dados de formulário
Exportar dados de formulário usando a API Java export-form-data-using-the-java-api
Exporte dados de formulário usando a API de integração de dados de formulário (Java):
-
Inclua arquivos de projeto.
Inclua arquivos JAR do cliente, como adobe-formdataintegration-client.jar, no caminho de classe do seu projeto Java.
-
Criar um cliente de serviço de Integração de dados de formulário .
- Crie um
ServiceClientFactory
objeto que contém propriedades de conexão. - Crie um
FormDataIntegrationClient
usando seu construtor e passando oServiceClientFactory
objeto.
- Crie um
-
Referência a um formulário PDF.
- Crie um
java.io.FileInputStream
ao usar seu construtor e passar um valor de string que especifica o local do formulário PDF que contém dados para exportar. - Crie um
com.adobe.idp.Document
que armazena o formulário PDF usando ocom.adobe.idp.Document
construtor. Passe ojava.io.FileInputStream
objeto que contém o PDF para o construtor.
- Crie um
-
Exportar dados do formulário PDF.
Exportar dados de formulário chamando o
FormDataIntegrationClient
do objetoexportData
e passe ocom.adobe.idp.Document
que armazena o formulário PDF. Esse método retorna umcom.adobe.idp.Document
que armazena dados de formulário como um esquema XML. -
Salve o formulário PDF como um arquivo PDF.
- Crie um
java.io.File
e verifique se a extensão do arquivo é XML. - Chame o
Document
do objetocopyToFile
para copiar o conteúdo daDocument
para o arquivo (certifique-se de usar a variávelDocument
objeto retornado peloexportData
método ).
- Crie um
Consulte também
Início rápido (modo SOAP): Exportação de dados de formulário usando a API Java
Inclusão de arquivos da biblioteca Java do AEM Forms
Configuração das propriedades de conexão
Exportar dados de formulário usando a API de serviço da Web export-form-data-using-the-web-service-api
Exportar dados de formulário usando a API de integração de dados de formulário (serviço da Web):
-
Inclua arquivos de projeto.
Crie um projeto Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição de WSDL:
http://localhost:8080/soap/services/FormDataIntegration?WSDL&lc_version=9.0.1
.- Substituir
localhost
com o endereço IP do servidor que hospeda a AEM Forms.
- Substituir
-
Criar um cliente de serviço de Integração de dados de formulário .
-
Crie um
FormDataIntegrationClient
usando seu construtor padrão. -
Crie um
FormDataIntegrationClient.Endpoint.Address
usando oSystem.ServiceModel.EndpointAddress
construtor. Passe um valor de string que especifica o WSDL para o serviço do AEM Forms (por exemplo,http://localhost:8080/soap/services/FormDataIntegration?blob=mtom
.) Não é necessário usar a variávellc_version
atributo. Esse atributo é usado ao criar uma referência de serviço. No entanto, especifique?blob=mtom
para usar MTOM. -
Crie um
System.ServiceModel.BasicHttpBinding
obtendo o valor da variávelFormDataIntegrationClient.Endpoint.Binding
campo. Converta o valor de retorno paraBasicHttpBinding
. -
Defina as
System.ServiceModel.BasicHttpBinding
do objetoMessageEncoding
campo paraWSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado. -
Ative a autenticação HTTP básica executando as seguintes tarefas:
- Atribuir o nome de usuário dos formulários AEM ao campo
FormDataIntegrationClient.ClientCredentials.UserName.UserName
. - Atribua o valor correspondente da senha ao campo
FormDataIntegrationClient.ClientCredentials.UserName.Password
. - Atribuir o valor constante
HttpClientCredentialType.Basic
ao campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Atribuir o valor constante
BasicHttpSecurityMode.TransportCredentialOnly
ao campoBasicHttpBindingSecurity.Security.Mode
.
- Atribuir o nome de usuário dos formulários AEM ao campo
-
-
Referência a um formulário PDF.
- Crie um
BLOB
usando seu construtor. EssaBLOB
é usado para armazenar o formulário PDF do qual os dados são exportados. - Crie um
System.IO.FileStream
chamando seu construtor. Passe um valor de string que especifica o local do formulário 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 seuMTOM
com o conteúdo da matriz de bytes.
- Crie um
-
Exportar dados do formulário PDF.
Importe dados para o formulário PDF chamando o
FormDataIntegrationClient
do objetoexportData
e passe oBLOB
que armazena o formulário PDF. Esse método retorna umBLOB
que armazena dados de formulário como um esquema XML. -
Salve o formulário PDF como um arquivo PDF.
- Crie um
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo XML. - Crie uma matriz de bytes que armazene o conteúdo de dados do
BLOB
objeto retornado peloexportData
método . Preencha a matriz de bytes obtendo o valor da variávelBLOB
do objetoMTOM
campo. - 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 XML chamando o
System.IO.BinaryWriter
do objetoWrite
e transmitindo a matriz de bytes.
- Crie um
Consulte também
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef