Übermittlungsaktion für adaptive Formulare

Eine Übermittlungsaktion wird ausgelöst, wenn ein Benutzer in einem adaptiven Formular auf die Schaltfläche Senden klickt. Adaptive Formulare stellen einige Übermittlungsaktionen standardmäßig bereit. Die verfügbaren standardmäßigen Übermittlungsaktionen sind:

Sie können die standardmäßige Übermittlungsaktion erweitern und dadurch eine eigene Übermittlungsaktion erstellen.

Sie können eine Übermittlungsaktion in der Seitenleiste im Bereich Übermittlung des Containers für adaptive Formulare konfigurieren.

Konfigurieren der Übermittlungsaktion

An REST-Endpunkt übermitteln

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");

Auch Parameter, die Sie für die Veröffentlichung von XML-Daten und Anlagen 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.

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.

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

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.

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.

E-Mail senden

Bei der Übermittlungsaktion E-Mail senden wird bei erfolgreicher Übermittlung des Formulars eine E-Mail an einen oder mehrere Empfänger gesendet. Die generierte E-Mail kann Formulardaten in einem vordefinierten Format enthalten. Beispiel: Bei der folgenden Vorlage werden Kundenname, Versandadresse, Bundesstaat und Postleitzahl aus den übermittelten Formulardaten abgerufen.

„

Hallo ${customer_name},

Ihre Standard-Versandadresse lautet:
${customer_name},
${customer_Shipping_Address},
${customer_state},
${customer_ZIPCode}

Mit freundlichen Grüßen
WKND

“
HINWEIS
  • Alle Formularfelder müssen unterschiedliche Elementnamen haben – auch dann, wenn die Felder in verschiedenen Bereichen eines adaptiven Formulars platziert werden.
  • AEM as a Cloud Service erfordert die Verschlüsselung von ausgehenden E-Mails. Ausgehende E-Mails sind standardmäßig deaktiviert. Zur Aktivierung senden Sie ein Support-Ticket an Zugriff anfordern.

Sie können der E-Mail auch Anlagen und ein Datensatzdokument (DoR) hinzufügen. Um die Option Datensatzdokument anhängen zu aktivieren, konfigurieren Sie das adaptive Formular, um ein Datensatzdokument (DoR) zu generieren. Bei Aktivierung dieser Option können Sie aus den Eigenschaften des adaptiven Formulars ein Datensatzdokument generieren.

Senden mit Formulardatenmodell

Die Übermittlungsaktion Senden mit Formulardatenmodell schreibt gesendete Daten eines adaptiven Formulars für das angegebene Datenmodellobjekt in die Datenquelle eines Formulardatenmodells. 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 AEM Forms Datenintegration.

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 der Autoreninstanz. Sie können die Datendatei, die Anhänge und das Datensatzdokument am Payload-Speicherort des Workflows oder in einer Variablen speichern. Wenn der Workflow für die externe Datenspeicherung markiert und für eine externe Datenspeicherung konfiguriert ist, ist nur die Variablenoption verfügbar. Sie können aus der Liste der für das Workflow-Modell verfügbaren Variablen auswählen. Wenn der Workflow für die externe Datenspeicherung zu einem späteren Zeitpunkt und nicht zum Zeitpunkt der Workflow-Erstellung markiert ist, stellen Sie sicher, dass die erforderlichen Variablenkonfigurationen vorhanden sind.

Die Übermittlungsaktion platziert Folgendes im Payload-Speicherort des Workflows oder der Variablen, wenn der Workflow für die externe Datenspeicherung markiert ist:

  • Datendatei: Sie enthält Daten, die an das adaptive Formular gesendet werden. Mit der Option Datendateipfad können Sie den Dateinamen und den Dateipfad relativ zur Payload angeben. Beispielsweise erstellt der Pfad /addresschange/data.xml einen Ordner mit dem Namen addresschange und platziert ihn relativ zur Payload. Sie können auch nur data.xml angeben, um nur die übermittelten Daten zu senden, ohne die Erstellung einer Ordnerhierarchie. Wenn der Workflow für die externe Datenspeicherung markiert ist, verwenden Sie die Variablenoption und wählen Sie die Variable aus der Liste der Variablen aus, die für das Workflow-Modell verfügbar sind.

  • Anlagen: Mit der Option Anlagenpfad können Sie den Ordnernamen zum Speichern der in das adaptive Formular hochgeladenen Anlagen angeben. Der Ordner wird immer relativ zur Payload erstellt. Wenn der Workflow für die externe Datenspeicherung markiert ist, verwenden Sie die Variablenoption und wählen Sie die Variable aus der Liste der Variablen aus, die für das Workflow-Modell verfügbar sind.

  • Datensatzdokument: Es enthält das Datensatzdokument, das für das adaptive Formular generiert wurde. Mit der Option Pfad des Datensatzdokuments können Sie den Dateinamen des Datensatzdokuments sowie den Dateipfad relativ zur Payload angeben. Beispiel: Der Pfad /addresschange/DoR.pdf erstellt einen Ordner mit dem Namen addresschange relativ zur Payload und platziert DoR.pdf relativ zur Payload. Um nur das Datensatzdokument zu speichern, ohne eine Ordnerhierarchie zu erstellen, reicht die Angabe DoR.pdf. Wenn der Workflow für die externe Datenspeicherung markiert ist, verwenden Sie die Variablenoption und wählen Sie die Variable aus der Liste der Variablen aus, die für das Workflow-Modell verfügbar sind.

