Adaptive Formularfragmente

Adobe empfiehlt die Verwendung der modernen und erweiterbaren Datenerfassung Kernkomponenten für Erstellen neuer adaptiver Forms oder Hinzufügen von Adaptive Forms zu AEM Sites-Seiten. Diese Komponenten stellen einen bedeutenden Fortschritt bei der Erstellung adaptiver Forms dar und sorgen für beeindruckende Benutzererlebnisse. In diesem Artikel wird der ältere Ansatz zum Erstellen von Adaptive Forms mithilfe von Foundation-Komponenten beschrieben.

Zwar wird jedes Formular für einen bestimmten Zweck entwickelt, doch enthalten die meisten Formularen einige gängige Elemente (z. B. für persönliche Angaben wie Name und Anschrift, Angaben zu Familienstand, Einkommen usw.). Formularentwicklerinnen und -entwickler müssen diese gängigen Segmente jedes Mal erstellen, wenn ein neues Formular erstellt wird.

Adaptive Formulare bieten einen bequemen Mechanismus, um Formularsegmente wie ein Bedienfeld oder eine Gruppe von Feldern nur einmal zu erstellen und sie in adaptiven Formularen wiederzuverwenden. Diese wiederverwendbaren und eigenständigen Segmente werden als adaptive Formularfragmente bezeichnet.

Erstellen eines Fragments

Sie können ein adaptives Formularfragment von Grund auf neu erstellen oder ein Bedienfeld in einem vorhandenen adaptiven Formular als Fragment speichern.

Neuerstellen von Fragmenten

1. Melden Sie sich bei der Author-Instanz von AEM Forms unter https://[Hostname]:[Port]/aem/forms.html an.

2. Klicken Sie auf Erstellen > Adaptives Formularfragment.

3. Geben Sie Titel, Namen, Beschreibung und Tags für das Fragment an.

   HINWEIS

   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. Klicken Sie, um die Registerkarte Formularmodell zu öffnen. Wählen Sie dann aus der Dropdown-Liste Auswählen eines der folgenden Fragmentmodelle:

   • Keins: Gibt an, dass das Fragment von Grund auf ohne Formularmodell erstellt werden soll.
   • Formularvorlage: Das Fragment mit mithilfe einer XDP-Vorlage erstellt, die auf AEM Forms hochgeladen wurde. Wählen Sie die entsprechende XDP-Vorlage als Formularmodell für das Fragment aus.

   

   Die Teilformulare, die als Fragmente in der ausgewählten Vorlage markiert sind, werden ebenfalls angezeigt. Sie können ein Teilformular für ein adaptives Formularfragment aus der Dropdownliste auswählen.

   

   Darüber hinaus können Sie ein adaptives Formularfragment mithilfe von Teilformularen erstellen, die nicht als Fragmente in der Formularvorlage markiert sind, indem Sie den SOM-Ausdruck für das Teilformular in der Dropdown-Liste angeben.

   • XML-Schema: Das Fragment wird mithilfe eines XML-Schemas erstellt, das auf AEM Forms hochgeladen wurde. Sie können ein XML-Schema als Formularmodell hochladen oder aus den verfügbaren Schemas wählen.

   

   Sie können ein adaptives Formularfragment auch erstellen, indem Sie einen „complexType“ im ausgewählten Schema aus der Dropdownliste wählen.

   

5. Klicken Sie auf Erstellen und dann auf Öffnen, um das Fragment mit einer Standardvorlage im Bearbeitungsmodus zu öffnen.

Im Bearbeitungsmodus können Sie eine beliebige adaptive Formularkomponente aus dem AEM Sidekick auf das Fragment ziehen. Weitere Informationen zu adaptiven Formularkomponenten finden Sie unter Einführung in das Authoring adaptiver Formulare.

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. Damit können Sie Formularmodellelemente per Drag & Drop 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.

Bereich als Fragment speichern

1. Öffnen Sie ein adaptives Formular, das den Bereich enthält, den Sie als adaptives Formularfragment speichern möchten.

2. Klicken Sie in der Symbolleiste des Bedienfelds auf Als Fragment speichern. Das Dialogfeld „Als Fragment speichern“ wird geöffnet.

   HINWEIS

   Wenn das Bedienfeld, das Sie gerade speichern, ein untergeordnetes Bedienfeld enthält, wird dieses auch im resultierenden Fragment enthalten sein.

3. Geben Sie im Dialogfeld „Fragmenterstellung“ die folgenden Informationen an:

   • Name: Name des Fragments. Der Standardwert ist der Elementname des Bedienfelds. Dies ist ein Pflichtfeld.

     HINWEIS

     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.

   • Titel: Titel des Formulars. Der Standardwert ist der Titel des Bedienfelds.

   • Beschreibung: Beschreibung des Fragments.

   • Tags: Kennzeichnet Metadaten für das Fragment.

   • Zielpfad: Pfad für das Repository, in dem das Fragment gespeichert wird. Wenn Sie keinen Pfad angeben, wird neben dem Knoten, der das adaptive Formular enthält, ein Knoten mit demselben Namen wie der des Fragments erstellt. Das Fragment wird in diesem Knoten gespeichert.

   • Formularmodell: Je nach Formularmodell für das adaptive Formular zeigt dieses Feld die XML-Schema, Formularvorlage oder Keines. Dies ist ein Feld, das nicht bearbeitet werden kann.

   • Fragmentmodellstamm: Wird nur in XSD-basierten adaptiven Formularen angezeigt. Sie gibt den Stamm für das Fragmentmodell an. Sie können auch / oder den komplexen XSD-Typ aus der Dropdown-Liste auswählen. Beachten Sie, dass Sie das Fragment nur in einem anderen adaptiven Formular wiederverwenden können, wenn Sie den komplexen Typ als Fragmentmodellstamm auswählen.
     Wenn Sie / als Fragmentmodellstamm auswählen, wird die vollständige XSD-Struktur vom Stamm in der Registerkarte für das Datenmodell des adaptiven Formulars angezeigt. Für Fragmentmodellstamm eines komplexen Typs werden lediglich die untergeordneten Elemente des ausgewählten komplexen Typs in der Registerkarte des Datenmodells des adaptiven Formulars angezeigt.

   • XSD-REF: Diese Option ist nur in den XSD-basierten adaptiven Formularen verfügbar. Sie zeigt den Ort des XML-Schemas an.

   • XDP Ref: Wird nur in XDP-basierten adaptiven Formularen angezeigt. Es wird der Speicherort der XDP-Vorlage angezeigt.

   

   Dialogfeld „Als Fragment speichern“

4. Klicken Sie auf OK.

   Das Bedienfeld wird am angegebenen oder am Standardspeicherort im Repository gespeichert. Im adaptiven Formular wird das Bedienfeld durch eine Momentaufnahme des Fragments ersetzt. Wie unten gezeigt, werden das Bedienfeld „Allgemeine Informationen“ und seine untergeordneten Bedienfelder, „Persönliche Informationen“ und „Adresse“, als Fragment gespeichert.

   Um das Fragment zu bearbeiten, klicken Sie in der Symbolleiste des Bedienfelds auf das Symbol Element bearbeiten. Das Fragment wird in einer neuen Registerkarte oder einem neuen Fenster im Bearbeitungsmodus geöffnet.

   

Arbeiten mit Fragmenten

Konfigurieren des Erscheinungsbildes von Fragmenten

Jedes Fragment, das Sie in adaptive Formulare einfügen, wird als Platzhalterbild angezeigt. Der Platzhalter zeigt die Titel von bis zu maximal zehn untergeordneten Bedienfeldern im Fragment an. Sie können AEM Forms so konfigurieren, dass das vollständige Fragment anstelle des Platzhalterbilds angezeigt wird.

Führen Sie die folgenden Schritte aus, um vollständige Fragmente in Formularen anzuzeigen:

1. Wechseln Sie zur Seite zur Konfiguration der AEM-Web-Konsole unter https://[Host]:[Port]/system/console/configMgr.

2. Suchen und klicken Sie auf Webkanal-Konfiguration für adaptive Formulare und interaktive Kommunikation, um sie im Bearbeitungsmodus zu öffnen.

3. Deaktivieren Sie das Kontrollkästchen Platzhalter anstelle des Fragments aktivieren, um vollständige Fragmente anstelle des Platzhalterbildes anzuzeigen.

Einfügen eines Fragments in ein adaptives Formular

Die von Ihnen erstellten adaptiven Formularfragmente werden auf der Registerkarte Adaptive Formularfragmente in der AEM Inhaltssuche angezeigt. Einfügen eines adaptiven Formularfragments in ein adaptives Formular:

1. Öffnen Sie das adaptive Formular im Bearbeitungsmodus, in das Sie ein adaptives Formularfragment einfügen möchten.

2. Klicken Sie in der Seitenleiste auf Assets . Wählen Sie im Assets-Browser Adaptive Formularfragmente aus der Dropdown-Liste.

   Sie können auch festlegen, dass alle adaptiven Formularfragmente angezeigt oder nach Formularmodell (Formularvorlage, XML-Schema oder Allgemein) gefiltert werden.

3. Ziehen Sie ein adaptives Formularfragment per Drag-and-Drop in das adaptive Formular.

   HINWEIS

   Das Fragment des adaptiven Formulars ist nicht für das Authoring vom adaptiven Formular aus aktiviert. Außerdem können Sie kein XSD-basiertes Fragment in einem JSON-basierten adaptiven Formular und umgekehrt verwenden.

Das adaptive Formularfragment wird als Verweis in das adaptive Formular eingefügt und mit dem eigenständigen adaptiven Formularfragment synchronisiert. Das bedeutet, dass die Änderungen beim Aktualisieren des adaptiven Formularfragments in allen adaptiven Formularen übernommen werden, in denen das Fragment verwendet wird.

Einbetten eines Fragments in ein adaptives Formular

Sie können ein adaptives Formularfragment in ein adaptives Formular einbetten, indem Sie in der Symbolleiste des hinzugefügten Fragments auf Fragment einbetten: <fragmentName> (siehe Beispielbild unten) klicken.

Verwenden von Fragmenten innerhalb von Fragmenten

Sie können verschachtelte adaptive Formularfragmente erstellen, d. h. Sie können ein Fragment per Drag-and-Drop in ein anderes Fragment ziehen und eine verschachtelte Fragmentstruktur haben.

Ändern von Fragmenten

Sie können ein adaptives Formularfragment durch ein anderes ersetzen oder ändern, indem Sie Fragment-Asset auswählen -Eigenschaft im Dialogfeld "Komponente bearbeiten"für ein adaptives Formularfragment-Bedienfeld.

Automatisches Zuordnen von Fragmenten für die Datenbindung

Wenn Sie ein adaptives Formularfragment mit einer XFA-Formularvorlage oder einem komplexen XSD-Typ erstellen und das Fragment in ein adaptives Formular ziehen, wird das XFA-Fragment oder der komplexe XSD-Typ automatisch durch das entsprechende adaptive Formularfragment ersetzt, dessen Fragmentmodellstamm dem XFA-Fragment oder komplexen XSD-Typ zugeordnet ist.

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

Verwalten von Fragmenten

Sie können mithilfe der AEM Forms-Benutzeroberfläche mehrere Vorgänge für adaptive Formularfragmente ausführen.

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

2. Klicks Auswählen Wählen Sie in der Symbolleiste der AEM Forms-Benutzeroberfläche ein adaptives Formularfragment aus. In der Symbolleiste werden die folgenden Vorgänge angezeigt, die Sie für das ausgewählte adaptive Formularfragment ausführen können.

Lokalisieren von adaptiven Formularen mit Fragmenten

Um ein adaptives Formular zu lokalisieren, das adaptive Formularfragmente enthält, müssen Sie das Fragment und das Formular separat lokalisieren. Es wird empfohlen, ein Fragment einmal zu lokalisieren und es in mehreren adaptiven Formularen wiederzuverwenden.

Wichtige Hinweise zum Arbeiten mit Fragmenten

• Stellen Sie sicher, dass der Fragmentname eindeutig ist. Das Fragment kann nicht erstellt werden, wenn ein vorhandenes Fragment mit demselben Namen vorhanden ist.
• Wenn Sie in einem XDP-basierten adaptiven Formular ein Bedienfeld speichern, das ein anderes XDP-Fragment enthält, wird das daraus resultierende Fragment automatisch an das untergeordnete XDP-Fragment gebunden. Wenn ein XSD-basiertes adaptives Formular vorhanden ist, 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 in einem adaptiven Formular, das ein anderes Formulardatenmodell verwendet, wird nicht unterstützt. Beispielsweise wird ein XDP-basiertes Fragment in einem XSD-basierten adaptiven Formular nicht unterstützt und umgekehrt.
• Adaptive Formularfragmente sind über die Registerkarte Adaptive Formularfragmente in AEM Inhaltssuche 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.
• Sie können ein adaptives Formularfragment, das als Verweis eingefügt wird, nicht in einem adaptiven Formular bearbeiten. Sie bearbeiten das eigenständige adaptive Formularfragment oder betten das Fragment im adaptiven Formular ein.
• Wenn Sie ein adaptives Formular veröffentlichen, müssen Sie die eigenständigen adaptiven Formularfragmente veröffentlichen, die als Verweis in das adaptive Formular eingefügt wurden.
• Wenn Sie ein aktualisiertes adaptives Formularfragment erneut veröffentlichen, werden die Änderungen in den veröffentlichten Instanzen des adaptiven Formulars übernommen, in denen das Fragment verwendet wird.
• Das adaptive Formular, das die Überprüfungskomponente enthält, unterstützt keine anonymen Benutzer. Außerdem wird nicht empfohlen, die Verify-Komponente 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 verfügbar, mit denen Sie Ihr Formular erstellen können. Weitere Informationen finden Sie unter Referenzfragmente.