Verarbeiten von übermittelten Formularen

Letzte Aktualisierung: 15. Juli 2024

Gilt für:
Experience Manager 6.5

Themen:

Erstellt für:

Entwickler

Die Beispiele in diesem Dokument gelten nur für eine AEM Forms on JEE-Umgebung.

Bei Web-basierten Programmen, die es dem Benutzer ermöglichen, interaktive Formulare auszufüllen, müssen die Daten an den Server zurückgesendet werden. Mithilfe des Forms-Services können Sie die Daten abrufen, die der Benutzer in ein interaktives Formular eingegeben hat. Nachdem Sie die Daten abgerufen haben, können Sie sie verarbeiten, um Ihre Geschäftsanforderungen zu erfüllen. Sie können die Daten beispielsweise in einer Datenbank speichern, an ein anderes Programm senden, an einen anderen Service senden, in einem Formularentwurf zusammenführen, in einem Webbrowser anzeigen usw.

Formulardaten werden entweder als XML- oder als PDF-Daten an den Forms-Service übermittelt. Dies ist eine Option, die in Designer festgelegt ist. Bei einem Formular, das als XML übermittelt wird, haben Sie die Möglichkeit, einzelne Felddatenwerte zu extrahieren. Das heißt, Sie können den Wert jedes Formularfelds extrahieren, den der Benutzer in das Formular eingegeben hat. Bei einem Formular, das als PDF-Daten übermittelt wird, handelt es sich um Binärdaten, nicht um XML-Daten. Sie können das Formular als PDF-Datei speichern oder an einen anderen Service senden. Wenn Sie Daten aus einem als XML übermittelten Formular extrahieren und dann die Formulardaten zum Erstellen eines PDF-Dokuments verwenden möchten, rufen Sie einen weiteren AEM Forms-Vorgang auf. (Siehe Erstellen von PDF-Dokumenten mit übermittelten XML-Daten)

Das folgende Diagramm zeigt, wie Daten von einem interaktiven Formular, das in einem Webbrowser angezeigt wird, an ein Java-Servlet namens HandleData übermittelt werden.

hs_hs_handlesubmit

In der folgenden Tabelle werden die Schritte im Diagramm erläutert.

Schritt	Beschreibung
1	Ein Benutzer füllt ein interaktives Formular aus und klickt auf die Senden-Schaltfläche des Formulars.
2	Die Daten werden als XML-Daten an das Java-Servlet `HandleData` übermittelt.
3	Das Java-Servlet `HandleData` enthält die Anwendungslogik zum Abrufen der Daten.

Behandlung von übermittelten XML-Daten

Wenn Formulardaten als XML übermittelt werden, können Sie XML-Daten abrufen, die die übermittelten Daten darstellen. Alle Formularfelder werden als Knoten in einem XML-Schema angezeigt. Die Knotenwerte entsprechen den vom Benutzer eingegebenen Werten. Betrachten Sie ein Darlehensformular, bei dem jedes Feld im Formular als Knoten innerhalb der XML-Daten angezeigt wird. Der Wert jedes Knotens entspricht dem Wert, den ein Benutzer ausfüllt. Angenommen, ein Benutzer füllt im Darlehensformular die Daten aus, die im folgenden Formular angezeigt werden.

hs_hs_loanformdata

Die folgende Abbildung zeigt die entsprechenden XML-Daten, die mithilfe der Forms-Service-Client-API abgerufen werden.

hs_hs_loandata

Die Felder im Darlehensformular. Diese Werte können mithilfe von Java XML-Klassen abgerufen werden.

HINWEIS

Der Formularentwurf muss in Designer ordnungsgemäß konfiguriert sein, damit Daten als XML-Daten übermittelt werden können. Um den Formularentwurf ordnungsgemäß zum Übermitteln von XML-Daten zu konfigurieren, stellen Sie sicher, dass die Senden-Schaltfläche im Formularentwurf für das Übermitteln von XML-Daten eingestellt ist. Weitere Informationen darüber, wie Sie die Senden-Schaltfläche für das Übermitteln von XML-Daten einstellen, finden Sie unter AEM Forms Designer.

Verarbeiten von übermittelten PDF-Daten

Stellen Sie sich ein Web-Programm vor, das den Forms-Service aufruft. Nachdem der Forms-Service ein interaktives PDF-Formular in einem Client-Webbrowser erzeugt hat, füllt der Benutzer das Formular aus und übermittelt es als PDF-Daten zurück. Wenn der Forms-Service die PDF-Daten erhält, kann er die PDF-Daten an einen anderen Service senden oder als PDF-Datei speichern. Das folgende Diagramm zeigt den logischen Ablauf des Programms.

