Passar documentos para o serviço da Forms passing-documents-to-the-formsservice

Incluir arquivos de projeto

Inclua arquivos JAR do cliente, como adobe-forms-client.jar e adobe-contentservices-client.jar, no caminho de classe do projeto Java.

Criar um Forms e um objeto de API do cliente de gerenciamento de documentos

• Crie um objeto ServiceClientFactory que contenha propriedades de conexão. (Consulte Definindo propriedades de conexão.)
• Crie um objeto FormsServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.
• Crie um objeto DocumentManagementServiceClientImpl usando seu construtor e transmitindo o objeto ServiceClientFactory.

Recuperar o design do formulário do Content Services (desaprovado)

Chame o método retrieveContent do objeto DocumentManagementServiceClientImpl e passe os seguintes valores:

• Um valor de string que especifica o armazenamento em que o conteúdo é adicionado. O armazenamento padrão é SpacesStore. Esse valor é um parâmetro obrigatório.
• Um valor de cadeia que especifica o caminho totalmente qualificado do conteúdo a ser recuperado (por exemplo, /Company Home/Form Designs/Loan.xdp). Esse valor é um parâmetro obrigatório.
• Um valor de string que especifica a versão. Esse valor é um parâmetro opcional e você pode passar uma string vazia. Nessa situação, a versão mais recente é recuperada.

O método retrieveContent retorna um objeto CRCResult que contém o arquivo XDP. Obtenha uma instância com.adobe.idp.Document invocando o método getDocument do objeto CRCResult.

Renderizar um formulário PDF interativo

Chame o método renderPDFForm2 do objeto FormsServiceClient e passe os seguintes valores:

• Um objeto com.adobe.idp.Document que contém o design de formulário recuperado do Content Services (desaprovado).
• Um objeto com.adobe.idp.Document que contém dados para mesclar com o formulário. Se não quiser mesclar dados, passe um objeto com.adobe.idp.Document vazio.
• Um objeto PDFFormRenderSpec que armazena opções de tempo de execução. Este valor é um parâmetro opcional, e você pode especificar null se não quiser especificar opções de tempo de execução.
• Um objeto URLSpec que contém valores de URI. Este valor é um parâmetro opcional, e você pode especificar null.
• Um objeto java.util.HashMap que armazena anexos de arquivo. Este valor é um parâmetro opcional, e você pode especificar null se não quiser anexar arquivos ao formulário.

O método renderPDFForm retorna um objeto FormsResult que contém um fluxo de dados de formulário que deve ser gravado no navegador Web cliente.

Executar uma ação com o fluxo de dados de formulário

• Crie um objeto com.adobe.idp.Document invocando o método getOutputContent do objeto FormsResult.
• Obtenha o tipo de conteúdo do objeto com.adobe.idp.Document invocando seu método getContentType.
• Defina o tipo de conteúdo do objeto javax.servlet.http.HttpServletResponse invocando seu método setContentType e transmitindo o tipo de conteúdo do objeto com.adobe.idp.Document.
• Crie um objeto javax.servlet.ServletOutputStream usado para gravar o fluxo de dados de formulário no navegador da Web cliente, chamando o método getOutputStream do objeto javax.servlet.http.HttpServletResponse.
• Crie um objeto java.io.InputStream invocando o método getInputStream do objeto com.adobe.idp.Document.
• Crie uma matriz de bytes e preencha-a com o fluxo de dados de formulário, chamando o método read do objeto InputStream. Transmita a matriz de bytes como argumento.
• Invoque o método write do objeto javax.servlet.ServletOutputStream para enviar o fluxo de dados de formulário para o navegador da Web cliente. Passar a matriz de bytes para o método write.

Incluir arquivos de projeto

Crie um projeto Microsoft .NET que use MTOM. Como este aplicativo cliente invoca dois serviços AEM Forms, crie duas referências de serviço. Use a seguinte definição WSDL para a referência de serviço associada ao serviço Forms: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Use a seguinte definição WSDL para a referência de serviço associada ao serviço de Gerenciamento de Documentos: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

Como o tipo de dados BLOB é comum a ambas as referências de serviço, qualifique totalmente o tipo de dados BLOB ao usá-lo. No início rápido do serviço Web correspondente, todas as BLOB instâncias são totalmente qualificadas.

Criar um Forms e um objeto de API do cliente de gerenciamento de documentos

• Crie um objeto FormsServiceClient usando seu construtor padrão.

