Resumo das etapas
Para desmontar um documento PDF usando um documento DDX criado dinamicamente, execute as seguintes tarefas:
- Incluir arquivos de projeto.
- Crie um cliente PDF Assembler.
- Crie o documento DDX.
- Converta o documento DDX.
- Definir opções de tempo de execução.
- Desmonte o documento PDF.
- 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
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):
-
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
ServiceClientFactoryque contenha propriedades de conexão. - Crie um objeto
AssemblerServiceClientusando seu construtor e transmitindo o objetoServiceClientFactory.
- Crie um objeto
-
Crie o documento DDX.
-
Crie um objeto Java
DocumentBuilderFactorychamando o métodonewInstanceda classeDocumentBuilderFactory. -
Crie um objeto Java
DocumentBuilderchamando o métodonewDocumentBuilderdo objetoDocumentBuilderFactory. -
Chame o método
newDocumentdo objetoDocumentBuilderpara instanciar um objetoorg.w3c.dom.Document. -
Crie o elemento raiz do documento DDX invocando o método
createElementdo objetoorg.w3c.dom.Document. Este método cria um objetoElementque representa o elemento raiz. Passe um valor de cadeia de caracteres que representa o nome do elemento para o métodocreateElement. Converter o valor de retorno emElement. Em seguida, defina um valor para o elemento filho chamando seu métodosetAttribute. Finalmente, anexe o elemento ao elemento de cabeçalho chamando o métodoappendChilddo 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
PDFsFromBookmarkschamando o métodocreateElementdo objetoDocument. Passe um valor de cadeia de caracteres que representa o nome do elemento para o métodocreateElement. Converter o valor de retorno emElement. Defina um valor para o elementoPDFsFromBookmarkschamando seu métodosetAttribute. Anexe o elementoPDFsFromBookmarksao elementoDDX, chamando o métodoappendChilddo elemento DDX. Passe o objeto de elementoPDFsFromBookmarkscomo 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
PDFchamando o métodocreateElementdo objetoDocument. Transmita um valor de string que represente o nome do elemento. Converter o valor de retorno emElement. Defina um valor para o elementoPDFchamando seu métodosetAttribute. Anexe o elementoPDFao elementoPDFsFromBookmarks, chamando o métodoappendChilddo elementoPDFsFromBookmarks. Passe o objeto de elementoPDFcomo 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.Transformerinvocando o métodonewInstanceestático do objetojavax.xml.transform.Transformer. - Crie um objeto
Transformerinvocando o métodonewTransformerdo objetoTransformerFactory. - Crie um objeto
ByteArrayOutputStreamusando seu construtor. - Crie um objeto
javax.xml.transform.dom.DOMSourceusando seu construtor. Transmita o objetoorg.w3c.dom.Documentque representa o documento DDX. - Crie um objeto
javax.xml.transform.dom.DOMSourceusando seu construtor e transmitindo o objetoByteArrayOutputStream. - Preencha o objeto Java
ByteArrayOutputStreaminvocando o métodotransformdo objetojavax.xml.transform.Transformer. Passar os objetosjavax.xml.transform.dom.DOMSourceejavax.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
toByteArraydo objetoByteArrayOutputStream. - Crie um objeto
com.adobe.idp.Documentusando seu construtor e transmitindo a matriz de bytes.
- Crie um objeto
-
Referencie um documento do PDF para desmontar.
-
Crie um objeto
java.util.Mapusado para armazenar documentos de PDF de entrada usando um construtorHashMap. -
Crie um objeto
java.io.FileInputStreamusando seu construtor e transmitindo o local do documento PDF a ser desmontado. -
Crie um objeto
com.adobe.idp.Document. Passe o objetojava.io.FileInputStreamque contém o documento PDF a ser desmontado. -
Adicione uma entrada ao objeto
java.util.Mapinvocando seu métodopute 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.Documentque contém o documento PDF a ser desmontado.
- 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 é
-
-
Definir opções de tempo de execução.
- Crie um objeto
AssemblerOptionSpecque 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étodosetFailOnErrordo objetoAssemblerOptionSpece passefalse.
- Crie um objeto
-
Desmonte o documento PDF.
Invoque o método
invokeDDXdo objetoAssemblerServiceCliente passe os seguintes valores:- Um objeto
com.adobe.idp.Documentque representa o documento DDX criado dinamicamente - Um objeto
java.util.Mapque contém o documento PDF a ser desmontado - Um objeto
com.adobe.livecycle.assembler.client.AssemblerOptionSpecque 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
invokeDDXretorna um objetocom.adobe.livecycle.assembler.client.AssemblerResultque contém os documentos PDF desmontados e as exceções que ocorreram. - Um objeto
-
Salve os documentos de PDF desmontados.
Para obter os documentos de PDF desmontados, execute as seguintes ações:
- Invoque o método
getDocumentsdo objetoAssemblerResult. Este método retorna um objetojava.util.Map. - Repita o objeto
java.util.Mapaté encontrar o objetocom.adobe.idp.Documentresultante. - Invoque o método
copyToFiledo objetocom.adobe.idp.Documentpara extrair o documento PDF.
- Invoque o método