Konfigurieren der Sendeaktion

Einführung in Übermittlungsaktionen

Eine Übermittlungsaktion wird ausgelöst, wenn ein Benutzer in einem adaptiven Formular auf die Schaltfläche „Senden“ klickt. Sie können die Übermittlungsaktion in einem adaptiven Formular konfigurieren. Adaptive Formulare umfassen auch einige Übermittlungsaktionen für den sofortigen Einsatz. Sie können die standardmäßige Übermittlungsaktion kopieren und erweitern und so eine eigene Übermittlungsaktion erstellen. Basierend auf Ihre Anforderungen können Sie eine eigene Übermittlungsaktion schreiben und registrieren, um Daten im gesendeten Formular zu verarbeiten.

Wenn ein Formular vorausgefüllt oder übermittelt wird, werden die gesendeten Daten durch AEM zur Datenmassage in Zwischenformate weitergeleitet. Daten werden nicht in einer AEM-Instanz gespeichert, es sei denn, das adaptive Formular verwendet Adobe Sign, überprüft, Formularportalentwürfe, -übermittlungen oder AEM Workflows.

Sie können eine Sendeaktion in der Seitenleiste im Bereich Senden des „Container für adaptive Formulare“ konfigurieren.

Konfigurieren der Sendeaktion
Abbildung: Konfigurieren der Sendeaktion

Die folgenden Übermittlungsaktionen stehen in adaptiven Formularen standardmäßig zur Verfügung:

  • An REST-Endpunkt übermitteln
  • E-Mail senden
  • PDF mittels E-Mail senden
  • Workflow für Formulare aufrufen
  • Senden mit Formulardatenmodell
  • Übermittlungsaktion für Forms Portal
  • AEM-Workflow aufrufen
HINWEIS

Die Übermittlungsaktion „PDF mittels E-Mail senden“ steht nur in adaptiven Formularen zur Verfügung, die als Formularmodell XFA-Vorlagen verwenden.

HINWEIS

Stellen Sie sicher, dass [AEM_Installationsverzeichnis]\crx-quickstart\temp\datamanager\ASM folder exists Das Verzeichnis wird benötigt, um Anhänge vorübergehend zu speichern. Wenn der Ordner nicht vorhanden ist, erstellen Sie ihn.

VORSICHT

Wenn Sie prefill eine Formularvorlage, ein Formulardatenmodell oder ein schemabasiertes adaptives Formular mit XML- oder JSON-Daten, die sich auf ein Schema (XML-Schema, JSON-Schema, Formularvorlage oder Formulardatenmodell) beziehen, das keine Daten enthält <afdata>, <afbounddata>und </afunbounddata> Tags, dann sind die Daten von nicht gebundenen Feldern (ungebundene Felder sind adaptive Formularfelder ohne bindref -Eigenschaft) des adaptiven Formulars verloren.

Sie können eine benutzerdefinierte Übermittlungsaktion für adaptive Formulare entsprechend des Anwendungsfalls schreiben. Weitere Informationen finden Sie unter Schreiben von benutzerdefinierten Übermittlungsaktionen für ein adaptives Formular.

An REST-Endpunkt übermitteln

Die Übermittlungsoption An REST-Endpunkt übermitteln wird verwendet, wenn Sie die im Formular eingetragenen Daten zu einer konfigurierten Bestätigungsseite im Rahmen der http GET-Anforderung weiterleiten möchten. Sie können den Namen der Felder der Anforderung hinzufügen. Das Format der Anforderung lautet:

{fieldName}={request parameter name}

Wie in der folgenden Abbildung dargestellt, werden param1 und param2 als Parameter mit Werten, die aus den Feldern textbox und numericbox kopiert wurden, für die nächste Aktion weitergeleitet.

Sie können auch POST-Anforderungen aktivieren und eine URL eingeben, um die Anforderung zu veröffentlichen. Um Daten an den AEM-Server, auf dem sich das Formular befindet, zu senden, verwenden Sie einen relativen Pfad entsprechend dem Stammpfad des AEM-Servers. Beispiel: /content/Forms/af/SampleForm.html. Wenn Sie Daten an irgendeinen anderen Server senden, verwenden Sie den absoluten Pfad.

Konfigurieren der Übermittlungsaktion „An REST-Endpunkt übermitteln“

Konfigurieren der Übermittlungsaktion „An REST-Endpunkt übermitteln“

HINWEIS

Alle Felder müssen über verschiedene Elementnamen verfügen, um als Parameter in der REST-URL weitergeleitet zu werden, auch dann, wenn die Felder in verschiedenen Bereichen platziert sind.