• Crie um objeto FormsServiceClient.Endpoint.Address usando o construtor System.ServiceModel.EndpointAddress. Transmita um valor de string que especifique o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/FormsService?WSDL). Você não precisa usar o atributo lc_version. Esse atributo é usado quando você cria uma referência de serviço.)

• Crie um objeto System.ServiceModel.BasicHttpBinding obtendo o valor do campo FormsServiceClient.Endpoint.Binding. Converter o valor de retorno em BasicHttpBinding.

• Defina o campo MessageEncoding do objeto System.ServiceModel.BasicHttpBinding como WSMessageEncoding.Mtom. Esse valor garante que a MTOM seja usada.

• Ative a autenticação HTTP básica executando as seguintes tarefas:

  • Atribua o nome de usuário dos formulários AEM ao campo FormsServiceClient.ClientCredentials.UserName.UserName.
  • Atribua o valor de senha correspondente ao campo FormsServiceClient.ClientCredentials.UserName.Password.
  • Atribua o valor constante HttpClientCredentialType.Basic ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Atribua o valor constante BasicHttpSecurityMode.TransportCredentialOnly ao campo BasicHttpBindingSecurity.Security.Mode.

Recuperar o design do formulário do Content Services (desaprovado)

Recupere o conteúdo chamando o método retrieveContent do objeto DocumentManagementServiceClient e transmitindo os seguintes valores:

• Um valor de string que especifica o armazenamento em que o conteúdo é adicionado. O armazenamento padrão é SpacesStore. Esse valor é um parâmetro obrigatório.
• Um valor de cadeia que especifica o caminho totalmente qualificado do conteúdo a ser recuperado (por exemplo, /Company Home/Form Designs/Loan.xdp). Esse valor é um parâmetro obrigatório.
• Um valor de string que especifica a versão. Esse valor é um parâmetro opcional e você pode passar uma string vazia. Nessa situação, a versão mais recente é recuperada.
• Um parâmetro de saída da string que armazena o valor do link de pesquisa.
• Um parâmetro de saída BLOB que armazena o conteúdo. Você pode usar esse parâmetro de saída para recuperar o conteúdo.
• Um parâmetro de saída ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType que armazena atributos de conteúdo.
• Um parâmetro de saída CRCResult. Em vez de usar esse objeto, você pode usar o parâmetro de saída BLOB para obter o conteúdo.

Renderizar um formulário PDF interativo

Chame o método renderPDFForm2 do objeto FormsServiceClient e passe os seguintes valores:

• Um objeto BLOB que contém o design de formulário recuperado do Content Services (desaprovado).
• Um objeto BLOB que contém dados para mesclar com o formulário. Se não quiser mesclar dados, passe um objeto BLOB vazio.
• Um objeto PDFFormRenderSpec que armazena opções de tempo de execução. Este valor é um parâmetro opcional, e você pode especificar null se não quiser especificar opções de tempo de execução.
• Um objeto URLSpec que contém valores de URI. Este valor é um parâmetro opcional, e você pode especificar null.
• Um objeto Map que armazena anexos de arquivo. Este valor é um parâmetro opcional, e você pode especificar null se não quiser anexar arquivos ao formulário.
• Um parâmetro de saída longo que é usado para armazenar a contagem de páginas.
• Um parâmetro de saída da string que é usado para armazenar o valor do local.
• Um parâmetro de saída FormsResult que é usado para armazenar o formulário de PDF interativo .

O método renderPDFForm2 retorna um objeto FormsResult que contém o formulário PDF interativo.

Executar uma ação com o fluxo de dados de formulário

• Crie um objeto BLOB que contenha dados de formulário obtendo o valor do campo outputContent do objeto FormsResult.
• Crie um objeto System.IO.FileStream invocando seu construtor. Transmita um valor de string que represente o local do arquivo do documento PDF interativo e o modo no qual o arquivo será aberto.
• Crie uma matriz de bytes que armazene o conteúdo do objeto BLOB recuperado do objeto FormsResult. Popular a matriz de bytes obtendo o valor do membro de dados MTOM do objeto BLOB.
• Crie um objeto System.IO.BinaryWriter invocando seu construtor e transmitindo o objeto System.IO.FileStream.
• Grave o conteúdo da matriz de bytes em um arquivo PDF, chamando o método Write do objeto System.IO.BinaryWriter e transmitindo a matriz de bytes.