Dynamisches Erstellen von DDX-Dokumenten dynamically-creating-ddx-documents

Schließen Sie Projektdateien ein.

Fügen Sie Client-JAR-Dateien wie „adobe-assembler-client.jar“ in den Klassenpfad Ihres Java-Projekts ein.

Erstellen Sie einen PDF Assembler-Client.

• Erstellen Sie ein ServiceClientFactory-Objekt, das Verbindungseigenschaften enthält.
• Erstellen Sie ein AssemblerServiceClient-Objekt, indem Sie seinen Konstruktor verwenden und das ServiceClientFactory-Objekt übergeben.

Erstellen Sie das DDX-Dokument.

• Erstellen Sie ein Java-Objekt vom Typ DocumentBuilderFactory, indem Sie die Methode newInstance der Klasse DocumentBuilderFactory aufrufen.

• Erstellen Sie ein Java-Objekt vom Typ DocumentBuilder, indem Sie die Methode newDocumentBuilder des DocumentBuilderFactory-Objekts aufrufen.

• Rufen Sie die Methode newDocument des Objekts DocumentBuilder auf, um ein Objekt org.w3c.dom.Document zu instantiieren.

• Erstellen Sie das Stammelement des DDX-Dokuments, indem Sie die Methode createElement des Objekts org.w3c.dom.Document aufrufen. Diese Methode erstellt ein Element-Objekt, das das Stammelement darstellt. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die Methode createElement. Wandeln Sie den Rückgabewert in Element um. Legen Sie anschließend einen Wert für das untergeordnete Element fest, indem Sie dessen Methode setAttribute aufrufen. Fügen Sie schließlich das Element an das Kopfzeilenelement an, indem Sie die Methode appendChild des Kopfzeilenelements aufrufen und das Objekt des untergeordneten Elements als Argument weitergeben. Die folgenden Code-Zeilen zeigen diese Programmlogik:
   Element root = (Element)document.createElement("DDX");  root.setAttribute("xmlns","https://ns.adobe.com/DDX/1.0/");  document.appendChild(root);

• Erstellen Sie das Element PDFsFromBookmarks, indem Sie die Methode createElement des Objekts Document aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die Methode createElement. Wandeln Sie den Rückgabewert in Element um. Legen Sie einen Wert für das Element PDFsFromBookmarks fest, indem Sie seine setAttribute-Methode aufrufen. Fügen Sie das Element PDFsFromBookmarks an das Element DDX an, indem Sie die Methode appendChild des DDX-Elements aufrufen. Übergeben Sie das PDFsFromBookmarks-Elementobjekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

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

• Erstellen Sie ein Element PDF, indem Sie die Methode createElement des Objekts Document aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt. Wandeln Sie den Rückgabewert in Element um. Legen Sie einen Wert für das Element PDF fest, indem Sie seine setAttribute-Methode aufrufen. Fügen Sie das Element PDF an das Element PDFsFromBookmarks an, indem Sie die Methode appendChild des Elements PDFsFromBookmarks aufrufen. Übergeben Sie das PDF-Elementobjekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

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

Konvertieren Sie das DDX-Dokument.

• Erstellen Sie ein Objekt vom Typ javax.xml.transform.Transformer, indem Sie die statische Methode newInstance des Objekts javax.xml.transform.Transformer aufrufen.
• Erstellen Sie ein Objekt vom Typ Transformer, indem Sie die Methode newTransformer des Objekts TransformerFactory aufrufen.
• Erstellen Sie ein Objekt ByteArrayOutputStream, indem Sie den Konstruktor verwenden.
• Erstellen Sie ein Objekt javax.xml.transform.dom.DOMSource, indem Sie den Konstruktor verwenden. Übergeben Sie das org.w3c.dom.Document-Objekt, das das DDX-Dokument darstellt.
• Erstellen Sie ein javax.xml.transform.dom.DOMSource-Objekt, indem Sie seinen Konstruktor verwenden und das ByteArrayOutputStream-Objekt übergeben.
• Füllen Sie das Java-Objekt ByteArrayOutputStream auf, indem Sie die Methode transform des Objekts javax.xml.transform.Transformer aufrufen. Übergeben Sie das javax.xml.transform.dom.DOMSource- und das javax.xml.transform.stream.StreamResult-Objekt.
• Erstellen Sie ein Byte-Array und weisen Sie diesem die Größe des ByteArrayOutputStream-Objekts zu.
• Füllen Sie das Byte-Array auf, indem Sie die Methode toByteArray des Objekts ByteArrayOutputStream aufrufen.
• Erstellen Sie ein com.adobe.idp.Document-Objekt, indem Sie dessen Konstruktor verwenden und das Byte-Array übergeben.

