Vorausfüllen von Formularen mit flexiblen Layouts prepopulating-forms-with-flowable-layouts1

Projektdateien einschließen

Fügen Sie Client-JAR-Dateien wie „adobe-forms-client.jar“ in den Klassenpfad Ihres Java-Projekts ein. Weitere Informationen über den Speicherort dieser Dateien finden Sie unter Einbeziehung von AEM Forms Java-Bibliotheksdateien.

Erstellen einer arbeitsspeicherinternen XML-Datenquelle

• 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 der XML-Datenquelle, indem Sie die Methode createElement des org.w3c.dom.Document-Objekts aufrufen. Dadurch wird ein Element-Objekt erstellt, 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. Hängen Sie anschließend das Stammelement an das Dokument an, indem Sie die Methode appendChild des Document-Objekts aufrufen, und übergeben Sie das Stammelement-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Anwendungslogik:

   Element root = (Element)document.createElement("transaction");  document.appendChild(root);

• Erstellen Sie das Header-Element der XML-Datenquelle, indem Sie die Methode createElement des Document-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die Methode createElement. Wandeln Sie den Rückgabewert in Element um. Hängen Sie anschließend das Header-Element an das Stammelement an, indem Sie die Methode appendChild des root-Objekts aufrufen, und übergeben Sie das Objekt des Header-Elements als Argument. Die XML-Elemente, die an das Kopfzeilenelement angehängt werden, entsprechen dem statischen Teil des Formulars. Die folgenden Code-Zeilen zeigen diese Programmlogik:

   Element header = (Element)document.createElement("header");  root.appendChild(header);

• Erstellen Sie ein untergeordnetes Element, das zum Header-Element gehört, indem Sie die Methode createElement des Document-Objekts aufrufen, und übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt. Wandeln Sie den Rückgabewert in Element um. Legen Sie anschließend einen Wert für das untergeordnete Element fest, indem Sie dessen Methode appendChild aufrufen, und übergeben Sie die Methode createTextNode des Document-Objekts als Argument. Geben Sie einen Zeichenfolgenwert an, der als Wert des untergeordneten Elements angezeigt werden soll. Hängen Sie abschließend das untergeordnete Element an das Header-Element an, indem Sie dessen Methode appendChild aufrufen, und übergeben Sie das untergeordnete Element-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

   Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