Bevor Sie die Übermittlungsaktion AEM-Workflow aufrufen verwenden, richten Sie die Konfiguration des AEM DS-Konfigurations-Service wie folgt ein:

  • Verarbeitungs-Server-URL: Der Verarbeitungs-Server ist der Server, auf dem der Forms- oder AEM-Workflow ausgelöst wird. Diese URL kann mit der URL der AEM-Autoreninstanz oder eines anderen Servers identisch sein.

  • Verarbeitungsserver-Benutzername: Benutzername des Workflow-Benutzers

  • Verarbeitungsserver-Kennwort: Kennwort des Workflow-Benutzers

An SharePoint senden

Die An SharePoint übermitteln Übermittlungsaktion verbindet ein adaptives Formular mit einem Microsoft® SharePoint-Speicher. Sie können die Formulardatendatei, die Anlagen oder das Datensatzdokument an den verbundenen Microsoft® Sharepoint Storage senden. So verwenden Sie die An SharePoint übermitteln Übermittlungsaktion in einem adaptiven Formular:

  1. Erstellen einer SharePoint-Konfiguration: Dadurch wird AEM Forms mit Ihrem Microsoft® Sharepoint Storage verbunden.
  2. Verwenden der Sendeaktion "An SharePoint übermitteln"in einem adaptiven Formular: Dadurch wird Ihr adaptives Formular mit dem konfigurierten Microsoft® SharePoint verbunden.

Erstellen einer SharePoint-Konfiguration

So verbinden Sie AEM Forms mit Ihrem Microsoft® SharePoint-Speicher:

  1. Gehen Sie zu AEM Forms Author instance > Instrumente > Cloud Services > Microsoft® SharePoint.

  2. Nachdem Sie die Microsoft® SharePoint, werden Sie zu SharePoint-Browser.

  3. Wählen Sie eine Konfigurations-Container. Die Konfiguration wird im ausgewählten Konfigurations-Container gespeichert.

  4. Klicken Sie auf Erstellen. Der SharePoint-Konfigurationsassistent wird angezeigt.
    SharePoint-Konfiguration

  5. Geben Sie die Titel, Client-ID, Client Secret und OAuth-URL. Informationen zum Abrufen der Client-ID, des Client-Geheimnisses und der Mandanten-ID für die OAuth-URL finden Sie unter Dokumentation zu Microsoft®.

    • Sie können die Client ID und Client Secret Ihrer App vom Microsoft® Azure-Portal aus.
    • Fügen Sie im Portal Microsoft® Azure den Umleitungs-URI als https://[author-instance]/libs/cq/sharepoint/content/configurations/wizard.html. Ersetzen [author-instance] mit der URL Ihrer -Autoreninstanz.
    • API-Berechtigungen hinzufügen offline_access und Sites.Manage.All um Lese-/Schreibberechtigungen bereitzustellen.
    • Verwenden der OAuth-URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Ersetzen <tenant-id> mit dem tenant-id Ihrer App vom Microsoft® Azure-Portal aus.
    HINWEIS

    Die Client-Geheimnis -Feld ist obligatorisch oder je nach Konfiguration der Azure Active Directory-Anwendung optional. Wenn Ihre Anwendung so konfiguriert ist, dass ein Client-Geheimnis verwendet wird, müssen Sie das Client-Geheimnis angeben.

  6. Klicken Sie auf Verknüpfen. Bei einer erfolgreichen Verbindung muss die Variable Connection Successful angezeigt.

  7. Wählen Sie jetzt SharePoint-Site > Dokumentbibliothek > SharePoint-Ordner, um die Daten zu speichern.

    HINWEIS
    • Standardmäßig forms-ootb-storage-adaptive-forms-submission ist auf der ausgewählten SharePoint-Site vorhanden.
    • Erstellen eines Ordners als forms-ootb-storage-adaptive-forms-submission, falls nicht bereits im Documents Bibliothek der ausgewählten SharePoint-Site durch Klicken auf Ordner erstellen.

