Erstellen und Verwenden adaptiver Formularfragmente in einem adaptiven Formular basierend auf Kernkomponenten

Letzte Aktualisierung: 2024-01-25
Version Artikel-Link
AEM as a Cloud Service Dieser Artikel
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. Formularentwicklerinnen und -entwickler müssen 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.

HINWEIS

Sie können Ihre Fragmenterfahrung für Benutzer einfach mit der Dialogfeld "Konfigurieren"und Dialogfeld "Design"der Formularfragment-Komponente.

Erstellen eines Formularfragments

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:// an.[hostname]:[port]/aem/forms.html

  2. Klicken Sie auf Erstellen > Adaptives Formularfragment.

  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 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 Kernkomponenten-basierte adaptive Formular- oder Foundation-Komponenten-basierte adaptive Formulare erstellen.

    • Um Formularfragmente für auf Kernkomponenten basierende Formulare zu erstellen, wählen Sie eine auf Kernkomponenten basierende Vorlage aus.
    • Um Formularfragmente für auf Foundation-Komponenten basierende Formulare zu erstellen, wählen Sie eine Vorlage für Foundation-Komponenten aus. Beispiel: /libs/fd/af/templateForFragment/defaultFragmentTemplate.

    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.

      HINWEIS

      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 erstellt werden soll. Sie können ein adaptives Formularfragment auf Grundlage eines einzelnen Datenmodellobjekts in einem Formulardatenmodell erstellen. Erweitern Sie die Dropdown-Liste mit Definitionen für Formulardatenmodelle. Hier sind sämtliche Datenmodellobjekte im angegebenen Formulardatenmodell aufgelistet. Wählen Sie ein Datenmodellobjekt aus der Liste aus.

    Formulardatenmodell

  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 Sie außerdem ein XML-Schema oder eine XDP-Formularvorlage als Formularmodell für Ihr Fragment ausgewählt haben, wird in der Inhaltssuche eine neue Registerkarte mit der Formularmodellhierarchie angezeigt. Sie können dann Formularmodellelemente auf das Fragment ziehen. Die hinzugefügten Formularmodellelemente werden in Formularkomponenten konvertiert, während die ursprünglichen Eigenschaften aus der zugehörigen XDP oder XSD beibehalten werden.

Wenn das auf einem Schema- oder Formulardatenmodell basierende adaptive Formularfragment erstellt ist, werden Formulardatenmodelle 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

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. Klicken Sie in der Seitenleiste auf den Assets-Inhalts-Browser. Wählen Sie im Asset-Browser unter den Pfaden die Option Adaptive Formularfragmente. Je nach Formularmodell werden alle für Ihr Formular verfügbaren adaptiven Formularfragmente angezeigt.

    Wählen Sie die Option „Adaptive Formularfragmente“ aus

  4. Ziehen Sie ein adaptives Formularfragment per Drag-and-Drop in die Adaptives Formularfragment-Komponente in Ihrem adaptiven Formular.

    HINWEIS

    Das adaptive Formularfragment kann nicht aus dem adaptiven Formular heraus erstellt werden. Darüber hinaus ist es nicht möglich, ein XSD-basiertes Fragment in einem JSON-basierten adaptiven Formular oder ein JSON-basiertes Fragment in einem XSD-basierten Formular zu verwenden.

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.

Einbetten eines Fragments in ein adaptives Formular

Sie können ein adaptives Formularfragment in ein adaptives Formular einbetten, indem Sie auf das Symbol Einbetten in der Symbolleiste des Bedienfelds des hinzugefügten Fragments klicken

Das eingebettete Fragment ist nicht mehr mit dem eigenständigen Fragment verknüpft. Die Komponenten im eingebetteten Fragment können aus dem adaptiven Formular heraus bearbeitet werden.

Verwenden von Fragmenten innerhalb von Fragmenten

Sie können verschachtelte adaptive Formularfragmente erstellen, d. h. ein Fragment in ein anderes Fragment ziehen, um eine verschachtelte Fragmentstruktur zu erstellen.

