Formularcontainer-Komponente

Die Kernkomponente „Formularcontainer-Komponente“ ermöglicht die Erstellung einfacher Übermittlungsformulare.

Verwendung

Die Formularcontainer-Komponente ermöglicht das Erstellen einfacher Informationsübermittlungsformulare und -funktionen, indem einfache WCM-Formulare unterstützt werden und eine verschachtelte Struktur verwendet wird, um zusätzliche Formularkomponenten zuzulassen.

By using the configure dialog the content editor can define the action triggered by form submission, the URl that should handle the submission, and whether a workflow should be triggered. Der Vorlagenautor kann das Dialogfeld „Design“ verwenden, um die zulässigen Komponenten und deren Zuordnungen ähnlich dem Dialogfeld „Design“ für den Standard-Layout-Container im Vorlageneditor zu definieren.

Hinweis

Die Kernkomponente „Formularcontainer-Komponente“ unterstützt nur die Verwendung anderer Formularkomponenten-Kernkomponenten (Schaltfläche, Text, ausgeblendet usw.). Die Verwendung von Foundation-Komponenten Formularkomponenten innerhalb der Formularcontainer-Kernkomponenten (und umgekehrt) wird nicht unterstützt.

Version und Kompatibilität

Die aktuelle Version der Formularcontainer-Komponente ist v2, die mit Version 2.0.0 der Kernkomponenten im Januar 2018 eingeführt wurde und in diesem Dokument beschrieben wird.

Die folgende Tabelle enthält alle unterstützten Versionen der Komponente, die AEM-Versionen, mit denen die Versionen der Komponente kompatibel sind, sowie Links zur Dokumentation für frühere Versionen.

Komponentenversion AEM 6.4 AEM 6.5 AEM as a Cloud Service
v2 Kompatibel Kompatibel Kompatibel
v1 Kompatibel Kompatibel -

Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie in den Kernkomponentenversionen.

Musterkomponentenausgabe

Um die Formular-Container-Komponente kennenzulernen und Beispiele für die Konfigurationsoptionen sowie HTML- und JSON-Ausgaben anzuzeigen, besuchen Sie die Komponentenbibliothek.

Technische Details

Die neueste technische Dokumentation zur Formularcontainer-Komponente finden Sie auf GitHub.

Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler.

Dialogfeld „Konfigurieren“

Über das Dialogfeld „Konfigurieren“ können Sie festlegen, welche Aktionen beim Senden der Komponente durchgeführt werden.

Je nach ausgewähltem Aktionstyp werden die verfügbaren Optionen im Container geändert. Die verfügbaren Aktionstypen sind:

Unabhängig vom Typ gibt es allgemeine Einstellungen, die für jede Aktion gelten.

Formulardaten posten

Wenn das Formular gesendet wird, übergibt der Aktionstyp für Formulardaten die gesendeten Daten zur Verarbeitung als JSON an einen Drittanbieter.

Optionen für Formulardaten im Dialogfeld "Bearbeiten"der Form Container-Komponente

  • Endpunkt - Der vollständig qualifizierte HTTPS-Dienst, der die Daten verarbeitet
  • Fehlermeldung - Meldung, die angezeigt wird, wenn die Übermittlung nicht erfolgreich war
TIPP

Es gibt zusätzliche Timeout-Optionen, die ein Systemadministrator an die Verarbeitung weitergeleiteter Formulardaten anpassen kann. Weitere Informationen finden Sie in der technischen Dokumentation zu GitHub.

E-Mail

Wenn das Formular gesendet wird, sendet der Mail-Aktionstyp eine E-Mail an bestimmte Empfänger.

E-Mail-Optionen im Dialogfeld „Bearbeiten“ der Formular-Container-Komponente

  • Betreff - Betreffzeile der E-Mail, die beim Übermitteln des Formulars gesendet wird
  • Von - die Absenderadresse der E-Mail, die beim Übermitteln des Formulars gesendet wird
  • An - Die Adressen der Empfänger, die eine E-Mail bei der Formularübermittlung erhalten
    • Tippen oder klicken Sie auf die Schaltfläche Hinzufügen, um weitere Adressen hinzuzufügen.
    • Tippen oder klicken Sie auf die Schaltfläche Löschen, um eine E-Mail-Adresse zu entfernen.
  • CC - Die Adressen der Empfänger, die eine Kopie der E-Mail erhalten, die beim Übermitteln des Formulars gesendet wird
    • Tippen oder klicken Sie auf die Schaltfläche Hinzufügen, um weitere Adressen hinzuzufügen.
    • Tippen oder klicken Sie auf die Schaltfläche Löschen, um eine E-Mail-Adresse zu entfernen.

Inhalt speichern

Wenn das Formular übermittelt wird, wird der Inhalt des Formulars in einem bestimmten Repository gespeichert.

Optionen zum Speichern von Inhalten im Dialogfeld „Bearbeiten“ des Formular-Containers

  • Inhalts-Pfad - Inhalts-Repository-Pfad, in dem der übermittelte Inhalt gespeichert wird
  • Daten anzeigen - Tippen oder klicken Sie, um gespeicherte gesendete Daten als JSON anzuzeigen.
  • Workflow starten - Konfigurieren Sie den Start eines Workflows mit dem gespeicherten Inhalt als Nutzlast bei Formularübermittlung.
Hinweis

Um die Verwaltung von Benutzerdaten zu vereinfachen und die Trennung von Problemen zu erzwingen, wird im Allgemeinen nicht empfohlen, benutzerdefinierte Inhalte im Repository zu speichern.

Verwenden Sie stattdessen den Aktionstyp " Formulardaten veröffentlichen", um Benutzerinhalte an einen dedizierten Dienstleister weiterzuleiten.

Allgemeine Einstellungen

Unabhängig vom ausgewählten Aktionstyp kann eine Dankeseite immer definiert werden.

Allgemeine Optionen im Dialogfeld „Bearbeiten“ der Formular-Container-Komponente

  • Dankeseite – Der Benutzer wird nach Abschluss der Formularübermittlung zur angegebenen Seite weitergeleitet.
    • Verwenden Sie das Dialogfeld „Auswahl“, um eine Ressource in AEM auszuwählen.
    • Wenn die Dankeseite nicht in AEM enthalten ist, geben Sie die absolute URL an. Nicht absolute URLs werden relativ zu AEM interpretiert.
    • Leer lassen, damit das Formular nach der Übermittlung wieder angezeigt wird.
  • ID – Diese Option dient zur Kontrolle der eindeutigen Kennung der Komponente in der HTML-Datei und auf der Datenschicht.
    • Wenn Sie das Feld leer lassen, wird automatisch eine eindeutige ID generiert, die Sie über die resultierende Seite finden.
    • Sofern eine ID angegeben wird, ist vom Autor sicherzustellen, dass diese eindeutig ist.
    • Änderungen der ID können sich auf das CSS-, JS- und Datenschicht-Tracking auswirken.

Dialogfeld „Design“

Das Dialogfeld „Design“ ermöglicht es dem Vorlagenautor, die zulässigen Komponenten und deren Zuordnungen für den Container ähnlich dem Dialogfeld „Design“ für den Standard-Layout-Container im Vorlageneditor zu definieren.

Registerkarte „Stile“

Die Formular-Container-Komponente unterstützt das Stilsystem von AEM.

Auf dieser Seite