Jetzt können Sie diese SharePoint Sites-Konfiguration für die Sendeaktion in einem adaptiven Formular verwenden.

Verwenden der SharePoint-Konfiguration in einem adaptiven Formular

Sie können die erstellte SharePoint-Konfiguration in einem adaptiven Formular verwenden, um Daten zu speichern oder das generierte Datensatzdokument in einem SharePoint-Ordner zu speichern. Führen Sie die folgenden Schritte aus, um eine SharePoint-Speicherkonfiguration in einem adaptiven Formular zu verwenden:

  1. Erstellen Sie eine Adaptives Formular.

    HINWEIS
    • Gleiches auswählen Konfigurations-Container für ein adaptives Formular, in dem Sie Ihren SharePoint-Speicher erstellt haben.
    • Wenn nicht Konfigurations-Container ausgewählt ist, wird die globale Speicherkonfiguration Ordner werden im Fenster Eigenschaften von Übermittlungsaktionen angezeigt.
  2. Auswählen Übermittlungsaktion as An SharePoint übermitteln.
    Sharepoint-GIF

  3. Wählen Sie die Speicherkonfiguration, wo Sie Ihre Daten speichern möchten.

  4. Klicken Speichern , um die Sendeeinstellungen zu speichern.

Wenn Sie das Formular übermitteln, werden die Daten im angegebenen Microsoft® Sharepoint Storage gespeichert.
Ordnerstruktur zum Speichern von Daten: /folder_name/form_name/year/month/date/submission_id/data.

An OneDrive senden

Die An OneDrive übermitteln "Submit Action"verbindet ein adaptives Formular mit einem Microsoft® OneDrive. Sie können die Formulardaten, Dateien, Anhänge oder Datensatzdokumente an den verbundenen Microsoft® OneDrive-Speicher senden. So verwenden Sie die An OneDrive übermitteln Übermittlungsaktion in einem adaptiven Formular:

  1. OneDrive-Konfiguration erstellen: Dadurch wird AEM Forms mit Ihrem Microsoft® OneDrive-Speicher verbunden.
  2. Verwenden Sie die Sendeaktion "An OneDrive übermitteln"in einem adaptiven Formular: Dadurch wird Ihr adaptives Formular mit dem konfigurierten Microsoft® OneDrive verbunden.

OneDrive-Konfiguration erstellen

So verbinden Sie AEM Forms mit Ihrem Microsoft® OneDrive-Speicher:

  1. Gehen Sie zu AEM Forms Author instance > Instrumente > Cloud Services > Microsoft® OneDrive.

  2. Nachdem Sie die Microsoft® OneDrive, werden Sie zu OneDrive-Browser.

  3. Wählen Sie eine Konfigurations-Container. Die Konfiguration wird im ausgewählten Konfigurations-Container gespeichert.

  4. Klicken Sie auf Erstellen. Der OneDrive-Konfigurationsassistent wird angezeigt.

    OneDrive-Konfigurationsbildschirm

  5. Geben Sie die Titel, Client-ID, Client Secret und OAuth-URL. Informationen zum Abrufen der Client-ID, des Client-Geheimnisses und der Mandanten-ID für die OAuth-URL finden Sie unter Dokumentation zu Microsoft®.

    • Sie können die Client ID und Client Secret Ihrer App vom Microsoft® Azure-Portal aus.
    • Fügen Sie im Portal Microsoft® Azure den Umleitungs-URI als https://[author-instance]/libs/cq/onedrive/content/configurations/wizard.html. Ersetzen [author-instance] mit der URL Ihrer -Autoreninstanz.
    • API-Berechtigungen hinzufügen offline_access und Files.ReadWrite.All um Lese-/Schreibberechtigungen bereitzustellen.
    • Verwenden der OAuth-URL: https://login.microsoftonline.com/tenant-id/oauth2/v2.0/authorize. Ersetzen <tenant-id> mit dem tenant-id Ihrer App vom Microsoft® Azure-Portal aus.
    HINWEIS

    Die Client-Geheimnis -Feld ist obligatorisch oder je nach Konfiguration der Azure Active Directory-Anwendung optional. Wenn Ihre Anwendung so konfiguriert ist, dass ein Client-Geheimnis verwendet wird, müssen Sie das Client-Geheimnis angeben.

  6. Klicken Sie auf Verknüpfen. Bei einer erfolgreichen Verbindung muss die Variable Connection Successful angezeigt.

  7. Wählen Sie jetzt OneDrive-Container > [OneDrive-Ordner] , um die Daten zu speichern.

    HINWEIS
    • Standardmäßig forms-ootb-storage-adaptive-forms-submission ist im OneDrive-Container vorhanden.
    • Erstellen eines Ordners als forms-ootb-storage-adaptive-forms-submission, falls nicht bereits vorhanden, durch Klicken auf Ordner erstellen.

