Erstellen und Verwenden adaptiver Formularfragmente in einem adaptiven Formular basierend auf Kernkomponenten adaptive-form-fragments

Version
Artikel-Link
AEM as a Cloud Service (Kernkomponenten)
Dieser Artikel
AEM as a Cloud Service (Foundation-Komponenten)
Hier klicken
AEM 6.5
Hier klicken

Zwar wurde jedes Formular für einen bestimmten Zweck entwickelt, aber in den meisten Formularen gibt es gängige Segmente für persönliche Angaben wie Name und Anschrift, Familienmitglieder und Einkommen. Eine Formularentwicklerin bzw. ein Formularentwickler muss diese gängigen Segmente jedes Mal erstellen, wenn ein neues Formular erstellt wird.

Adaptive Formulare bieten einen praktischen Mechanismus, mit dem Formularsegmente wie ein Bedienfeld oder eine Gruppe von Feldern nur einmal erstellt und dann in adaptiven Formularen wiederverwendet werden können. Diese wiederverwendbaren, unabhängigen Segmente werden als adaptive Formularfragmente bezeichnet.

Formularfragmente lassen sich nahtlos in mehrere Formulare integrieren, wodurch die Erstellung konsistenter und professionell aussehender Formulare optimiert wird. Formularfragmente sorgen für Wiederverwendbarkeit, Standardisierung und Markenkonsistenz durch die Funktion „Einmal ändern und überall widerspiegeln“. Erleben Sie mehr Wartbarkeit und Effizienz, da Aktualisierungen an einem Ort automatisch über alle Formulare hinweg übernommen werden, die diese Fragmente verwenden.

Sie können ein Fragment mehrmals zu einem Dokument hinzufügen und die Datenbindungseigenschaften seiner Komponenten verwenden, um es mit verschiedenen Datenquellen oder Schemata zu verknüpfen. Beispielsweise können Sie dasselbe Adressfragment für permanente, Kommunikations- und Abrechnungsadressen verwenden und es mit verschiedenen Feldern einer Datenquellen oder eines Schemas verbinden.

NOTE
Mit dem Konfigurationsdialogfeld und dem Design-Dialogfeld der Formularfragment-Komponente können Sie Ihre Fragmente ganz einfach an die Bedürfnisse der Benutzenden anpassen.

Erstellen eines adaptiven Formularfragments create-a-fragment

