Creación dinámica de documentos DDX dynamically-creating-ddx-documents

Incluir archivos de proyecto.

Incluya archivos JAR de cliente, como adobe-assembler-client.jar, en la ruta de clase del proyecto Java.

Cree un cliente de PDF Assembler.

• Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
• Cree un objeto AssemblerServiceClient utilizando su constructor y pasando el objeto ServiceClientFactory.

Cree el documento DDX.

• Cree un objeto Java DocumentBuilderFactory llamando al método newInstance de la clase DocumentBuilderFactory.

• Cree un objeto Java DocumentBuilder llamando al método newDocumentBuilder del objeto DocumentBuilderFactory.

• Llame al método newDocument del objeto DocumentBuilder para crear una instancia de un objeto org.w3c.dom.Document.

• Cree el elemento raíz del documento DDX invocando el método createElement del objeto org.w3c.dom.Document. Este método crea un objeto Element que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. A continuación, establezca un valor para el elemento secundario llamando a su método setAttribute. Finalmente, agregue el elemento al elemento header llamando al método appendChild del elemento header y pase el objeto del elemento secundario como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

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

• Cree el elemento PDFsFromBookmarks llamando al método createElement del objeto Document. Pase un valor de cadena que represente el nombre del elemento al método createElement. Convertir el valor devuelto en Element. Establezca un valor para el elemento PDFsFromBookmarks llamando a su método setAttribute. Anexe el elemento PDFsFromBookmarks al elemento DDX llamando al método appendChild del elemento DDX. Pase el objeto de elemento PDFsFromBookmarks como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

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

• Cree un elemento PDF llamando al método createElement del objeto Document. Pase un valor de cadena que represente el nombre del elemento. Convertir el valor devuelto en Element. Establezca un valor para el elemento PDF llamando a su método setAttribute. Anexe el elemento PDF al elemento PDFsFromBookmarks llamando al método appendChild del elemento PDFsFromBookmarks. Pase el objeto de elemento PDF como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

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

Convierta el documento DDX.

• Cree un objeto javax.xml.transform.Transformer invocando el método newInstance estático del objeto javax.xml.transform.Transformer.
• Cree un objeto Transformer invocando el método newTransformer del objeto TransformerFactory.
• Crear un objeto ByteArrayOutputStream mediante su constructor.
• Crear un objeto javax.xml.transform.dom.DOMSource mediante su constructor. Pase el objeto org.w3c.dom.Document que representa el documento DDX.
• Cree un objeto javax.xml.transform.dom.DOMSource utilizando su constructor y pasando el objeto ByteArrayOutputStream.
• Rellene el objeto Java ByteArrayOutputStream invocando el método transform del objeto javax.xml.transform.Transformer. Pase los objetos javax.xml.transform.dom.DOMSource y javax.xml.transform.stream.StreamResult.
• Cree una matriz de bytes y asigne el tamaño del objeto ByteArrayOutputStream a la matriz de bytes.
• Rellene la matriz de bytes invocando el método toByteArray del objeto ByteArrayOutputStream.
• Cree un objeto com.adobe.idp.Document utilizando su constructor y pasando la matriz de bytes.

Hacer referencia a un documento de PDF para desmontar.

• Cree un objeto java.util.Map que se use para almacenar documentos del PDF de entrada usando un constructor HashMap.

• Cree un objeto java.io.FileInputStream utilizando su constructor y pasando la ubicación del documento de PDF que desea desmontar.

• Crear un objeto com.adobe.idp.Document. Pase el objeto java.io.FileInputStream que contiene el documento de PDF que se va a desmontar.

• Agregue una entrada al objeto java.util.Map invocando su método put y pasando los siguientes argumentos:

  • Valor de cadena que representa el nombre de clave. Este valor debe coincidir con el valor del elemento de origen PDF especificado en el documento DDX. (En el documento DDX creado dinámicamente, el valor es AssemblerResultPDF.pdf).
  • Objeto com.adobe.idp.Document que contiene el documento de PDF que se va a desmontar.

Establecer opciones en tiempo de ejecución.

• Cree un objeto AssemblerOptionSpec que almacene opciones en tiempo de ejecución mediante su constructor.
• Establezca opciones en tiempo de ejecución para satisfacer sus necesidades empresariales invocando un método que pertenezca al objeto AssemblerOptionSpec. Por ejemplo, para indicar al servicio Assembler que continúe procesando un trabajo cuando se produzca un error, invoque el método setFailOnError del objeto AssemblerOptionSpec y pase false.

Desmontar el documento del PDF.

Invoque el método invokeDDX del objeto AssemblerServiceClient y pase los siguientes valores:

• Un objeto com.adobe.idp.Document que representa el documento DDX creado dinámicamente
• Objeto java.util.Map que contiene el documento de PDF que se va a desmontar
• Un objeto com.adobe.livecycle.assembler.client.AssemblerOptionSpec que especifica las opciones en tiempo de ejecución, incluidas la fuente predeterminada y el nivel de registro del trabajo

El método invokeDDX devuelve un objeto com.adobe.livecycle.assembler.client.AssemblerResult que contiene los documentos de PDF desensamblados y las excepciones que se han producido.

Guarde los documentos del PDF desmontados.

Para obtener los documentos de PDF desmontados, realice las siguientes acciones:

• Invoque el método getDocuments del objeto AssemblerResult. Este método devuelve un objeto java.util.Map.
• Recorra en iteración el objeto java.util.Map hasta encontrar el objeto com.adobe.idp.Document resultante.
• Invoque el método copyToFile del objeto com.adobe.idp.Document para extraer el documento del PDF.

Incluir archivos de proyecto.

Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición de WSDL al establecer una referencia de servicio: http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