Jetzt können Sie diese OneDrive-Speicherkonfiguration für die Sendeaktion in einem adaptiven Formular verwenden.

Verwenden der OneDrive-Konfiguration in einem adaptiven Formular

Sie können die erstellte OneDrive-Speicherkonfiguration in einem adaptiven Formular verwenden, um Daten zu speichern oder das generierte Datensatzdokument in einem OneDrive-Ordner zu speichern. Führen Sie die folgenden Schritte aus, um die OneDrive-Speicherkonfiguration in einem adaptiven Formular zu verwenden:

  1. Erstellen Sie eine Adaptives Formular.

    HINWEIS
    • Gleiches auswählen Konfigurations-Container für ein adaptives Formular, in dem Sie Ihren OneDrive-Speicher erstellt haben.
    • Wenn nicht Konfigurations-Container ausgewählt ist, wird die globale Speicherkonfiguration Ordner werden im Fenster Eigenschaften von Übermittlungsaktionen angezeigt.
  2. Auswählen Übermittlungsaktion as An OneDrive übermitteln.
    OneDrive-GIF

  3. Wählen Sie die Speicherkonfiguration, wo Sie Ihre Daten speichern möchten.

  4. Klicken Speichern , um die Sendeeinstellungen zu speichern.

Wenn Sie das Formular übermitteln, werden die Daten im angegebenen Microsoft® OneDrive-Speicher gespeichert.
Ordnerstruktur zum Speichern von Daten: /folder_name/form_name/year/month/date/submission_id/data.

An Azure Blob-Speicher senden

Die Senden an Azure Blob Storage Übermittlungsaktion verbindet ein adaptives Formular mit einem Microsoft® Azure-Portal. Sie können die Formulardaten, Dateien, Anhänge oder Datensatzdokumente an die verbundenen Azure Storage-Container senden. So verwenden Sie die Übermittlungsaktion für Azure Blob Storage:

  1. Erstellen eines Azure Blob Storage-Containers: Dadurch wird AEM Forms mit Azure Storage-Containern verbunden.
  2. Verwenden der Azure-Speicherkonfiguration in einem adaptiven Formular : Dadurch wird Ihr adaptives Formular mit konfigurierten Azure Storage-Containern verbunden.

Erstellen eines Azure Blob Storage-Containers

So verbinden Sie AEM Forms mit Ihren Azure Storage-Containern:

  1. Gehen Sie zu AEM Forms Author instance > Instrumente > Cloud Services > Azure-Speicher.

  2. Nachdem Sie die Azure-Speicher, werden Sie zu Azure Storage Browser.

  3. Wählen Sie eine Konfigurations-Container. Die Konfiguration wird im ausgewählten Konfigurations-Container gespeichert.

  4. Klicken Sie auf Erstellen. Der Assistent zum Erstellen der Azure-Speicherkonfiguration wird angezeigt.

    Azure-Speicherkonfiguration

  5. Geben Sie die Titel, Azure-Speicherkonto und Azure Access Key.

    • Sie können Azure Storage Account Name und Azure Access key über die Speicherkonten im Microsoft® Azure-Portal.
  6. Klicken Sie auf Speichern.

Jetzt können Sie diese Azure Storage-Container-Konfiguration für die Sendeaktion in einem adaptiven Formular verwenden.

Verwenden der Azure-Speicherkonfiguration in einem adaptiven Formular

