Creazione dinamica di documenti DDX dynamically-creating-ddx-documents

Includi file di progetto.

Includi i file JAR client, come adobe-assembler-client.jar, nel percorso di classe del progetto Java.

Creare un client PDF Assembler.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto AssemblerServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Creare il documento DDX.

• Creare un oggetto Java DocumentBuilderFactory chiamando il metodo newInstance della classe DocumentBuilderFactory.

• Creare un oggetto Java DocumentBuilder chiamando il metodo newDocumentBuilder dell'oggetto DocumentBuilderFactory.

• Chiamare il metodo newDocument dell'oggetto DocumentBuilder per creare un'istanza di un oggetto org.w3c.dom.Document.

• Creare l'elemento radice del documento DDX richiamando il metodo createElement dell'oggetto org.w3c.dom.Document. Questo metodo crea un oggetto Element che rappresenta l'elemento radice. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Impostare quindi un valore per l'elemento figlio chiamando il relativo metodo setAttribute. Infine, accodare l'elemento all'elemento header chiamando il metodo appendChild dell'elemento header e passare l'oggetto elemento figlio come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

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

• Creare l'elemento PDFsFromBookmarks chiamando il metodo createElement dell'oggetto Document. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Impostare un valore per l'elemento PDFsFromBookmarks chiamando il relativo metodo setAttribute. Aggiungere l'elemento PDFsFromBookmarks all'elemento DDX chiamando il metodo appendChild dell'elemento DDX. Passa l'oggetto elemento PDFsFromBookmarks come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

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

• Creare un elemento PDF chiamando il metodo createElement dell'oggetto Document. Passa un valore stringa che rappresenta il nome dell’elemento. Eseguire il cast del valore restituito in Element. Impostare un valore per l'elemento PDF chiamando il relativo metodo setAttribute. Aggiungere l'elemento PDF all'elemento PDFsFromBookmarks chiamando il metodo appendChild dell'elemento PDFsFromBookmarks. Passa l'oggetto elemento PDF come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

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

Converte il documento DDX.

• Creare un oggetto javax.xml.transform.Transformer richiamando il metodo newInstance statico dell'oggetto javax.xml.transform.Transformer.
• Creare un oggetto Transformer richiamando il metodo newTransformer dell'oggetto TransformerFactory.
• Creare un oggetto ByteArrayOutputStream utilizzando il relativo costruttore.
• Creare un oggetto javax.xml.transform.dom.DOMSource utilizzando il relativo costruttore. Passa l'oggetto org.w3c.dom.Document che rappresenta il documento DDX.
• Creare un oggetto javax.xml.transform.dom.DOMSource utilizzando il relativo costruttore e passando l'oggetto ByteArrayOutputStream.
• Compilare l'oggetto Java ByteArrayOutputStream richiamando il metodo transform dell'oggetto javax.xml.transform.Transformer. Passa gli oggetti javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult.
• Creare una matrice di byte e allocare le dimensioni dell'oggetto ByteArrayOutputStream alla matrice di byte.
• Compilare la matrice di byte richiamando il metodo toByteArray dell'oggetto ByteArrayOutputStream.
• Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando la matrice di byte.

Fare riferimento a un documento PDF da disassemblare.

• Creare un oggetto java.util.Map utilizzato per memorizzare i documenti di input PDF utilizzando un costruttore HashMap.

• Creare un oggetto java.io.FileInputStream utilizzando il relativo costruttore e passando la posizione del documento PDF da disassemblare.

• Creare un oggetto com.adobe.idp.Document. Passa l'oggetto java.io.FileInputStream che contiene il documento PDF da disassemblare.

• Aggiungere una voce all'oggetto java.util.Map richiamando il relativo metodo put e passando i seguenti argomenti:

  • Valore stringa che rappresenta il nome della chiave. Questo valore deve corrispondere al valore dell'elemento di origine PDF specificato nel documento DDX. Nel documento DDX creato in modo dinamico, il valore è AssemblerResultPDF.pdf.
  • Oggetto com.adobe.idp.Document contenente il documento PDF da disassemblare.

Impostare le opzioni di runtime.

• Creare un oggetto AssemblerOptionSpec che memorizza le opzioni di runtime utilizzando il relativo costruttore.
• Impostare le opzioni di runtime per soddisfare i requisiti aziendali richiamando un metodo che appartiene all'oggetto AssemblerOptionSpec. Ad esempio, per indicare al servizio Assembler di continuare a elaborare un processo quando si verifica un errore, richiamare il metodo setFailOnError dell'oggetto AssemblerOptionSpec e passare false.

Disassemblare il documento PDF.

Richiama il metodo invokeDDX dell'oggetto AssemblerServiceClient e passa i seguenti valori:

• Oggetto com.adobe.idp.Document che rappresenta il documento DDX creato in modo dinamico
• Oggetto java.util.Map contenente il documento PDF da disassemblare
• Oggetto com.adobe.livecycle.assembler.client.AssemblerOptionSpec che specifica le opzioni di runtime, inclusi il tipo di carattere predefinito e il livello del log del processo