Sie können adaptive Formularfragmente von Grund auf neu erstellen oder ein Panel in einem vorhandenen adaptiven Formular als Fragment speichern. So erstellen Sie ein Formularfragment:

  1. Melden Sie sich bei Ihrer AEM Forms-Instanz unter https://[hostname]:[port]/aem/forms.html an.

  2. Klicken Sie auf Erstellen > Adaptives Formularfragment.

    Erstellen eines adaptiven Formularfragments

  3. Geben Sie Titel, Namen, Beschreibung und Tags für das Fragment an. Stellen Sie sicher, dass Sie einen eindeutigen Namen für das Fragment angeben. Wenn bereits ein anderes Fragment mit demselben Namen vorhanden ist, kann das Fragment nicht erstellt werden.

  4. Wählen Sie eine Formularvorlage aus. Sie können ein Formularfragment für auf Kernkomponenten basierende adaptive Formulare oder auf Foundation-Komponenten basierende adaptive Formulare erstellen. Um Formularfragmente für auf Kernkomponenten basierende Formulare zu erstellen, wählen Sie eine auf Kernkomponenten basierende Vorlage aus.

    Wenn Sie Formularfragmente für auf Kernkomponenten basierende Formulare erstellen, verwenden Sie die Option „Formular-Design auswählen“, um ein Kernkomponenten-basiertes Design auszuwählen.

  5. Klicken Sie, um die Registerkarte Formularmodell zu öffnen. Wählen Sie dann aus der Dropdown-Liste Auswählen aus eines der folgenden Fragmentmodelle:

    Zeigt den Modelltyp auf der Registerkarte „Formularmodell“ an

    • Keine: Gibt an, dass das Fragment von Grund auf ohne Formularmodell erstellt werden soll.

      note note
      NOTE
      In adaptiven Formularen können Sie ein einzelnes Formularfragment (basierend auf Kernkomponenten) mehrmals verwenden. Es unterstützt sowohl auf nichts basierende als auch schemabasierte Formularfragmente.
    • Schema: Das Fragment wird mithilfe eines XML- oder JSON-Schemas erstellt, das auf AEM Forms hochgeladen wurde. Sie können ein XML- oder JSON-Schema als Formularmodell hochladen oder aus den verfügbaren Schemata wählen. Wenn Sie ein XML-Schema auswählen, können Sie auch ein adaptives Formularfragment erstellen, indem Sie einen „complexType“ im ausgewählten Schema aus der Dropdown-Liste XML-Schema – komplexer Typ auswählen. Wenn Sie ein JSON-Schema auswählen, können Sie auch ein adaptives Formularfragment erstellen, indem Sie eine Schemadefinition im ausgewählten Schema aus der Dropdown-Liste JSON-Schemadefinitionen auswählen.

    • Formulardatenmodell: Gibt an, dass das Fragment mit einem Formulardatenmodell (FDM) erstellt werden soll. Sie können ein adaptives Formularfragment auf Grundlage eines einzelnen Datenmodellobjekts in einem Formulardatenmodell (FDM) erstellen. Erweitern Sie die Dropdown-Liste mit Definitionen für Formulardatenmodelle (FDM). Hier sind sämtliche Datenmodellobjekte im angegebenen Formulardatenmodell (FDM) aufgelistet. Wählen Sie ein Datenmodellobjekt aus der Liste aus.

    Formulardatenmodell (FDM)

  6. Klicken Sie auf Erstellen und dann auf Öffnen, um das Fragment mit einer Standardvorlage im Bearbeitungsmodus zu öffnen. Im Bearbeitungsmodus können Sie dem Fragment eine beliebige Komponente des adaptiven Formulars hinzufügen.

Wenn das auf einem Schema oder Formulardatenmodell (FDM) basierende adaptive Formularfragment erstellt ist, werden Formulardatenmodelle (FDM) oder Schemaelemente auf der Registerkarte „Datenquellen“ des Inhalts-Browsers im Editor für adaptive Formulare angezeigt. Sie können per Drag-and-Drop Formularmodellelemente auf das Fragment ziehen. Die hinzugefügten Formularmodellelemente werden in Formularkomponenten konvertiert, während die ursprünglichen Eigenschaften aus dem zugehörigen Schema beibehalten werden.

Hinzufügen eines Fragments zu einem adaptiven Formular insert-a-fragment-in-an-adaptive-form

So fügen Sie einem adaptiven Formular ein adaptives Formularfragment hinzu:

  1. Öffnen Sie das adaptive Formular im Bearbeitungsmodus.

  2. Fügen Sie die Adaptives Formularfragment-Komponente in das Formular ein.

  3. Öffnen Sie das Dialogfeld „Konfiguration“ der Komponente Adaptives Formularfragment.

  4. Wählen Sie den Fragmentverweis auf der Registerkarte Allgemein aus. Je nach Formularmodell werden alle für Ihr Formular verfügbaren adaptiven Formularfragmente angezeigt.

  5. Wählen Sie ein adaptives Formularfragment auf der Komponente Adaptives Formularfragment in Ihrem adaptiven Formular aus.

    Wählen Sie die Option „Adaptive Formularfragmente“ aus

Das adaptive Formularfragment wird als Verweis in das adaptive Formular eingefügt und bleibt mit dem eigenständigen adaptiven Formularfragment synchronisiert. Dies bedeutet, dass alle Änderungen am adaptiven Formularfragment über alle Instanzen hinweg gespiegelt werden, in denen das Fragment in adaptive Formulare integriert ist.

Verwenden von Fragmenten innerhalb von Fragmenten using-fragments-within-fragments

