Resumo das etapas

Para desmontar um documento PDF usando um documento DDX criado dinamicamente, execute as seguintes tarefas:

  1. Incluir arquivos de projeto.
  2. Crie um cliente PDF Assembler.
  3. Crie o documento DDX.
  4. Converta o documento DDX.
  5. Definir opções de tempo de execução.
  6. Desmonte o documento PDF.
  7. Salve os documentos de PDF desmontados.

Incluir arquivos de projeto

Inclua os arquivos necessários no projeto de desenvolvimento. Se você estiver criando uma aplicação 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 caminho de classe do projeto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-assembler-client.jar
  • adobe-utilities.jar (necessário se o AEM Forms for implantado no JBoss)
  • jbossall-client.jar (necessário se o AEM Forms for implantado no JBoss)

Criar um cliente PDF Assembler

Antes de executar programaticamente uma operação do Assembler, crie um cliente de serviço do Assembler.

Criar o documento DDX

Crie um documento DDX usando a linguagem de programação que você está usando. Para criar um documento DDX que desmonte um documento PDF, verifique se ele contém o elemento PDFsFromBookmarks. Converta o tipo de dados usado para criar o documento DDX em uma instância com.adobe.idp.Document se estiver usando a API Java. Se você estiver usando serviços Web, converta o tipo de dados em uma instância BLOB.

Converter o documento DDX

Um documento DDX criado usando classes org.w3c.dom deve ser convertido em um objeto com.adobe.idp.Document. Para executar essa tarefa ao usar a API Java, use classes de transformação Java XML. Se você estiver usando serviços Web, converta o documento DDX em um objeto BLOB.

Referenciar um documento PDF para desmontar

Para desmontar um documento PDF, consulte um arquivo PDF que representa o documento PDF a ser desmontado. Quando passado para o serviço Assembler, um documento PDF separado é retornado para cada marcador de nível 1 no documento.

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

Você pode definir opções de tempo de execução que controlam o comportamento do serviço Assembler enquanto ele executa um job. Por exemplo, você pode definir uma opção que instrui o serviço Assembler a continuar processando um job se um erro for encontrado. Para definir opções de tempo de execução, use um objeto AssemblerOptionSpec.

Desmontar o documento PDF

Desmonte o documento PDF invocando a operação invokeDDX. Transmita o documento DDX criado dinamicamente. O serviço Assembler retorna documentos PDF desmontados dentro de um objeto de coleção.

Salvar os documentos de PDF desmontados

Todos os documentos de PDF desmontados são retornados dentro de um objeto de coleção. Repita o processo através do objeto de coleção e salve cada documento de PDF como um arquivo de PDF.

Consulte também

Criar dinamicamente um documento DDX usando a API do Java

Criar dinamicamente um documento DDX usando a API do serviço Web

Inclusão de arquivos da biblioteca Java do AEM Forms

Definindo propriedades de conexão

Desmontando Documentos PDF de Forma Programática

Criar dinamicamente um documento DDX usando a API do Java

Crie dinamicamente um documento DDX e desmonte um documento PDF usando a API de serviço do Assembler (Java):

  1. Incluir arquivos de projeto.

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

  2. 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.
  3. 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);

  4. 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.
  5. 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.
  6. 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.
  7. 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.

  8. 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.