Sie können die erstellte Azure Storage Container-Konfiguration in einem adaptiven Formular verwenden, um Daten zu speichern oder das generierte Datensatzdokument im Azure Storage-Container zu speichern. Führen Sie die folgenden Schritte aus, um die Konfiguration des Azure Storage-Containers in einem adaptiven Formular zu verwenden:

  1. Erstellen Sie eine Adaptives Formular.

    HINWEIS
    • Gleiches auswählen Konfigurations-Container für ein adaptives Formular, in dem Sie Ihren OneDrive-Speicher erstellt haben.
    • Wenn nicht Konfigurations-Container ausgewählt ist, wird die globale Speicherkonfiguration Ordner werden im Fenster Eigenschaften von Übermittlungsaktionen angezeigt.
  2. Auswählen Übermittlungsaktion as Senden an Azure Blob Storage.
    Azure Blob Storage-GIF

  3. Wählen Sie die Speicherkonfiguration, wo Sie Ihre Daten speichern möchten.

  4. Klicken Speichern , um die Sendeeinstellungen zu speichern.

Wenn Sie das Formular senden, werden die Daten in der angegebenen Azure Storage Container-Konfiguration gespeichert.
Ordnerstruktur zum Speichern von Daten: /configuration_container/form_name/year/month/date/submission_id/data.

Um Konfigurationswerte festzulegen, generieren Sie OSGi-Konfigurationen mit dem AEM-SDK und stellen Sie die Konfiguration in Ihrer Cloud Service-Instanz bereit.

Verwenden synchroner oder asynchroner Übermittlung

Eine Übermittlungsaktion kann die synchrone oder asynchrone Übermittlungsmethode verwenden.

Synchrone Übermittlung: Web-Formulare werden im Allgemeinen für die synchrone Übermittlung konfiguriert. Bei der synchronen Übermittlung werden Benutzer, die ein Formular senden, zu einer Bestätigungsseite, zu einer Dankeseite oder bei fehlgeschlagener Übermittlung zu einer Fehlerseite umgeleitet. Sie können die Option Verwendung von asynchroner Übermittlung wählen, um die Benutzer zu einer Web-Seite umzuleiten oder eine Nachricht beim Senden anzuzeigen.

Konfigurieren der Übermittlungsaktion

Asynchrone Übermittlung: Moderne Web-Erlebnisse wie Einzelseitenanwendungen sind zunehmend beliebt. Dabei bleibt die Web-Seite unverändert, während die Client-Server-Interaktion im Hintergrund abläuft. Für adaptive Formulare können Sie diese Erfahrung nun bieten, indem Sie die asynchrone Übermittlung konfigurieren.

Server-seitige Überprüfung im adaptiven Formular

Normalerweise platzieren Entwickler in jedem Online-Datenerfassungssystem einige Javascript-Validierungen auf Client-Seite, um 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. Diese Techniken sind auch für adaptive Formulare gültig. 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 eine erneute Server-seitige Ü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 standardmäßig 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

Aktivieren von Server-seitiger 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 das ursprüngliche Formular erneut präsentiert. Die erfassten Daten und die gesendeten Daten werden dem Benutzer als Fehler angezeigt.

HINWEIS

Die Server-seitige Validierung prüft das Formularmodell. Es wird empfohlen, eine separate Client-Bibliothek für Validierungen zu erstellen und sie nicht mit anderen Elementen wie HTML-Stil und DOM-Manipulation in derselben Client-Bibliothek zu mischen.

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 Ausdruck 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

Unterstützende benutzerdefinierte Funktionen in Validierungsausdrücken

Der Autor kann eine benutzerdefinierte JavaScript-Bibliothek für jedes adaptive Formular konfigurieren. Legen Sie in der Bibliothek nur die wiederverwendbaren Funktionen ab, die von den Drittanbieter-Bibliotheken „jquery“ und „underscore“ abhängen.

Fehlerbehandlung bei Übermittlungsaktionen

Als Teil AEM Richtlinien für Sicherheit und Härtung konfigurieren Sie benutzerdefinierte Fehlerseiten wie 400.jsp, 404.jsp und 500.jsp. Diese Handler werden aufgerufen, wenn beim Senden eines Formulars die Fehler-Codes 400, 404 oder 500 auftreten. Die Handler werden auch aufgerufen, wenn diese Fehler-Codes auf einem Veröffentlichungsknoten ausgelöst werden. Sie können JSP-Seiten auch für andere HTTP-Fehler-Codes erstellen.

Wenn Sie ein Formulardatenmodell oder ein Schema-basiertes adaptives Formular mit XML- oder JSON-Daten ausfüllen, die konform zu einem Schema sind, bei dem Daten keine <afData>-, <afBoundData>- und </afUnboundData>-Tags enthalten, gehen die Daten der ungebundenen Felder des adaptiven Formulars verloren. Das Schema kann ein XML-Schema, ein JSON-Schema oder ein Formulardatenmodell sein. Ungebundene Felder sind Felder des adaptiven Formulars ohne die Eigenschaft bindref.

Auf dieser Seite