Criação dinâmica de documentos DDX dynamically-creating-ddx-documents

Incluir arquivos de projeto.

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

Crie um cliente PDF Assembler.

• Crie um objeto ServiceClientFactory que contenha propriedades de conexão.
• Crie um objeto AssemblerServiceClient usando seu construtor e transmitindo o objeto ServiceClientFactory.

Crie o documento DDX.

• Crie um objeto Java DocumentBuilderFactory chamando o método newInstance da classe DocumentBuilderFactory.

• Crie um objeto Java DocumentBuilder chamando o método newDocumentBuilder do objeto DocumentBuilderFactory.

• Chame o método newDocument do objeto DocumentBuilder para instanciar um objeto org.w3c.dom.Document.

• Crie o elemento raiz do documento DDX invocando o método createElement do objeto org.w3c.dom.Document. Este método cria um objeto Element que representa o elemento raiz. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Em seguida, defina um valor para o elemento filho chamando seu método setAttribute. Finalmente, anexe o elemento ao elemento de cabeçalho chamando o método appendChild do elemento de cabeçalho e passe o objeto de elemento filho como argumento. As linhas de código a seguir mostram essa lógica de aplicação:

   Element root = (Element)document.createElement("DDX");  root.setAttribute("xmlns","https://ns.adobe.com/DDX/1.0/");  document.appendChild(root);

• Crie o elemento PDFsFromBookmarks chamando o método createElement do objeto Document. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método createElement. Converter o valor de retorno em Element. Defina um valor para o elemento PDFsFromBookmarks chamando seu método setAttribute. Anexe o elemento PDFsFromBookmarks ao elemento DDX, chamando o método appendChild do elemento DDX. Passe o objeto de elemento PDFsFromBookmarks como argumento. As linhas de código a seguir mostram essa lógica de aplicação:

   Element PDFsFromBookmarks = (Element)document.createElement("PDFsFromBookmarks");  PDFsFromBookmarks.setAttribute("prefix","stmt");  root.appendChild(PDFsFromBookmarks);

• Crie um elemento PDF chamando o método createElement do objeto Document. Transmita um valor de string que represente o nome do elemento. Converter o valor de retorno em Element. Defina um valor para o elemento PDF chamando seu método setAttribute. Anexe o elemento PDF ao elemento PDFsFromBookmarks, chamando o método appendChild do elemento PDFsFromBookmarks. Passe o objeto de elemento PDF como argumento. As linhas de código a seguir mostram essa lógica de aplicação:

   Element PDF = (Element)document.createElement("PDF");  PDF.setAttribute("source","AssemblerResultPDF.pdf");  PDFsFromBookmarks.appendChild(PDF);

Converta o documento DDX.

• Crie um objeto javax.xml.transform.Transformer invocando o método newInstance estático do objeto javax.xml.transform.Transformer.
• Crie um objeto Transformer invocando o método newTransformer do objeto TransformerFactory.
• Crie um objeto ByteArrayOutputStream usando seu construtor.
• Crie um objeto javax.xml.transform.dom.DOMSource usando seu construtor. Transmita o objeto org.w3c.dom.Document que representa o documento DDX.
• Crie um objeto javax.xml.transform.dom.DOMSource usando seu construtor e transmitindo o objeto ByteArrayOutputStream.
• Preencha o objeto Java ByteArrayOutputStream invocando o método transform do objeto javax.xml.transform.Transformer. Passar os objetos javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult.
• Crie uma matriz de bytes e aloque o tamanho do objeto ByteArrayOutputStream à matriz de bytes.
• Preencha a matriz de bytes invocando o método toByteArray do objeto ByteArrayOutputStream.
• Crie um objeto com.adobe.idp.Document usando seu construtor e transmitindo a matriz de bytes.

Referencie um documento do PDF para desmontar.

• Crie um objeto java.util.Map usado para armazenar documentos de PDF de entrada usando um construtor HashMap.

• Crie um objeto java.io.FileInputStream usando seu construtor e transmitindo o local do documento PDF a ser desmontado.

• Crie um objeto com.adobe.idp.Document. Passe o objeto java.io.FileInputStream que contém o documento PDF a ser desmontado.

• Adicione uma entrada ao objeto java.util.Map invocando seu método put e transmitindo os seguintes argumentos:

  • Um valor de string que representa o nome da chave. Este valor deve corresponder ao valor do elemento de origem PDF especificado no documento DDX. (No documento DDX criado dinamicamente, o valor é AssemblerResultPDF.pdf.)
  • Um objeto com.adobe.idp.Document que contém o documento PDF a ser desmontado.

Definir opções de tempo de execução.

• Crie um objeto AssemblerOptionSpec que armazene opções de tempo de execução usando seu construtor.
• Defina as opções de tempo de execução para atender aos requisitos da sua empresa invocando um método que pertença ao objeto AssemblerOptionSpec. Por exemplo, para instruir o serviço Assembler a continuar processando um trabalho quando ocorrer um erro, chame o método setFailOnError do objeto AssemblerOptionSpec e passe false.

Desmonte o documento PDF.

Invoque o método invokeDDX do objeto AssemblerServiceClient e passe os seguintes valores:

• Um objeto com.adobe.idp.Document que representa o documento DDX criado dinamicamente
• Um objeto java.util.Map que contém o documento PDF a ser desmontado
• Um objeto com.adobe.livecycle.assembler.client.AssemblerOptionSpec que especifica as opções de tempo de execução, incluindo a fonte padrão e o nível de log do trabalho

O método invokeDDX retorna um objeto com.adobe.livecycle.assembler.client.AssemblerResult que contém os documentos PDF desmontados e as exceções que ocorreram.

Salve os documentos de PDF desmontados.

Para obter os documentos de PDF desmontados, execute as seguintes ações:

• Invoque o método getDocuments do objeto AssemblerResult. Este método retorna um objeto java.util.Map.
• Repita o objeto java.util.Map até encontrar o objeto com.adobe.idp.Document resultante.
• Invoque o método copyToFile do objeto com.adobe.idp.Document para extrair o documento PDF.

Incluir arquivos de projeto.

Crie um projeto Microsoft .NET que use MTOM. Certifique-se de usar a seguinte definição WSDL ao definir uma referência de serviço: http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

Crie um cliente PDF Assembler.

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

• Crie um objeto AssemblerServiceClient.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/AssemblerService?blob=mtom). 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 AssemblerServiceClient.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 AssemblerServiceClient.ClientCredentials.UserName.UserName.
  • Atribua o valor de senha correspondente ao campo AssemblerServiceClient.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.

Crie o documento DDX.

• Crie um objeto System.Xml.XmlElement usando seu construtor.

• Crie o elemento raiz do documento DDX invocando o método CreateElement do objeto XmlElement. Este método cria um objeto Element que representa o elemento raiz. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método CreateElement. Defina um valor para o elemento DDX chamando seu método SetAttribute. Finalmente, anexe o elemento ao documento DDX chamando o método AppendChild do objeto XmlElement. Passe o objeto DDX como argumento. As linhas de código a seguir mostram essa lógica de aplicação:

   System.Xml.XmlElement root = ddx.CreateElement("DDX");  root.SetAttribute("xmlns", "https://ns.adobe.com/DDX/1.0/");  ddx.AppendChild(root);

• Crie o elemento PDFsFromBookmarks do documento DDX chamando o método CreateElement do objeto XmlElement. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método CreateElement. Em seguida, defina um valor para o elemento chamando seu método SetAttribute. Anexe o elemento PDFsFromBookmarks ao elemento raiz, chamando o método AppendChild do elemento DDX. Passe o objeto de elemento PDFsFromBookmarks como argumento. As linhas de código a seguir mostram essa lógica de aplicação:

   XmlElement PDFsFromBookmarks = ddx.CreateElement("PDFsFromBookmarks");  PDFsFromBookmarks.SetAttribute("prefix", "stmt");  root.AppendChild(PDFsFromBookmarks);

• Crie o elemento PDF do documento DDX chamando o método CreateElement do objeto XmlElement. Passe um valor de cadeia de caracteres que representa o nome do elemento para o método CreateElement. Em seguida, defina um valor para o elemento filho chamando seu método SetAttribute. Anexe o elemento PDF ao elemento PDFsFromBookmarks, chamando o método AppendChild do elemento PDFsFromBookmarks. Passe o objeto de elemento PDF como argumento. As linhas de código a seguir mostram essa lógica de aplicação:

   XmlElement PDF = ddx.CreateElement("PDF");  PDF.SetAttribute("source", "AssemblerResultPDF.pdf");  PDFsFromBookmarks.AppendChild(PDF);

Converta o documento DDX.

• Crie um objeto System.IO.MemoryStream usando seu construtor.

• Preencha o objeto MemoryStream com o documento DDX usando o objeto XmlElement que representa o documento DDX. Invoque o método Save do objeto XmlElement e passe o objeto MemoryStream.

• Crie uma matriz de bytes e preencha-a com dados no objeto MemoryStream. O código a seguir mostra essa lógica de aplicação:

   int bufLen = Convert.ToInt32(stream.Length);  byte[] byteArray = new byte[bufLen];  stream.Position = 0;  int count = stream.Read(byteArray, 0, bufLen);

• Crie um objeto BLOB. Atribua a matriz de bytes ao campo MTOM do objeto BLOB.

Referencie um documento do PDF para desmontar.

• Crie um objeto BLOB usando seu construtor. O objeto BLOB é usado para armazenar o documento de PDF de entrada. Este objeto BLOB é passado para invokeOneDocument como argumento.
• Crie um objeto System.IO.FileStream invocando seu construtor. Transmita um valor de string que represente o local do arquivo do PDF de entrada 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 propriedade Length do objeto System.IO.FileStream.
• Preencha a matriz de bytes com dados de fluxo invocando o método Read do objeto System.IO.FileStream e transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.
• Preencha o objeto BLOB atribuindo à propriedade MTOM o conteúdo da matriz de bytes.

Definir opções de tempo de execução.

• Crie um objeto AssemblerOptionSpec que armazene opções de tempo de execução usando seu construtor.
• Defina opções de tempo de execução para atender aos requisitos comerciais atribuindo um valor a um membro de dados que pertença ao objeto AssemblerOptionSpec. Por exemplo, para instruir o serviço Assembler a continuar processando um trabalho quando ocorrer um erro, atribua false ao membro de dados failOnError do objeto AssemblerOptionSpec.

Desmonte o documento PDF.

Invoque o método invokeDDX do objeto AssemblerServiceClient e passe os seguintes valores:

• Um objeto BLOB que representa o documento DDX criado dinamicamente
• A matriz mapItem que contém o documento PDF de entrada
• Um objeto AssemblerOptionSpec que especifica as opções de tempo de execução

O método invokeDDX retorna um objeto AssemblerResult que contém os resultados do trabalho e as exceções que ocorreram.

Salve os documentos de PDF desmontados.

Para obter os documentos PDF recém-criados, execute as seguintes ações:

• Acesse o campo documents do objeto AssemblerResult, que é um objeto Map que contém os documentos PDF desmontados.
• Repita através do objeto Map para obter cada documento resultante. Em seguida, converta os value do membro da matriz em BLOB.
• Extraia os dados binários que representam o documento PDF acessando a propriedade MTOM do objeto BLOB. Isso retorna uma matriz de bytes que você pode gravar em um arquivo PDF.