hs_hs_savingforms

Die folgende Tabelle beschreibt die Schritte in diesem Diagramm.

Schritt	Beschreibung
1	Eine Web-Seite enthält einen Link, der auf ein Java-Servlet zugreift, das den Forms-Service aufruft.
2	Der Forms-Service erzeugt ein interaktives PDF-Formular im Client-Webbrowser.
3	Der Benutzer füllt ein interaktives Formular aus und klickt auf eine Senden-Schaltfläche. Das Formular wird als PDF-Daten an den Forms-Service zurückgesendet. Diese Option wird in Designer festgelegt.
4	Der Forms-Service speichert die PDF-Daten als PDF-Datei.

Verarbeiten von übermittelten URL-UTF-16-Daten

Wenn Formulardaten als URL-UTF-16-Daten übermittelt werden, erfordert der Client-Computer Adobe Reader oder Acrobat 8.1 oder höher. Enthält weiterhin der Formularentwurf eine Senden-Schaltfläche mit URL-codierten Daten (HTTP Post) und die Option zur Codierung der Daten ist UTF-16, muss der Formularentwurf in einem Texteditor wie Notepad geändert werden. Sie können die Codierungs-Option für die Senden-Schaltfläche entweder auf UTF-16LE oder auf UTF-16BE einstellen. Designer bietet diese Funktion nicht.

HINWEIS

Weitere Informationen zum Forms-Service finden Sie in der Service-Referenz für AEM Forms.

Zusammenfassung der Schritte

Führen Sie die folgenden Aufgaben aus, um übermittelte Formulare zu verarbeiten:

Schließen Sie Projektdateien ein.
Erstellen Sie ein Forms-Client-API-Objekt.
Rufen Sie Formulardaten ab.
Ermitteln Sie, ob die Formularübermittlung Dateianlagen enthält.
Verarbeiten Sie die übermittelten Daten.

Einschließen von Projektdateien

Schließen Sie die erforderlichen Dateien in Ihr Entwicklungsprojekt ein. Wenn Sie ein Client-Programm mit Java erstellen, schließen Sie die erforderlichen JAR-Dateien ein. Wenn Sie Webdienste verwenden, stellen Sie sicher, dass Sie die Proxy-Dateien einschließen.

Erstellen eines Forms-Client-API-Objekts

Bevor Sie einen Client-API-Vorgang für den Forms-Service programmgesteuert durchführen können, müssen Sie einen Client für den Forms-Service erstellen. Wenn Sie die Java-API verwenden, erstellen Sie ein FormsServiceClient-Objekt. Wenn Sie die Forms-Webservice-API verwenden, erstellen Sie ein FormsService-Objekt.

Abrufen von Formulardaten

Um übermittelte Formulardaten abzurufen, rufen Sie die Methode processFormSubmission des FormsServiceClient-Objekts auf. Beim Aufrufen dieser Methode müssen Sie den Content-Typ des übermittelten Formulars angeben. Wenn Daten von einem Client-Webbrowser an den Forms-Service übermittelt werden, können sie entweder als XML- oder als PDF-Daten übermittelt werden. Um die in Formularfelder eingegebenen Daten abzurufen, können die Daten als XML-Daten übermittelt werden.

Sie können auch Formularfelder aus einem Formular abrufen, das als PDF-Daten übermittelt wurde, indem Sie die folgenden Laufzeitoptionen festlegen:

Übergeben Sie den folgenden Wert an die Methode processFormSubmission als Parameter für den Content-Typ: CONTENT_TYPE=application/pdf.
Setzen Sie den PDFToXDP-Wert des RenderOptionsSpec-Objekts auf true
Setzen Sie den ExportDataFormat-Wert des RenderOptionsSpec-Objekts auf XMLData

Wenn Sie die Methode processFormSubmission aufrufen, geben Sie den Content-Typ des übermittelten Formulars an. In der folgenden Liste sind die anwendbaren Werte des Content-Typs aufgeführt:

text/xml: Stellt den Content-Typ dar, der verwendet werden soll, wenn ein PDF-Formular Formulardaten als XML übermittelt.
application/x-www-form-urlencoded: Stellt den Content-Typ dar, der verwendet werden soll, wenn ein HTML-Formular Daten als XML übermittelt.
application/pdf: Stellt den Content-Typ dar, der verwendet werden soll, wenn ein PDF-Formular Daten als PDF übermittelt.

NOTE