Veröffentlichen Sie übertragene Daten an eine Ressource oder an einen externen REST-Endpunkt 

Verwenden Sie die Aktion An REST-Endpunkt übermitteln, um die übertragenen Daten an eine Rest-URL zu veröffentlichen. Die URL kann sich auf einem internen (dem Server, auf dem das Formular gerendert wird) oder auf einem externen Server befinden.

Stellen Sie den Pfad der Ressource bereit, um Daten an einen internen Server zu veröffentlichen. Die Daten werden an den Pfad der Ressource veröffentlicht. Beispiel: /content/restEndPoint. Für diese POST-Anforderungen werden die Authentifizierungsinformationen der Versandanfrage verwendet.

Stellen Sie die URL bereit, um Daten an einen externen Server zu veröffentlichen. Das Format der URL ist https:// host:port/path_to_rest_end_point. Stellen Sie sicher, dass Sie den Pfad zum Handhaben der POST-Anforderung anonym konfigurieren.

Zuordnung zur Weitergabe von Feldwerten als Anforderungsparameter für die Dankeseite

Im obigen Beispiel hat der Benutzer Informationen in die textbox eingegeben, die mithilfe von Parameter param1 erfasst werden. Die Syntax zur Veröffentlichung erfasster Daten mithilfe von param1 lautet:

String data=request.getParameter("param1");

Paramenter, die Sie zum Veröffentlichen von XML-Daten und -Anhängen verwenden, sind dataXml und attachments.

Beispielsweise können Sie diese beiden Parameter in Ihrem Skript verwenden, um Daten an einem Restendpunkt zu analysieren. Verwenden Sie die folgende Syntax, um Daten zu speichern und zu analysieren:

String data=request.getParameter("dataXml");
String att=request.getParameter("attachments");

In diesem Beispiel speichert data die XML-Daten, und att speichert Anlagendaten.

E-Mail senden

Die E-Mail senden bei erfolgreicher Übermittlung des Formulars eine E-Mail an einen oder mehrere Empfänger gesendet wird. Die generierte E-Mail kann Formulardaten in einem vordefinierten Format enthalten.

HINWEIS

Alle Formularfelder müssen über verschiedene Elementnamen verfügen, auch wenn sie in verschiedene Fenster platziert werden, um in eine E-Mail Formulardaten einzubinden.

PDF mittels E-Mail senden

Bei der Übermittlungsaktion PDF mittels E-Mail senden wird bei erfolgreicher Übermittlung des Formulars an einen oder mehrere Empfänger eine mit einer PDF-Datei gesendet, die Formulardaten enthält.

**Hinweis:**Diese Übermittlungsaktion ist für XFA-basierte adaptive Formulare und XSD-basierte adaptive Formulare verfügbar, die das Dokument aus Datensatzvorlage enthalten.

Workflow für Formulare aufrufen

Bei der Übermittlungsoption An Formular-Workflow übermitteln werden eine Daten-XML und Dateianlagen (falls vorhanden) an einen vorhandenen Adobe LiveCycle- oder AEM Forms on JEE-Prozess gesendet.

Weitere Informationen zum Konfigurieren der Sendeaktion „An Formular-Workflow übermitteln“ finden Sie unter Senden und Verarbeiten Ihrer Formulardaten mit Formular-Workflows.

Senden mit Formulardatenmodell

Die Senden mit Formulardatenmodell Aktion "submit"schreibt gesendete adaptive Formulardaten für das angegebene Datenmodellobjekt in einem Formulardatenmodell in seine Datenquelle. Beim Konfigurieren der Übermittlungsaktion können Sie ein Datenmodellobjekt auswählen, dessen übermittelte Daten in die Datenquelle zurückgeschrieben werden sollen.

Darüber hinaus können Sie einen Formularanhang mit einem Formulardatenmodell und einem Datensatzdokument (Document of Record) an die Datenquelle senden.

Weitere Informationen zum Formulardatenmodell finden Sie unter Datenintegration für AEM Forms.

Übermittlungsaktion für Forms Portal

Mit der Option Übermittlungsaktion für Forms Portal werden über das AEM Forms-Portal Formulardaten zur Verfügung gestellt.

Weitere Informationen zur Übermittlungsaktion für Forms Portal finden Sie unter Komponente für Formular und übermittelte Formulare.

AEM-Workflow aufrufen

Die Übermittlungsaktion AEM-Workflow aufrufen verknüpft ein adaptives Formular mit einem AEM-Workflow. Wenn ein Formular gesendet wird, startet der verknüpfte Workflow automatisch auf dem Verarbeitungsknoten. Darüber hinaus speichert er die Datendatei, Anhänge und das Datensatzdokument (falls vorhanden) im Nutzlastspeicherort des Workflows.

Vor der Verwendung von AEM-Workflow aufrufen konfigurieren Sie die AEM-DS-Einstellungen. Weitere Informationen zum Erstellen eines AEM-Workflow finden Sie unter Formularorientierte Workflows auf OSGi.

Server-seitige Überprüfung im adaptiven Formular

In der Regel platzieren Entwickler in jedem Online-Datenerfassungssystem einige JavaScript-Validierungen auf Client-Seite, um einige Geschäftsregeln durchzusetzen. Moderne Browser bieten Endbenutzern jedoch Möglichkeiten, diese Validierungen zu umgehen und Übermittlungen mithilfe verschiedener Techniken wie beispielsweise die Web Browser DevTools-Konsole manuell durchzuführen. Solche Techniken gelten auch für adaptive Formulare. Ein Formularentwickler kann verschiedene Validierungslogiken erstellen, aber Endbenutzer können diese Validierungslogiken technisch umgehen und ungültige Daten an den Server leiten. Ungültige Daten verstoßen gegen die Geschäftsregeln, die der Formularautor durchgesetzt hat.

Die Funktion für erneute serverseitige Überprüfung enthält die Möglichkeit, auch Validierungen durchzuführen, die von einem Autor für adaptive Formulare beim Entwerfen eines adaptiven Formulars auf dem Server bereitgestellt wurden. Sie verhindert jede mögliche Beeinträchtigung von Datenübertragungen und Verstöße gegen Geschäftsregeln, die hinsichtlich Formularvalidierungen auftreten können.

Was soll auf dem Server validiert werden?

Alle sofort einsetzbaren Feldvalidierungen eines adaptiven Formulars, die erneut auf dem Server ausgeführt werden:

  • Erforderlich
  • Validierung-Picture-Klausel
  • Überprüfungsausdruck

Aktivieren von Server-seitiger Validierung

Verwenden Sie das Kontrollkästchen Auf dem Server erneut überprüfen im Container für adaptive Formulare in der Seitenleiste, um die Server-seitige Validierung für das aktuelle Formular zu aktivieren oder zu deaktivieren.

Aktivieren von Server-seitiger Validierung
Abbildung: Aktivieren der serverseitigen Validierung

Wenn der Endbenutzer diese Validierungen umgeht und die Formulare übermittelt, führt der Server die Validierung erneut aus. Wenn die Validierung Server-seitig fehlschlägt, wird die Übermittlung abgebrochen. Dem Endbenutzer wird wieder das ursprüngliche Formular präsentiert. Die erfassten Daten und die gesendeten Daten werden dem Benutzer als Fehler angezeigt.

Unterstützende benutzerdefinierte Funktionen in Validierungsausdrücken

Bisweilen befindet sich bei komplexen Validierungsregeln das exakte Validierungsskript in den benutzerdefinierten Funktionen. Der Autor kann diese benutzerdefinierten Funktionen über den Ausdrück für die Feldvalidierung abrufen. Um diese benutzerdefinierte Funktionsbibliothek bei Server-seitigen Validierungen bekannt und verfügbar zu machen, kann der Formularautor den Namen der AEM-Client-Bibliothek auf der Registerkarte Allgemein des Dialogfelds „Container für adaptive Formulare bearbeiten“, wie nachfolgend dargestellt konfigurieren.

Unterstützende benutzerdefinierte Funktionen in Validierungsausdrücken
Abbildung: Unterstützende benutzerdefinierte Funktionen in Überprüfungsausdrücken

Autor kann benutzerdefinierte JavaScript-Bibliothek pro adaptivem Formular konfigurieren. Bewahren Sie in der Bibliothek nur die wiederverwendbaren Funktionen, die von den Drittanbieter-Bibliotheken „jquery“ und „underscore“ abhängen.

Verhalten bei fehlerhaften Übermittlungsaktionen

Konfigurieren Sie im Rahmen der AEM-Richtlinie für Sicherheit und Beschränkungen benutzerdefinierte Seiten für die Fehler 404.jsp und 500.jsp. Diese Handler werden aufgerufen, wenn beim Übermitteln des Formulars 404 oder 500 Fehler auftreten. Die Handler werden auch aufgerufen, wenn diese Fehler-Codes auf einem Veröffentlichungsknoten ausgelöst werden.

Weitere Informationen finden Sie unter Anpassen der vom Fehler-Handler angezeigten Seiten.

Auf dieser Seite