Referenzieren Sie ein zu zerlegendes PDF-Dokument.

• Erstellen Sie ein java.util.Map-Objekt, das zum Speichern von PDF-Eingabedokumenten verwendet wird, indem Sie einen HashMap-Konstruktor verwenden.

• Erstellen Sie ein java.io.FileInputStream-Objekt, indem Sie seinen Konstruktor verwenden und den Speicherort des zu zerlegenden PDF-Dokuments übergeben.

• Erstellen Sie ein com.adobe.idp.Document-Objekt. Übergeben Sie das java.io.FileInputStream-Objekt, das das zu zerlegende PDF-Dokument enthält.

• Fügen Sie dem java.util.Map-Objekt einen Eintrag hinzu, indem Sie seine Methode put aufrufen und die folgenden Argumente übergeben:

  • Eine Zeichenfolge, die den Speichernamen repräsentiert. Dieser Wert muss mit dem Wert des im DDX-Dokument angegebenen PDF-Quellelements übereinstimmen. (Im dynamisch erstellten DDX-Dokument lautet der Wert AssemblerResultPDF.pdf.)
  • Ein com.adobe.idp.Document-Objekt, das das zu zerlegende PDF-Dokument enthält.

Legen Sie Laufzeitoptionen fest.

• Erstellen Sie ein AssemblerOptionSpec-Objekt, das Laufzeitoptionen speichert, indem Sie seinen Konstruktor verwenden.
• Legen Sie Laufzeitoptionen fest, um Ihre Geschäftsanforderungen zu erfüllen, indem Sie eine Methode aufrufen, die zum AssemblerOptionSpec-Objekt gehört. Um beispielsweise den Assembler-Dienst anzuweisen, die Verarbeitung eines Vorgangs im Falle eines Fehlers fortzusetzen, rufen Sie die Methode setFailOnError des Objekts AssemblerOptionSpec auf und geben Sie false weiter.

Zerlegen Sie das PDF-Dokument.

Rufen Sie die Methode invokeDDX des Objekts AssemblerServiceClient auf und geben Sie die folgenden Werte weiter:

• Ein com.adobe.idp.Document-Objekt, das das dynamisch erstellte DDX-Dokument darstellt
• Ein java.util.Map-Objekt, das das zu zerlegende PDF-Dokument enthält
• Ein com.adobe.livecycle.assembler.client.AssemblerOptionSpec-Objekt, das die Laufzeitoptionen angibt, einschließlich der Standardschrift und der Auftragsprotokollebene

Die invokeDDX-Methode gibt ein com.adobe.livecycle.assembler.client.AssemblerResult-Objekt zurück, das die zerlegten PDF-Dokumente und alle aufgetretenen Ausnahmen enthält.

Speichern Sie die zerlegten PDF-Dokumente.

Führen Sie die folgenden Schritte aus, um die zerlegten PDF-Dokumente abzurufen:

• Rufen Sie die Methode getDocuments des Objekts AssemblerResult auf. Diese Methode gibt ein java.util.Map-Objekt zurück.
• Iterieren Sie durch das java.util.Map-Objekt, bis Sie das resultierende com.adobe.idp.Document-Objekt finden.
• Rufen Sie die Methode copyToFile des Objekts com.adobe.idp.Document auf, um das PDF-Dokument zu extrahieren.