Sie werden feststellen, dass es im Abschnitt „Verarbeiten von übermittelten Formularen“ drei entsprechende Kurzanleitungen gibt. Die Kurzanleitung zur Verarbeitung von PDF-Formularen, die als PDF übermittelt wurden, mithilfe der Java-API zeigt, wie übermittelte PDF-Daten verarbeitet werden. Der in dieser Kurzanleitung angegebene Content-Typ lautet application/pdf. Die Kurzanleitung zur Verarbeitung von PDF-Formularen, die als XML übermittelt wurden, mithilfe der Java-API zeigt, wie übermittelte XML-Daten aus einem PDF-Formular verarbeitet werden. Der in dieser Kurzanleitung angegebene Content-Typ lautet text/xml. Ebenso zeigt die Kurzanleitung zur Verarbeitung von HTML-Formularen, die als XML übermittelt wurden, mithilfe der Java-API, wie übermittelte XML-Daten verarbeitet werden, die von einem HTML-Formular übermittelt wurden. Der in dieser Kurzanleitung angegebene Content-Typ ist application/x-www-form-urlencoded.

Sie rufen Formulardaten ab, die an den Forms-Service gesendet wurden, und ermitteln den Verarbeitungsstatus. Das heißt, wenn Daten an den Forms-Service übermittelt werden, bedeutet dies nicht unbedingt, dass der Forms-Service die Verarbeitung der Daten abgeschlossen hat und die Daten bereit zur Verarbeitung sind. Beispielsweise können Daten an den Forms-Service übermittelt werden, damit eine Berechnung durchgeführt werden kann. Nach Abschluss der Berechnung wird das Formular mit den angezeigten Berechnungsergebnissen an den Benutzer zurückgegeben. Bevor Sie übermittelte Daten verarbeiten, sollten Sie ermitteln, ob der Forms-Service die Verarbeitung der Daten abgeschlossen hat.

Der Forms-Service gibt die folgenden Werte zurück, um anzugeben, ob die Verarbeitung der Daten abgeschlossen ist:

0 (Übermitteln): Übermittelte Daten können verarbeitet werden.
1 (Berechnen): Der Forms-Service hat einen Berechnungsvorgang für die Daten durchgeführt, und die Ergebnisse müssen an den Benutzer zurückgegeben werden.
2 (Validieren): Der Forms-Service hat die Formulardaten validiert, und die Ergebnisse müssen an den Benutzer zurückgegeben werden.
3 (Weiter): Die aktuelle Seite hat sich mit Ergebnissen geändert, die in das Client-Programm geschrieben werden müssen.
4 (Zurück): Die aktuelle Seite hat sich mit Ergebnissen geändert, die in das Client-Programm geschrieben werden müssen.

NOTE

Berechnungen und Überprüfungen müssen an den Benutzer zurückgegeben werden. (Siehe Berechnen von Formulardaten.

Ermitteln, ob die Formularübermittlung Dateianlagen enthält

Formulare, die an den Forms-Service übermittelt werden, können Dateianhänge enthalten. Beispielsweise kann ein Benutzer mithilfe des integrierten Anlagenbereichs von Acrobat Dateianlagen auswählen, die zusammen mit dem Formular übermittelt werden sollen. Außerdem können Benutzer Dateianlagen auch über eine HTML-Symbolleiste auswählen, die mit einer HTML-Datei wiedergegeben wird.

Nachdem Sie festgestellt haben, ob ein Formular Dateianhänge enthält, können Sie die Daten verarbeiten. Sie können beispielsweise den Dateianhang im lokalen Dateisystem speichern.

NOTE

Das Formular muss als PDF-Daten übermittelt werden, um Dateianhänge abzurufen. Wenn das Formular als XML-Daten übermittelt wird, werden keine Dateianlagen übermittelt.

Verarbeiten der übermittelten Daten

Je nach Content-Typ der übermittelten Daten können Sie die individuellen Formularfeldwerte aus den übermittelten XML-Daten extrahieren oder die übermittelten PDF-Daten als PDF-Datei speichern (oder an einen anderen Service übermitteln). Um einzelne Formularfelder zu extrahieren, konvertieren Sie übermittelte XML-Daten in eine XML-Datenquelle und rufen Sie dann XML-Datenquellenwerte mithilfe der org.w3c.dom-Klassen ab.

Siehe auch

Einbeziehung von AEM Forms Java-Bibliotheksdateien

Verbindungseigenschaften festlegen

Schnellstart mit der Forms Service-API

Übergeben von Dokumenten an den Forms-Service

Erstellen von Web-Programmen, die Formulare wiedergeben