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:
Os dados do formulário podem existir em um dos seguintes formatos, dependendo do tipo de formulário PDF:
Você pode realizar essas tarefas usando o serviço de Integração de dados de formulário :
Para obter mais informações sobre o serviço de Integração de dados de formulário, consulte Referência de serviços para AEM Forms.
É 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>
Para obter mais informações sobre o serviço de Integração de dados de formulário, consulte Referência de serviços para AEM Forms.
Para importar dados de formulário para um formulário PDF, execute as seguintes etapas:
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:
Para obter informações sobre a localização desses arquivos JAR, consulte Incluindo 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 um formulário PDF da API do cliente, é 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, consulte Definindo propriedades de conexão.
Referência a um formulário PDF
Para importar dados para um formulário PDF, é necessário referenciar um formulário XML criado no Designer ou 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 a uma fonte de dados XML válida, é possível importar os dados para o formulário PDF.
Salvar 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 no 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
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 .
ServiceClientFactory
que contenha propriedades de conexão.FormDataIntegrationClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Referência a um formulário PDF.
java.io.FileInputStream
usando seu construtor. Passe um valor de string que especifica o local do formulário PDF.com.adobe.idp.Document
que armazene o formulário PDF usando o construtor com.adobe.idp.Document
. Passe o objeto java.io.FileInputStream
que contém o formulário PDF para o construtor.Faça referência a uma fonte de dados XML.
java.io.FileInputStream
usando seu construtor e passe um valor de string que especifique o local do arquivo XML que contém dados a serem importados para o formulário.com.adobe.idp.Document
que armazene dados de formulário usando o construtor com.adobe.idp.Document
. Passe o objeto java.io.FileInputStream
que contém dados de formulário para o construtor.Importe dados para o formulário PDF.
Importe dados no formulário PDF chamando o método FormDataIntegrationClient
do objeto e passando os seguintes valores:importData
com.adobe.idp.Document
que armazena o formulário PDF.com.adobe.idp.Document
que armazena dados de formulário.O método importData
retorna um objeto com.adobe.idp.Document
que armazena um formulário PDF que contém os dados localizados na fonte de dados XML.
Salve o formulário PDF como um arquivo PDF.
java.io.File
e verifique se a extensão de arquivo é ".PDF".Document
do objeto copyToFile
para copiar o conteúdo do objeto Document
para o arquivo (certifique-se de usar o objeto Document
retornado pelo método importData
).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
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 do 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
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Criar um cliente de serviço de Integração de dados de formulário .
Crie um objeto FormDataIntegrationClient
usando seu construtor padrão.
Crie um objeto FormDataIntegrationClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. 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
.) Você não precisa usar o atributo lc_version
. Esse atributo é usado ao criar uma referência de serviço. No entanto, especifique ?blob=mtom
para usar MTOM.
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo FormDataIntegrationClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
.FormDataIntegrationClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.Referência a um formulário PDF.
BLOB
usando seu construtor. Esse objeto BLOB
é usado para armazenar o formulário PDF.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.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Faça referência a uma fonte de dados XML.
BLOB
usando seu construtor. Esse objeto BLOB
é usado para armazenar os dados importados para o formulário.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.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
. Passe a matriz de bytes, a posição inicial e o comprimento do fluxo para ler.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Importe dados para o formulário PDF.
Importe dados no formulário PDF chamando o método FormDataIntegrationClient
do objeto importData
e passando os seguintes valores:
BLOB
que armazena o formulário PDF.BLOB
que armazena dados de formulário.O método importData
retorna um objeto BLOB
que armazena um formulário PDF que contém os dados localizados na fonte de dados XML.
Salve o formulário PDF como um arquivo PDF.
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo do arquivo PDF.BLOB
retornado pelo método importData
. Preencha a matriz de bytes obtendo o valor do campo BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.System.IO.BinaryWriter
do objeto Write
e transmitindo a matriz de bytes.Consulte também:
Chamar o AEM Forms usando MTOM
É possível exportar dados de formulário de um formulário PDF interativo usando o serviço 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.
Para obter mais informações sobre o serviço de Integração de dados de formulário, consulte Referência de serviços para AEM Forms.
Para exportar dados de formulário de um formulário PDF, execute as seguintes etapas:
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:
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 formClient de PDF, é necessário criar um cliente de 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, Definindo propriedades de conexão.
Referência a um formulário PDF
Para exportar dados de um formulário PDF, é necessário referenciar um formulário PDF criado no Designer ou Acrobat que contenha dados de formulário. Se você tentar exportar dados de um formulário PDF vazio, 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
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 .
ServiceClientFactory
que contenha propriedades de conexão.FormDataIntegrationClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Referência a um formulário PDF.
java.io.FileInputStream
usando seu construtor e passe um valor de string que especifique o local do formulário PDF que contém dados para exportar.com.adobe.idp.Document
que armazene o formulário PDF usando o construtor com.adobe.idp.Document
. Passe o objeto java.io.FileInputStream
que contém o formulário PDF para o construtor.Exportar dados do formulário PDF.
Exporte os dados do formulário chamando o método FormDataIntegrationClient
do objeto e passe o objeto com.adobe.idp.Document
que armazena o formulário PDF. exportData
Esse método retorna um objeto com.adobe.idp.Document
que armazena dados de formulário como um esquema XML.
Salve o formulário PDF como um arquivo PDF.
java.io.File
e verifique se a extensão de arquivo é XML.Document
do objeto copyToFile
para copiar o conteúdo do objeto Document
para o arquivo (certifique-se de usar o objeto Document
retornado pelo método exportData
).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 integração de dados de formulário (serviço da Web):
Inclua arquivos de projeto.
Crie um projeto do 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
.
localhost
pelo endereço IP do servidor que hospeda o AEM Forms.Criar um cliente de serviço de Integração de dados de formulário .
Crie um objeto FormDataIntegrationClient
usando seu construtor padrão.
Crie um objeto FormDataIntegrationClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. 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
.) Você não precisa usar o atributo lc_version
. Esse atributo é usado ao criar uma referência de serviço. No entanto, especifique ?blob=mtom
para usar MTOM.
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo FormDataIntegrationClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto para WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
FormDataIntegrationClient.ClientCredentials.UserName.UserName
.FormDataIntegrationClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.BasicHttpSecurityMode.TransportCredentialOnly
ao campo BasicHttpBindingSecurity.Security.Mode
.Referência a um formulário PDF.
BLOB
usando seu construtor. Esse objeto BLOB
é usado para armazenar o formulário PDF a partir do qual os dados são exportados.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.System.IO.FileStream
. Você pode determinar o tamanho da matriz de bytes obtendo a propriedade System.IO.FileStream
do objeto Length
.System.IO.FileStream
do objeto Read
e passando a matriz de bytes, a posição inicial e o comprimento do fluxo a ser lido.BLOB
atribuindo seu campo MTOM
ao conteúdo da matriz de bytes.Exportar dados do formulário PDF.
Importe dados para o formulário PDF chamando o método exportData
do objeto e passe o objeto BLOB
que armazena o formulário PDF. FormDataIntegrationClient
Esse método retorna um objeto BLOB
que armazena dados de formulário como um esquema XML.
Salve o formulário PDF como um arquivo PDF.
System.IO.FileStream
chamando seu construtor e passando um valor de string que representa o local do arquivo XML.BLOB
retornado pelo método exportData
. Preencha a matriz de bytes obtendo o valor do campo BLOB
do objeto MTOM
.System.IO.BinaryWriter
chamando seu construtor e passando o objeto System.IO.FileStream
.System.IO.BinaryWriter
do objeto Write
e transmitindo a matriz de bytes.Consulte também:
Chamar o AEM Forms usando MTOM
Chamar o AEM Forms usando SwaRef