Formular-Container-Komponente

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

Nutzung

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.

Version und Kompatibilität

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.

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

Ü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:

• Formulardaten posten
• E-Mail
• Inhalt speichern

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

Formulardaten posten

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

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

E-Mail

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

• 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

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

• 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.

Allgemeine Einstellungen

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

• 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 „Arten“

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