Mehrfaches Verwenden eines Formularfragments in einem adaptiven Formular

Sie können ein nicht-basiertes und schemabasiertes Formularfragment mehrmals in einem adaptiven Formular verwenden, um Daten für jedes Formularfragmentfeld eindeutig zu speichern. Sie können beispielsweise ein Adressformularfragment verwenden, um Adressdetails permanent für die Kommunikation zu erfassen und aktive Adressen in einem Kreditantragsformular darzustellen.

Verwenden mehrerer Fragmente im adaptiven Formular

Automatisches Zuordnen von Fragmenten für die Datenbindung

Wenn Sie ein adaptives Formularfragment mithilfe einer XFA-Formularvorlage oder eines komplexen XSD-Typs erstellen und es per Drag-and-Drop auf ein adaptives Formular ziehen, wird das XFA-Fragment bzw. der komplexe XSD-Typ automatisch durch das entsprechende adaptive Formularfragment ersetzt, dessen Fragmentmodellstamm dem XFA-Fragment bzw. dem komplexen XSD-Typ zugeordnet ist.

Das Fragment-Asset und dessen Bindungen können im Dialogfeld „Komponente bearbeiten“ geändert werden.

Sie können auch per Drag-and-Drop ein gebundenes adaptives Formularfragment aus der adaptiven Formularfragment-Bibliothek in der AEM-Inhaltssuche ziehen und den richtigen Bindungsverweis aus dem Dialogfeld „Komponente bearbeiten“ des Bereichs „Adaptives Formularfragment“ angeben.

Verwalten von Fragmenten

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.

Eigenschaften

Öffnet das Bedienfeld „Eigenschaften“. Im Bedienfeld „Eigenschaften“ können Sie Eigenschaften anzeigen und bearbeiten, eine Vorschau erstellen und ein Miniaturbild für das ausgewählte Fragment hochladen. Weitere Informationen finden Sie unter Verwalten von Metadaten.

Kopieren

Kopiert das ausgewählte Fragment. Die Schaltfläche „Einfügen“ wird in der Symbolleiste angezeigt.

Download

Lädt das ausgewählte Fragment herunter.

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.

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

  • Stellen Sie sicher, dass der Fragmentname eindeutig ist. Wenn bereits ein anderes Fragment mit demselben Namen vorhanden ist, kann das Fragment nicht erstellt werden.
  • Wenn Sie in einem XDP-basierten adaptiven Formular ein Bedienfeld, das ein anderes XDP-Fragment enthält, als Fragment speichern, wird das daraus resultierende Fragment automatisch an das untergeordnete XDP-Fragment gebunden. Bei XSD-basierten adaptiven Formularen wird das resultierende Fragment an den Schemastamm gebunden.
  • Wenn Sie ein adaptives Formularfragment erstellen, wird ein Fragmentknoten erstellt, der dem Knoten guideContainer für ein adaptives Formular in CRXDE Lite ähnelt.
  • Ein Fragment, das ein anderes Formulardatenmodell verwendet, wird in einem adaptiven Formular nicht unterstützt. Beispielsweise wird ein XDP-basiertes Fragment in einem XSD-basierten adaptiven Formular nicht unterstützt und umgekehrt.
  • Adaptive Formularfragmente sind in der AEM-Inhaltssuche auf der Registerkarte „Adaptive Formularfragmente“ verfügbar.
  • 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. Sie bearbeiten stattdessen entweder das eigenständige adaptive Formularfragment oder betten das Fragment in das adaptive Formular ein.
  • 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.
  • (Nur Mac) Um sicherzustellen, dass die Formularfragmentfunktionalität in allen Szenarien einwandfrei funktioniert, fügen Sie der Datei „/private/etc/hosts“ den folgenden Eintrag hinzu:
    127.0.0.1 <Host machine> Hostcomputer: Der Apple Mac-Computer, auf dem AEM Forms bereitgestellt wird.

Referenzfragmente

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

Siehe auch

Auf dieser Seite