Il metodo invokeDDX restituisce un oggetto com.adobe.livecycle.assembler.client.AssemblerResult contenente i documenti PDF disassemblati ed eventuali eccezioni.

Salvare i documenti PDF disassemblati.

Per ottenere i documenti PDF disassemblati, effettuare le seguenti operazioni:

• Richiama il metodo getDocuments dell'oggetto AssemblerResult. Questo metodo restituisce un oggetto java.util.Map.
• Scorrere l'oggetto java.util.Map fino a trovare l'oggetto com.adobe.idp.Document risultante.
• Richiama il metodo copyToFile dell'oggetto com.adobe.idp.Document per estrarre il documento PDF.

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL durante l'impostazione di un riferimento al servizio: http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

Creare un client PDF Assembler.

• Creare un oggetto AssemblerServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto AssemblerServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/AssemblerService?blob=mtom). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo AssemblerServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo AssemblerServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo AssemblerServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Creare il documento DDX.

• Creare un oggetto System.Xml.XmlElement utilizzando il relativo costruttore.

• Creare l'elemento radice del documento DDX richiamando il metodo CreateElement dell'oggetto XmlElement. Questo metodo crea un oggetto Element che rappresenta l'elemento radice. Passa un valore stringa che rappresenta il nome dell'elemento al metodo CreateElement. Impostare un valore per l'elemento DDX chiamando il relativo metodo SetAttribute. Aggiungere infine l'elemento al documento DDX chiamando il metodo AppendChild dell'oggetto XmlElement. Passa l'oggetto DDX come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

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

• Creare l'elemento PDFsFromBookmarks del documento DDX chiamando il metodo CreateElement dell'oggetto XmlElement. Passa un valore stringa che rappresenta il nome dell'elemento al metodo CreateElement. Quindi, impostare un valore per l'elemento chiamando il relativo metodo SetAttribute. Aggiungere l'elemento PDFsFromBookmarks all'elemento radice chiamando il metodo AppendChild dell'elemento DDX. Passa l'oggetto elemento PDFsFromBookmarks come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

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

• Creare l'elemento PDF del documento DDX chiamando il metodo CreateElement dell'oggetto XmlElement. Passa un valore stringa che rappresenta il nome dell'elemento al metodo CreateElement. Impostare quindi un valore per l'elemento figlio chiamando il relativo metodo SetAttribute. Aggiungere l'elemento PDF all'elemento PDFsFromBookmarks chiamando il metodo AppendChild dell'elemento PDFsFromBookmarks. Passa l'oggetto elemento PDF come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

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

Converte il documento DDX.

• Creare un oggetto System.IO.MemoryStream utilizzando il relativo costruttore.

• Compilare l'oggetto MemoryStream con il documento DDX utilizzando l'oggetto XmlElement che rappresenta il documento DDX. Richiama il metodo Save dell'oggetto XmlElement e passa l'oggetto MemoryStream.

• Creare una matrice di byte e popolarla con i dati nell'oggetto MemoryStream. Il codice seguente mostra questa logica dell’applicazione:

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

• Creare un oggetto BLOB. Assegnare la matrice di byte al campo MTOM dell'oggetto BLOB.

Fare riferimento a un documento PDF da disassemblare.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento PDF di input. Questo oggetto BLOB è passato a invokeOneDocument come argomento.
• Creare un oggetto System.IO.FileStream richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF di input e la modalità di apertura del file.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando alla relativa proprietà MTOM il contenuto della matrice di byte.

Impostare le opzioni di runtime.

• Creare un oggetto AssemblerOptionSpec che memorizza le opzioni di runtime utilizzando il relativo costruttore.
• Impostare le opzioni di runtime per soddisfare i requisiti aziendali assegnando un valore a un membro dati che appartiene all'oggetto AssemblerOptionSpec. Ad esempio, per indicare al servizio Assembler di continuare a elaborare un processo quando si verifica un errore, assegnare false al membro dati failOnError dell'oggetto AssemblerOptionSpec.

Disassemblare il documento PDF.

Richiama il metodo invokeDDX dell'oggetto AssemblerServiceClient e passa i seguenti valori:

• Oggetto BLOB che rappresenta il documento DDX creato in modo dinamico
• Array mapItem contenente il documento PDF di input
• Oggetto AssemblerOptionSpec che specifica le opzioni di runtime

Il metodo invokeDDX restituisce un oggetto AssemblerResult contenente i risultati del processo ed eventuali eccezioni.

Salvare i documenti PDF disassemblati.

Per ottenere i documenti di PDF appena creati, effettuare le seguenti operazioni:

• Accedere al campo documents dell'oggetto AssemblerResult, che è un oggetto Map contenente i documenti PDF disassemblati.
• Scorrere l'oggetto Map per ottenere ogni documento risultante. Quindi, eseguire il cast di value del membro dell'array in un BLOB.
• Estrarre i dati binari che rappresentano il documento PDF accedendo alla proprietà MTOM dell'oggetto BLOB. Restituisce una matrice di byte che è possibile scrivere in un file PDF.