Sie können verschachtelte adaptive Formularfragmente erstellen, d. h. ein Fragment in einem anderen Fragment hinzufügen, um eine verschachtelte Fragmentstruktur zu erstellen.

Mehrfaches Verwenden eines Formularfragments in einem adaptiven Formular using-form-fragment-mutiple-times-in-af

Sie können ein schemabasiertes Formularfragment mehrfach in einem adaptiven Formular verwenden, um Daten für jedes Formularfragmentfeld eindeutig zu speichern. Es ist beispielsweise möglich, ein Adressformularfragment zu verwenden, um Adressangaben zum ständigen Wohnsitz, zur Kommunikation und zum aktuellen Wohnsitz in einem Kreditantragsformular zu erfassen.

Verwenden mehrerer Fragmente in einem adaptiven Formular

Verwalten von Fragmenten manage-fragments

Sie können über die Benutzeroberfläche von AEM Forms mehrere Vorgänge mit adaptiven Formularfragmenten durchführen.

  1. Rufen Sie https://[hostname]/aem/forms.html auf.

  2. Klicken Sie in der Symbolleiste von AEM Forms auf Auswählen und wählen Sie ein adaptives Formularfragment aus. Die Symbolleiste zeigt die folgenden Vorgänge an, die Sie mit dem ausgewählten adaptiven Formularfragment durchführen können.

Vorgang
Beschreibung
Bearbeiten
Öffnet das ausgewählte adaptive Formularfragment im Bearbeitungsmodus.
Vorschau
Enthält Optionen zum Anzeigen einer HTML- oder benutzerdefinierten Vorschau des Fragments durch Zusammenführen von Daten aus einer XML-Datei und dem Fragment. Weitere Informationen finden Sie unter Erstellen einer Vorschau für ein Formular.
Download
Lädt das ausgewählte Fragment herunter.
Review starten/verwalten
Initiieren und Verwalten einer Review des ausgewählten Fragments. Weitere Informationen finden Sie unter Erstellen und Verwalten von Reviews.
Wörterbuch hinzufügen
Erzeugt ein Wörterbuch zum Lokalisieren des ausgewählten Fragments. Weitere Informationen finden Sie unter Lokalisieren adaptiver Formulare.
Veröffentlichen/Veröffentlichung rückgängig machen
Veröffentlicht das ausgewählte Fragment bzw. macht die Veröffentlichung rückgängig.
Löschen
Löscht das ausgewählte Fragment.

Wichtige Hinweise zum Arbeiten mit Fragmenten key-points-to-remember-when-working-with-fragments

  • Stellen Sie sicher, dass der Fragmentname eindeutig ist. Wenn bereits ein anderes Fragment mit demselben Namen vorhanden ist, kann das Fragment nicht erstellt werden.
  • Alle Ausdrücke, Skripte oder Stile in einem eigenständigen adaptiven Formularfragment bleiben erhalten, wenn es als Verweis eingefügt oder in ein adaptives Formular eingebettet wird.
  • Adaptive Formularfragmente, die als Verweis eingefügt wurden, können nicht in einem adaptiven Formular bearbeitet werden. Ändern Sie zum Bearbeiten das eigenständige adaptive Formularfragment.
  • Wenn Sie ein adaptives Formular veröffentlichen, müssen Sie die eigenständigen adaptiven Formularfragmente veröffentlichen, die per Verweis in das adaptive Formular eingefügt wurden.
  • Beim erneuten Veröffentlichen eines aktualisierten adaptiven Formularfragments werden die Änderungen in den veröffentlichten Instanzen des adaptiven Formulars, in denen das Fragment verwendet wird, wiedergegeben.
  • Adaptive Formulare, die die Überprüfungskomponente enthalten, unterstützen keine anonymen Benutzenden. Außerdem wird nicht empfohlen, die Überprüfungskomponente in einem adaptiven Formularfragment zu verwenden.

Referenzfragmente reference-fragments

Es sind Referenzfragmente für adaptive Formulare vorhanden, die Sie zum Erstellen von Formularen verwenden können.

Siehe auch see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab