Exemplos e exemplos neste documento são apenas para AEM Forms no ambiente JEE.
Você pode criar dinamicamente um documento DDX que pode ser usado para executar uma operação do Assembler. A criação dinâmica de um documento DX permite usar valores no documento DDX obtidos durante o tempo de execução. Para criar dinamicamente um documento DX, use classes que pertencem à linguagem de programação que você está usando. Por exemplo, se você estiver desenvolvendo seu aplicativo cliente usando Java, use classes que pertencem ao pacote org.w3c.dom.*
. Da mesma forma, se você estiver usando o Microsoft .NET, use classes que pertencem à namespace System.Xml
.
Antes de poder passar o documento DDX para o serviço Assembler, converta o XML de uma instância org.w3c.dom.Document
para uma instância com.adobe.idp.Document
. Se você estiver usando serviços da Web, converta o XML do tipo de dados usado para criar o XML (por exemplo, XmlDocument
) para uma instância BLOB
.
Para essa discussão, considere que o seguinte documento DDX foi criado dinamicamente.
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDFsFromBookmarks prefix="stmt">
<PDF source="AssemblerResultPDF.pdf"/>
</PDFsFromBookmarks>
</DDX>
Este documento DDX desmonta um documento PDF. É recomendável que você esteja familiarizado com a desmontagem de documentos PDF.
Para obter mais informações sobre o serviço Assembler, consulte Referência de serviços para AEM Forms.
Para obter mais informações sobre um documento DDX, consulte Assembler Service e DDX Reference.
Para desmontar um documento PDF usando um documento DX criado dinamicamente, execute as seguintes tarefas:
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 caminho de classe do seu projeto:
Criar um cliente de Montador de PDF
Antes de executar programaticamente uma operação de Assembler, crie um cliente de serviço de 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 você estiver usando a API Java. Se você estiver usando serviços da 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 da Web, converta o documento DDX em um objeto BLOB
.
Referência a 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 uma tarefa. Por exemplo, você pode definir uma opção que instrui o serviço Assembler a continuar processando uma tarefa se um erro for encontrado. Para definir opções de tempo de execução, use um objeto AssemblerOptionSpec
.
Desmonte o documento PDF
Desmonte o documento PDF chamando a operação invokeDDX
. Passe o documento DDX que foi criado dinamicamente. O serviço Assembler retorna documentos PDF desmontados em um objeto de coleção.
Salve os documentos PDF desmontados
Todos os documentos PDF desmontados são retornados dentro de um objeto de coleção. Insira o objeto de coleção e salve cada documento PDF como um arquivo PDF.
Consulte também:
Criar dinamicamente um documento DX usando a API Java
Criar dinamicamente um documento DX usando a API de serviço da Web
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Desmontagem programática de Documentos PDF
Crie dinamicamente um documento DX 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 seu projeto Java.
Crie um cliente do Montador de PDF.
ServiceClientFactory
que contenha propriedades de conexão.AssemblerServiceClient
usando seu construtor e transmitindo o objeto ServiceClientFactory
.Crie o documento DDX.
Crie um objeto Java DocumentBuilderFactory
chamando o método DocumentBuilderFactory
class' newInstance
.
Crie um objeto Java DocumentBuilder
chamando o método DocumentBuilderFactory
do objeto newDocumentBuilder
.
Chame o método DocumentBuilder
do objeto newDocument
para instanciar um objeto org.w3c.dom.Document
.
Crie o elemento raiz do documento DDX chamando o método org.w3c.dom.Document
do objeto createElement
. Este método cria um objeto Element
que representa o elemento raiz. Passe um valor de string representando o nome do elemento para o método createElement
. Converta o valor de retorno em Element
. Em seguida, defina um valor para o elemento filho chamando seu método setAttribute
. Finalmente, acrescente o elemento ao elemento header chamando o método appendChild
do elemento header e transmita o objeto de elemento filho como um argumento. As seguintes linhas de código mostram essa lógica de aplicativo:
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 Document
do objeto createElement
. Passe um valor de string representando o nome do elemento para o método createElement
. Converta 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 DX. Passe o objeto do elemento PDFsFromBookmarks
como um argumento. As seguintes linhas de código mostram essa lógica de aplicativo:
Element PDFsFromBookmarks = (Element)document.createElement("PDFsFromBookmarks"); PDFsFromBookmarks.setAttribute("prefix","stmt"); root.appendChild(PDFsFromBookmarks);
Crie um elemento PDF
chamando o método Document
do objeto createElement
. Passe um valor de string que representa o nome do elemento. Converta 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 PDFsFromBookmarks
do elemento appendChild
. Passe o objeto do elemento PDF
como um argumento. As seguintes linhas de código mostram essa lógica de aplicativo:
Element PDF = (Element)document.createElement("PDF"); PDF.setAttribute("source","AssemblerResultPDF.pdf"); PDFsFromBookmarks.appendChild(PDF);
Converta o documento DDX.
javax.xml.transform.Transformer
chamando o método estático javax.xml.transform.Transformer
do objeto newInstance
.Transformer
invocando o método TransformerFactory
do objeto newTransformer
.ByteArrayOutputStream
usando seu construtor.javax.xml.transform.dom.DOMSource
usando seu construtor. Passe o objeto org.w3c.dom.Document
que representa o documento DDX.javax.xml.transform.dom.DOMSource
usando seu construtor e transmitindo o objeto ByteArrayOutputStream
.ByteArrayOutputStream
chamando o método javax.xml.transform.Transformer
do objeto transform
. Passe os objetos javax.xml.transform.dom.DOMSource
e javax.xml.transform.stream.StreamResult
.ByteArrayOutputStream
na matriz de bytes.ByteArrayOutputStream
do objeto toByteArray
.com.adobe.idp.Document
usando seu construtor e transmitindo a matriz de bytes.Consulte um documento PDF para desmontar.
Crie um objeto java.util.Map
usado para armazenar documentos 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 para desmontar.
Adicione uma entrada ao objeto java.util.Map
invocando seu método put
e transmitindo os seguintes argumentos:
AssemblerResultPDF.pdf
.)com.adobe.idp.Document
que contém o documento PDF a ser desmontado.Defina as opções de tempo de execução.
AssemblerOptionSpec
que armazene opções de tempo de execução usando seu construtor.AssemblerOptionSpec
. Por exemplo, para instruir o serviço Assembler a continuar processando uma tarefa quando ocorrer um erro, chame o método AssemblerOptionSpec
do objeto setFailOnError
e passe false
.Desmonte o documento PDF.
Chame o método AssemblerServiceClient
do objeto invokeDDX
e passe os seguintes valores:
com.adobe.idp.Document
que representa o documento DDX criado dinamicamentejava.util.Map
que contém o documento PDF a ser desmontadocom.adobe.livecycle.assembler.client.AssemblerOptionSpec
que especifica as opções de tempo de execução, incluindo a fonte padrão e o nível do log de trabalhosO método invokeDDX
retorna um objeto com.adobe.livecycle.assembler.client.AssemblerResult
que contém os documentos PDF desmontados e quaisquer exceções que ocorreram.
Salve os documentos PDF desmontados.
Para obter os documentos PDF desmontados, execute as seguintes ações:
AssemblerResult
do objeto getDocuments
. Este método retorna um objeto java.util.Map
.java.util.Map
até encontrar o objeto com.adobe.idp.Document
resultante.com.adobe.idp.Document
do objeto copyToFile
para extrair o documento PDF.Consulte também:
Start rápido (modo SOAP): Criação dinâmica de um documento DX usando a API Java
Incluindo arquivos da biblioteca Java AEM Forms
Configuração das propriedades de conexão
Crie dinamicamente um documento DX e desmonte um documento PDF usando a API de serviço do Assembler (serviço da Web):
Incluir arquivos de projeto.
Crie um projeto do 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
.
Substitua localhost
pelo endereço IP do servidor que hospeda o AEM Forms.
Crie um cliente do Montador de PDF.
Crie um objeto AssemblerServiceClient
usando seu construtor padrão.
Crie um objeto AssemblerServiceClient.Endpoint.Address
usando o construtor System.ServiceModel.EndpointAddress
. Passe um valor de string que especifica o WSDL para o serviço AEM Forms (por exemplo, http://localhost:8080/soap/services/AssemblerService?blob=mtom
). Não é necessário usar o atributo lc_version
. Esse atributo é usado ao criar uma referência de serviço.
Crie um objeto System.ServiceModel.BasicHttpBinding
obtendo o valor do campo AssemblerServiceClient.Endpoint.Binding
. Converta o valor de retorno em BasicHttpBinding
.
Defina o campo System.ServiceModel.BasicHttpBinding
MessageEncoding
do objeto como WSMessageEncoding.Mtom
. Esse valor garante que o MTOM seja usado.
Ative a autenticação HTTP básica executando as seguintes tarefas:
AssemblerServiceClient.ClientCredentials.UserName.UserName
.AssemblerServiceClient.ClientCredentials.UserName.Password
.HttpClientCredentialType.Basic
ao campo BasicHttpBindingSecurity.Transport.ClientCredentialType
.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 chamando o método XmlElement
do objeto CreateElement
. Este método cria um objeto Element
que representa o elemento raiz. Passe um valor de string representando o nome do elemento para o método CreateElement
. Defina um valor para o elemento DDX chamando seu método SetAttribute
. Finalmente, acrescente o elemento ao documento DDX chamando o método XmlElement
do objeto AppendChild
. Passe o objeto DDX como um argumento. As seguintes linhas de código mostram essa lógica de aplicativo:
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 DX chamando o método XmlElement
CreateElement
do objeto. Passe um valor de string representando 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 DDX
do elemento AppendChild
. Passe o objeto do elemento PDFsFromBookmarks
como um argumento. As seguintes linhas de código mostram essa lógica de aplicativo:
XmlElement PDFsFromBookmarks = ddx.CreateElement("PDFsFromBookmarks"); PDFsFromBookmarks.SetAttribute("prefix", "stmt"); root.AppendChild(PDFsFromBookmarks);
Crie o elemento PDF
do documento DX chamando o método XmlElement
CreateElement
do objeto. Passe um valor de string representando 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 PDFsFromBookmarks
do elemento AppendChild
. Passe o objeto do elemento PDF
como um argumento. As seguintes linhas de código mostram essa lógica de aplicativo:
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 DX. Chame o método XmlElement
do objeto Save
e passe o objeto MemoryStream
.
Crie uma matriz de bytes e preencha-a com dados localizados no objeto MemoryStream
. O código a seguir mostra esta lógica do aplicativo:
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 BLOB
do objeto MTOM
.
Consulte um documento PDF para desmontar.
BLOB
usando seu construtor. O objeto BLOB
é usado para armazenar o documento PDF de entrada. Esse objeto BLOB
é passado para invokeOneDocument
como um argumento.System.IO.FileStream
chamando seu construtor. Passe um valor de string que representa o local do arquivo do documento PDF de entrada 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 transmitindo a matriz de bytes, a posição inicial e o comprimento do fluxo para leitura.BLOB
atribuindo a propriedade MTOM
ao conteúdo da matriz de bytes.Defina as opções de tempo de execução.
AssemblerOptionSpec
que armazene opções de tempo de execução usando seu construtor.AssemblerOptionSpec
. Por exemplo, para instruir o serviço Assembler a continuar processando um trabalho quando ocorrer um erro, atribua false
ao membro de dados AssemblerOptionSpec
do objeto failOnError
.Desmonte o documento PDF.
Chame o método AssemblerServiceClient
do objeto invokeDDX
e passe os seguintes valores:
BLOB
que representa o documento DDX criado dinamicamentemapItem
que contém o documento PDF de entradaAssemblerOptionSpec
que especifica opções de tempo de execuçãoO método invokeDDX
retorna um objeto AssemblerResult
que contém os resultados do trabalho e quaisquer exceções que ocorreram.
Salve os documentos PDF desmontados.
Para obter os documentos PDF recém-criados, execute as seguintes ações:
AssemblerResult
do objeto documents
, que é um objeto Map
que contém os documentos PDF desmontados.Map
para obter cada documento resultante. Em seguida, converta value
desse membro da matriz em BLOB
.BLOB
do objeto MTOM
. Isso retorna uma matriz de bytes que você pode gravar em um arquivo PDF.Consulte também:
Invocar o AEM Forms usando o MTOM
Invocando o AEM Forms usando SwaRef