Schließen Sie Projektdateien ein.

Erstellen Sie ein Microsoft .NET-Projekt, das MTOM verwendet. Stellen Sie sicher, dass Sie beim Festlegen einer Service-Referenz die folgende WSDL-Definition verwenden: http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

Erstellen Sie einen PDF Assembler-Client.

• Erstellen Sie ein AssemblerServiceClient-Objekt, indem Sie seinen standardmäßigen Konstruktor verwenden.

• Erstellen Sie ein AssemblerServiceClient.Endpoint.Address -Objekt mithilfe des System.ServiceModel.EndpointAddress-Konstruktors. Übergeben Sie einen Zeichenfolgenwert mit der WSDL an den AEM Forms-Service (z. B. http://localhost:8080/soap/services/AssemblerService?blob=mtom). Sie müssen das lc_version-Attribut nicht verwenden. Dieses Attribut wird verwendet, wenn Sie einen Service-Verweis erstellen.

• Erstellen Sie ein System.ServiceModel.BasicHttpBinding-Objekr, indem Sie den Wert des Felds AssemblerServiceClient.Endpoint.Binding abrufen. Wandeln Sie den Rückgabewert in BasicHttpBinding um.

• Stellen Sie das Feld MessageEncoding des Objekts System.ServiceModel.BasicHttpBinding auf WSMessageEncoding.Mtom ein. Dieser Wert stellt sicher, dass MTOM verwendet wird.

• Aktivieren Sie die einfache HTTP-Authentifizierung, indem Sie die folgenden Schritte ausführen:

  • Weisen Sie dem Feld AssemblerServiceClient.ClientCredentials.UserName.UserName den AEM Forms-Benutzernamen zu.
  • Weisen Sie dem Feld AssemblerServiceClient.ClientCredentials.UserName.Password den entsprechenden Passwortwert zu.
  • Weisen Sie dem Feld BasicHttpBindingSecurity.Transport.ClientCredentialType den konstanten Wert HttpClientCredentialType.Basic zu.
  • Weisen Sie den Konstantenwert BasicHttpSecurityMode.TransportCredentialOnly zum BasicHttpBindingSecurity.Security.Mode-Feld zu.

Erstellen Sie das DDX-Dokument.

• Erstellen Sie ein Objekt System.Xml.XmlElement, indem Sie den Konstruktor verwenden.

• Erstellen Sie das Stammelement des DDX-Dokuments, indem Sie die Methode CreateElement des Objekts XmlElement aufrufen. Diese Methode erstellt ein Element-Objekt, das das Stammelement darstellt. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die CreateElement-Methode. Legen Sie einen Wert für das DDX-Element fest, indem Sie dessen SetAttribute-Methode aufrufen. Fügen Sie abschließend das Element an das DDX-Dokument an, indem Sie die Methode AppendChild des Objekts XmlElement aufrufen. Übergeben Sie das DDX-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

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

• Erstellen Sie das Element PDFsFromBookmarks des DDX-Dokuments, indem Sie die Methode CreateElement des Objekts XmlElement aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die CreateElement-Methode. Legen Sie anschließend einen Wert für das Element fest, indem Sie dessen SetAttribute-Methode aufrufen. Fügen Sie das Element PDFsFromBookmarks an das Stammelement an, indem Sie die Methode AppendChild des Elements DDX aufrufen. Übergeben Sie das PDFsFromBookmarks-Elementobjekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

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

• Erstellen Sie das Element PDF des DDX-Dokuments, indem Sie die Methode CreateElement des Objekts XmlElement aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die CreateElement-Methode. Legen Sie anschließend einen Wert für das untergeordnete Element fest, indem Sie dessen SetAttribute-Methode aufrufen. Fügen Sie das Element PDF an das Element PDFsFromBookmarks an, indem Sie die Methode AppendChild des Elements PDFsFromBookmarks aufrufen. Übergeben Sie das PDF-Elementobjekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

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

Konvertieren Sie das DDX-Dokument.

• Erstellen Sie ein Objekt System.IO.MemoryStream, indem Sie den Konstruktor verwenden.

• Füllen Sie das MemoryStream-Objekt mit dem DDX-Dokument, indem Sie das XmlElement-Objekt verwenden, das das DDX-Dokument darstellt. Rufen Sie die Methode Save des XmlElement-Objekts auf und übergeben Sie das MemoryStream-Objekt.

• Erstellen Sie ein Byte-Array und füllen Sie es mit den Daten im MemoryStream-Objekt. Der folgende Code zeigt diese Programmlogik:

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

• Erstellen Sie ein BLOB-Objekt. Weisen Sie das Byte-Array dem Feld MTOM des Objekts BLOB zu.

Referenzieren Sie ein zu zerlegendes PDF-Dokument.

• Erstellen Sie ein Objekt BLOB, indem Sie den Konstruktor verwenden. Das BLOB-Objekt wird zum Speichern des PDF-Eingabedokuments verwendet. Dieses BLOB-Objekt wird an invokeOneDocument als Argument übergeben.
• Erstellen Sie ein System.IO.FileStream-Objekt, indem Sie dessen Konstruktor aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Speicherort des PDF-Eingabedokuments und den Modus darstellt, in dem die Datei geöffnet werden soll.
• Erstellen Sie ein Byte-Array, das den Inhalt des System.IO.FileStream-Objekts speichert. Sie können die Größe des Byte-Arrays ermitteln, indem Sie die Eigenschaft Length des Objekts System.IO.FileStream abrufen.
• Füllen Sie das Byte-Array mit Stream-Daten auf, indem Sie die Methode Read des Objekts System.IO.FileStream verwenden und das Byte-Array, die Startposition und die zu lesende Stream-Länge weitergeben.
• Füllen Sie das BLOB-Objekt, indem Sie seiner MTOM-Eigenschaft den Inhalt des Byte-Arrays zuweisen.

Legen Sie Laufzeitoptionen fest.

• Erstellen Sie ein AssemblerOptionSpec-Objekt, das Laufzeitoptionen speichert, indem Sie seinen Konstruktor verwenden.
• Legen Sie Laufzeitoptionen fest, um Ihre Geschäftsanforderungen zu erfüllen, indem Sie einem Datenelement, das zum AssemblerOptionSpec-Objekt gehört, einen Wert zuweisen. Um beispielsweise den Assembler-Dienst anzuweisen, die Verarbeitung eines Vorgangs im Falle eines Fehlers fortzusetzen, weisen Sie false dem Datenelement failOnError des Objekts AssemblerOptionSpec zu.

Zerlegen Sie das PDF-Dokument.

Rufen Sie die Methode invokeDDX des Objekts AssemblerServiceClient auf und geben Sie die folgenden Werte weiter:

• Ein BLOB-Objekt, das das dynamisch erstellte DDX-Dokument darstellt
• Das mapItem-Array, das das PDF-Eingabedokument enthält
• Ein AssemblerOptionSpec-Objekt, das Laufzeitoptionen angibt

Die invokeDDX-Methode gibt ein AssemblerResult-Objekt zurück, das die Ergebnisse des Auftrags sowie alle aufgetretenen Ausnahmen enthält.

Speichern Sie die zerlegten PDF-Dokumente.

Führen Sie die folgenden Schritte aus, um die neu erstellten PDF-Dokumente abzurufen:

• Greifen Sie auf das Feld documents des Objekts AssemblerResult zu. Hierbei handelt es sich um ein Map-Objekt, das die aufgeteilten PDF-Dokumente enthält.
• Iterieren Sie durch das Map-Objekt, um alle Zieldokumente abzurufen. Wandeln Sie dann das Element value dieses Array-Elements in BLOB um.
• Extrahieren Sie die Binärdaten, die das PDF-Dokument darstellen, indem Sie auf die Eigenschaft MTOM des Objekts BLOB zugreifen. Dadurch wird ein Array von Bytes zurückgegeben, die Sie in eine PDF-Datei schreiben können.