Formular-Container-Komponente form-container-component

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

Nutzung usage

Die Formular-Container-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.

Mithilfe des Dialogfelds „Konfigurieren“ kann der Inhaltsbearbeiter die durch die Formularübermittlung ausgelöste Aktion definieren sowie die URL, die die Übermittlung handhaben soll, und ob ein Workflow ausgelöst werden soll. 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.

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

Version und Kompatibilität version-and-compatibility

Die aktuelle Version der Formular-Container-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 mit
Version 2.17.4 und vorherigen
Kompatibel
Kompatibel
v1
Kompatibel
Kompatibel
Kompatibel

Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie im Dokument Kernkomponentenversionen.

Musterkomponentenausgabe sample-component-output

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

Technische Details technical-details

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

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

Dialogfeld „Konfigurieren“ configure-dialog

Ü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 post-data

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

Optionen zum Posten von Formulardaten im Dialogfeld „Bearbeiten“ der Formular-Container-Komponente

  • Endpunkt – Der vollständig qualifizierte HTTPS-Dienst, der die Daten verarbeitet
  • Fehlermeldung – Meldung, die angezeigt wird, wenn die Übermittlung nicht erfolgreich war
TIP
Es gibt zusätzliche Timeout-Optionen, die ein Systemadministrator einstellen kann, um die Verarbeitung der weitergeleiteten Formulardaten zu handhaben. Weitere Informationen finden Sie in der technischen Dokumentation zu GitHub.

E-Mail 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

  • Bis - 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 store-content

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.
NOTE
Um die Verwaltung von Benutzerdaten zu vereinfachen und die Trennung von Problemen zu erzwingen, wird im Allgemeinen nicht empfohlen, von Benutzern erstellte Inhalte im Repository zu speichern.
Verwenden Sie stattdessen den Aktionstyp Formulardaten posten, um Benutzerinhalte an einen dedizierten Dienstleister weiterzuleiten.

Allgemeine Einstellungen general-settings

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 bzw. der Autorin sicherzustellen, dass diese eindeutig ist.
    • Änderungen der ID können sich auf das CSS-, JS- und Datenschicht-Tracking auswirken.

Dialogfeld „Design“ design-dialog

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 „Arten“ styles-tab

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

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c