• Fügen Sie alle verbleibenden Elemente zum Kopfzeilenelement hinzu, indem Sie den letzten Unterschritt für jedes Feld wiederholen, das im statischen Teil des Formulars erscheint (im XML-Datenquellendiagramm werden diese Felder in Abschnitt A angezeigt. (Siehe Grundlegendes zu Datenuntergruppen.)

• Erstellen Sie das Detailelement der XML-Datenquelle, indem Sie die Methode createElement des Document-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die Methode createElement. Wandeln Sie den Rückgabewert in Element um. Hängen Sie anschließend das Detailelement an das Stammelement an, indem Sie die Methode appendChild des root-Objekts aufrufen, und übergeben Sie das Objekt des Detailelements als Argument. Die XML-Elemente, die an das Detailelement angehängt werden, entsprechen dem dynamischen Teil des Formulars. Die folgenden Code-Zeilen zeigen diese Programmlogik:

   Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

• Erstellen Sie ein untergeordnetes Element, das zum Detailelement gehört, indem Sie die Methode createElement des Document-Objekts aufrufen, und übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt. Wandeln Sie den Rückgabewert in Element um. Legen Sie anschließend einen Wert für das untergeordnete Element fest, indem Sie dessen Methode appendChild aufrufen, und übergeben Sie die Methode createTextNode des Document-Objekts als Argument. Geben Sie einen Zeichenfolgenwert an, der als Wert des untergeordneten Elements angezeigt werden soll. Hängen Sie abschließend das untergeordnete Element an das Detailelement an, indem Sie die Methode appendChild des Detailelements aufrufen, und übergeben Sie das untergeordnete Element-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

   Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

• Wiederholen Sie den letzten Unterschritt für alle XML-Elemente, die an das Detailelement angehängt werden sollen. Um die XML-Datenquelle, die zum Ausfüllen des Bestellformulars verwendet wird, ordnungsgemäß zu erstellen, müssen Sie die folgenden XML-Elemente an das Detailelement anhängen: txtDescription, numQty und numUnitPrice.

• Wiederholen Sie die letzten beiden Unterschritte für alle Datenelemente, die zum Vorausfüllen des Formulars verwendet werden.

Konvertieren der XML-Datenquelle

• 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 javax.xml.transform.dom.DOMSource-Objekt, indem Sie seinen Konstruktor verwenden und das org.w3c.dom.Document-Objekt übergeben, das in Schritt 1 erstellt wurde.
• Erstellen Sie ein javax.xml.transform.dom.DOMSource-Objekt, indem Sie seinen Konstruktor verwenden und das ByteArrayOutputStream-Objekt übergeben.
• Füllen Sie das Java ByteArrayOutputStream-Objekt, indem Sie die Methode transform des javax.xml.transform.Transformer-Objekts aufrufen und die Objekte javax.xml.transform.dom.DOMSource und javax.xml.transform.stream.StreamResult übergeben.
• 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 seinen Konstruktor aufrufen und ihm das Byte-Array übergeben.

Rendern von im Voraus ausgefüllten Formularen

Rufen Sie die Methode renderPDFForm des FormsServiceClient-Objekts auf und übergeben Sie die folgenden Werte:

• Ein Zeichenfolgenwert, der den Namen des Formularentwurfs angibt, einschließlich der Dateinamenerweiterung.
• Ein com.adobe.idp.Document-Objekt, das Daten enthält, die mit dem Formular zusammengeführt werden sollen. Stellen Sie sicher, dass Sie das com.adobe.idp.Document-Objekt verwenden, das in den Schritten 1 und 2 erstellt wurde.
• Ein PDFFormRenderSpec-Objekt, in dem Laufzeitoptionen gespeichert werden.
• Ein URLSpec-Objekt, das URI-Werte enthält, die für den Forms-Service erforderlich sind.
• Ein java.util.HashMap-Objekt, das Dateianlagen speichert. Dies ist ein optionaler Parameter, für den Sie null angeben können, wenn Sie keine Dateien an das Formular anhängen möchten.

Die Methode renderPDFForm gibt ein FormsResult-Objekt zurück, das einen Formulardatenstrom enthält, der in den Client-Webbrowser geschrieben werden muss.

• Erstellen Sie ein javax.servlet.ServletOutputStream-Objekt, das zum Senden eines Formulardatenstroms an den Client-Webbrowser verwendet wird.
• Erstellen Sie ein Objekt vom Typ com.adobe.idp.Document, indem Sie die Methode getOutputContent des FormsResult-Objekts aufrufen.
• Erstellen Sie ein Objekt vom Typ java.io.InputStream, indem Sie die Methode getInputStream des com.adobe.idp.Document-Objekts aufrufen.
• Erstellen Sie ein Byte-Array und füllen Sie es mit dem Formulardatenstrom, indem Sie die Methode read des InputStream-Objekts aufrufen und das Byte-Array als Argument übergeben.
• Rufen Sie die Methode write des javax.servlet.ServletOutputStream-Objekts auf, um den Formulardatenstrom an den Client-Webbrowser zu senden. Übergeben Sie das Byte-Array an die Methode write.

Projektdateien einschließen

• Erstellen Sie Java-Proxy-Klassen, die die WSDL des Forms-Services verwenden. (Siehe Erstellen von Java-Proxy-Klassen mit Apache Axis.)
• Schließen Sie die Java-Proxy-Klassen in Ihren Klassenpfad ein.

Erstellen einer arbeitsspeicherinternen XML-Datenquelle

• 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 der XML-Datenquelle, indem Sie die Methode createElement des org.w3c.dom.Document-Objekts aufrufen. Dadurch wird ein Element-Objekt erstellt, 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. Hängen Sie anschließend das Stammelement an das Dokument an, indem Sie die Methode appendChild des Document-Objekts aufrufen, und übergeben Sie das Stammelement-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Programmlogik:

   Element root = (Element)document.createElement("transaction");  document.appendChild(root);

• Erstellen Sie das Header-Element der XML-Datenquelle, indem Sie die Methode createElement des Document-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die Methode createElement. Wandeln Sie den Rückgabewert in Element um. Hängen Sie anschließend das Header-Element an das Stammelement an, indem Sie die Methode appendChild des root-Objekts aufrufen, und übergeben Sie das Objekt des Header-Elements als Argument. Die XML-Elemente, die an das Kopfzeilenelement angehängt werden, entsprechen dem statischen Teil des Formulars. Die folgenden Code-Zeilen zeigen diese Programmlogik:

   Element header = (Element)document.createElement("header");  root.appendChild(header);

• Erstellen Sie ein untergeordnetes Element, das zum Header-Element gehört, indem Sie die Methode createElement des Document-Objekts aufrufen, und übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt. Wandeln Sie den Rückgabewert in Element um. Legen Sie anschließend einen Wert für das untergeordnete Element fest, indem Sie dessen Methode appendChild aufrufen, und übergeben Sie die Methode createTextNode des Document-Objekts als Argument. Geben Sie einen Zeichenfolgenwert an, der als Wert des untergeordneten Elements angezeigt werden soll. Hängen Sie abschließend das untergeordnete Element an das Header-Element an, indem Sie dessen Methode appendChild aufrufen, und übergeben Sie das untergeordnete Element-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Anwendungslogik:

   Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

• Fügen Sie alle verbleibenden Elemente zum Header-Element hinzu, indem Sie den letzten Unterschritt für jedes Feld wiederholen, das im statischen Teil des Formulars erscheint (im Diagramm der XML-Datenquelle werden diese Felder in Abschnitt A angezeigt). (Siehe Grundlagen zu Datenuntergruppen.)

• Erstellen Sie das Detailelement der XML-Datenquelle, indem Sie die Methode createElement des Document-Objekts aufrufen. Übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt, an die Methode createElement. Wandeln Sie den Rückgabewert in Element um. Hängen Sie anschließend das Detailelement an das Stammelement an, indem Sie die Methode appendChild des root-Objekts aufrufen, und übergeben Sie das Objekt des Detailelements als Argument. Die XML-Elemente, die an das Detailelement angehängt werden, entsprechen dem dynamischen Teil des Formulars. Die folgenden Code-Zeilen zeigen diese Anwendungslogik:

   Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

• Erstellen Sie ein untergeordnetes Element, das zum Detailelement gehört, indem Sie die Methode createElement des Document-Objekts aufrufen, und übergeben Sie einen Zeichenfolgenwert, der den Namen des Elements darstellt. Wandeln Sie den Rückgabewert in Element um. Legen Sie anschließend einen Wert für das untergeordnete Element fest, indem Sie dessen Methode appendChild aufrufen, und übergeben Sie die Methode createTextNode des Document-Objekts als Argument. Geben Sie einen Zeichenfolgenwert an, der als Wert des untergeordneten Elements angezeigt werden soll. Hängen Sie abschließend das untergeordnete Element an das Detailelement an, indem Sie die Methode appendChild des Detailelements aufrufen, und übergeben Sie das untergeordnete Element-Objekt als Argument. Die folgenden Code-Zeilen zeigen diese Anwendungslogik:

   Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

• Wiederholen Sie den letzten Unterschritt für alle XML-Elemente, die an das Detailelement angehängt werden sollen. Um die XML-Datenquelle, die zum Ausfüllen des Bestellformulars verwendet wird, ordnungsgemäß zu erstellen, müssen Sie die folgenden XML-Elemente an das Detailelement anhängen: txtDescription, numQty und numUnitPrice.

• Wiederholen Sie die letzten beiden Unterschritte für alle Datenelemente, die zum Vorausfüllen des Formulars verwendet werden.

Konvertieren der XML-Datenquelle

• 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 javax.xml.transform.dom.DOMSource-Objekt, indem Sie seinen Konstruktor verwenden und das org.w3c.dom.Document-Objekt übergeben, das in Schritt 1 erstellt wurde.
• Erstellen Sie ein javax.xml.transform.dom.DOMSource-Objekt, indem Sie seinen Konstruktor verwenden und das ByteArrayOutputStream-Objekt übergeben.
• Füllen Sie das Java ByteArrayOutputStream-Objekt, indem Sie die Methode transform des javax.xml.transform.Transformer-Objekts aufrufen und die Objekte javax.xml.transform.dom.DOMSource und javax.xml.transform.stream.StreamResult übergeben.
• 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 BLOB-Objekt mithilfe des Konstruktors, rufen Sie die zugehörige Methode setBinaryData auf und übergeben Sie das Byte-Array.

Rendern von im Voraus ausgefüllten Formularen

Rufen Sie die Methode renderPDFForm des FormsService-Objekts auf und übergeben Sie die folgenden Werte:

• Ein Zeichenfolgenwert, der den Namen des Formularentwurfs angibt, einschließlich der Dateinamenerweiterung.
• Ein BLOB-Objekt mit Daten, die mit dem Formular zusammengeführt werden sollen. Stellen Sie sicher, dass Sie das BLOB-Objekt verwenden, das in den Schritten 1 und 2 erstellt wurde.
• Ein PDFFormRenderSpecc-Objekt, das Laufzeitoptionen speichert. Weitere Informationen finden Sie unter API-Referenz für AEM Forms.
• Ein URLSpec -Objekt mit URI-Werten, die für den Forms-Service erforderlich sind.
• Ein java.util.HashMap-Objekt, das Dateianlagen speichert. Dies ist ein optionaler Parameter. Sie können null festlegen, wenn Sie keine Dateien an das Formular anhängen möchten.
• Ein leeres com.adobe.idp.services.holders.BLOBHolder-Objekt, das von der Methode gefüllt wird. Damit wird das wiedergegebene PDF-Formular gespeichert.
• Ein leeres javax.xml.rpc.holders.LongHolder-Objekt, das von der Methode gefüllt wird. (Dieses Argument speichert die Anzahl der Seiten im Formular).
• Ein leeres javax.xml.rpc.holders.StringHolder-Objekt, das von der Methode gefüllt wird. (Dieses Argument speichert den Gebietsschemawert).
• Ein leeres com.adobe.idp.services.holders.FormsResultHolder-Objekt, das die Ergebnisse dieses Vorgangs enthält.

Die Methode renderPDFForm füllt das com.adobe.idp.services.holders.FormsResultHolder-Objekt, das als letzter Argumentwert übergeben wird, mit einem Formulardaten-Stream, der in den Client-Webbrowser geschrieben werden muss.

• Erstellen Sie ein Objekt vom Typ FormResult, indem Sie den Wert des Datenelements value des com.adobe.idp.services.holders.FormsResultHolder-Objekts abrufen.
• Erstellen Sie ein Objekt vom Typ BLOB, das Formulardaten enthält, indem Sie die Methode getOutputContent des FormsResult-Objekts aufrufen.
• Ermitteln Sie den Content-Typ des BLOB-Objekts, indem Sie seine Methode getContentType aufrufen.
• Legen Sie den Content-Typ des javax.servlet.http.HttpServletResponse-Objekts fest, indem Sie seine Methode setContentType aufrufen und den Content-Typ des BLOB-Objekts übergeben.
• Erstellen Sie ein Objekt vom Typ javax.servlet.ServletOutputStream, das zum Schreiben des Formulardatenstroms in den Client-Webbrowser verwendet wird, indem Sie die Methode getOutputStream des javax.servlet.http.HttpServletResponse-Objekts aufrufen.
• Erstellen Sie ein Byte-Array und füllen Sie es auf, indem Sie die Methode getBinaryData des BLOB-Objekts aufrufen. Mit dieser Aufgabe wird dem Byte-Array der Inhalt des FormsResult-Objekts zugewiesen.
• Rufen Sie die Methode write des javax.servlet.http.HttpServletResponse-Objekts auf, um den Formulardatenstrom an den Client-Webbrowser zu senden. Übergeben Sie das Byte-Array an die write-Methode.