Cree un cliente de PDF Assembler.

• Cree un objeto AssemblerServiceClient utilizando su constructor predeterminado.

• Cree un objeto AssemblerServiceClient.Endpoint.Address mediante el constructor System.ServiceModel.EndpointAddress. Pase un valor de cadena que especifique el WSDL al servicio AEM Forms (por ejemplo, http://localhost:8080/soap/services/AssemblerService?blob=mtom). No necesita usar el atributo lc_version. Este atributo se utiliza al crear una referencia de servicio.

• Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo AssemblerServiceClient.Endpoint.Binding. Convertir el valor devuelto en BasicHttpBinding.

• Establezca el campo MessageEncoding del objeto System.ServiceModel.BasicHttpBinding en WSMessageEncoding.Mtom. Este valor garantiza que se utiliza MTOM.

• Habilite la autenticación HTTP básica realizando las siguientes tareas:

  • AEM Asigne el nombre de usuario de los formularios de la al campo AssemblerServiceClient.ClientCredentials.UserName.UserName.
  • Asigne el valor de contraseña correspondiente al campo AssemblerServiceClient.ClientCredentials.UserName.Password.
  • Asigne el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Asigne el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Cree el documento DDX.

• Crear un objeto System.Xml.XmlElement mediante su constructor.

• Cree el elemento raíz del documento DDX invocando el método CreateElement del objeto XmlElement. Este método crea un objeto Element que representa el elemento raíz. Pase un valor de cadena que represente el nombre del elemento al método CreateElement. Establezca un valor para el elemento DDX llamando a su método SetAttribute. Finalmente, anexe el elemento al documento DDX llamando al método AppendChild del objeto XmlElement. Pase el objeto DDX como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

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

• Cree el elemento PDFsFromBookmarks del documento DDX llamando al método CreateElement del objeto XmlElement. Pase un valor de cadena que represente el nombre del elemento al método CreateElement. A continuación, establezca un valor para el elemento llamando a su método SetAttribute. Anexe el elemento PDFsFromBookmarks al elemento raíz llamando al método AppendChild del elemento DDX. Pase el objeto de elemento PDFsFromBookmarks como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

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

• Cree el elemento PDF del documento DDX llamando al método CreateElement del objeto XmlElement. Pase un valor de cadena que represente el nombre del elemento al método CreateElement. A continuación, establezca un valor para el elemento secundario llamando a su método SetAttribute. Anexe el elemento PDF al elemento PDFsFromBookmarks llamando al método AppendChild del elemento PDFsFromBookmarks. Pase el objeto de elemento PDF como argumento. Las siguientes líneas de código muestran esta lógica de aplicación:

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

Convierta el documento DDX.

• Crear un objeto System.IO.MemoryStream mediante su constructor.

• Rellene el objeto MemoryStream con el documento DDX mediante el objeto XmlElement que representa el documento DDX. Invoque el método Save del objeto XmlElement y pase el objeto MemoryStream.

• Cree una matriz de bytes y rellénela con datos en el objeto MemoryStream. El siguiente código muestra esta lógica de aplicación:

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

• Crear un objeto BLOB. Asigne la matriz de bytes al campo MTOM del objeto BLOB.

Hacer referencia a un documento de PDF para desmontar.

• Crear un objeto BLOB mediante su constructor. El objeto BLOB se usa para almacenar el documento del PDF de entrada. Este objeto BLOB se pasó a invokeOneDocument como argumento.
• Cree un objeto System.IO.FileStream invocando su constructor. Pase un valor de cadena que represente la ubicación del archivo del documento del PDF de entrada y el modo en que se abrirá el archivo.
• Cree una matriz de bytes que almacene el contenido del objeto System.IO.FileStream. Puede determinar el tamaño de la matriz de bytes obteniendo la propiedad Length del objeto System.IO.FileStream.
• Rellene la matriz de bytes con datos de secuencia invocando el método Read del objeto System.IO.FileStream y pasando la matriz de bytes, la posición inicial y la longitud de secuencia para que se lea.
• Rellene el objeto BLOB asignando su propiedad MTOM al contenido de la matriz de bytes.

Establecer opciones en tiempo de ejecución.

• Cree un objeto AssemblerOptionSpec que almacene opciones en tiempo de ejecución mediante su constructor.
• Establezca las opciones en tiempo de ejecución para satisfacer sus necesidades comerciales asignando un valor a un miembro de datos que pertenezca al objeto AssemblerOptionSpec. Por ejemplo, para indicar al servicio Assembler que continúe procesando un trabajo cuando se produzca un error, asigne false al miembro de datos failOnError del objeto AssemblerOptionSpec.

Desmontar el documento del PDF.

Invoque el método invokeDDX del objeto AssemblerServiceClient y pase los siguientes valores:

• Un objeto BLOB que representa el documento DDX creado dinámicamente
• Matriz mapItem que contiene el documento del PDF de entrada
• Un objeto AssemblerOptionSpec que especifica opciones en tiempo de ejecución

El método invokeDDX devuelve un objeto AssemblerResult que contiene los resultados del trabajo y las excepciones que se han producido.

Guarde los documentos del PDF desmontados.

Para obtener los documentos del PDF recién creados, realice las siguientes acciones:

• Obtenga acceso al campo documents del objeto AssemblerResult, que es un objeto Map que contiene los documentos de PDF desensamblados.
• Recorra en iteración el objeto Map para obtener cada documento resultante. A continuación, convierta el value de ese miembro de la matriz en un BLOB.
• Extraiga los datos binarios que representan el documento de PDF al tener acceso a la propiedad MTOM de su objeto BLOB. Devuelve una matriz de bytes que puede escribir en un archivo PDF.