Adaptive Formularfragmente adaptive-form-fragments
Adobe empfiehlt die Verwendung der modernen und erweiterbaren Kernkomponentenzur Datenerfassung für das Erstellen neuer adaptiver Formulareoder das Hinzufügen von adaptiven Formularen zu AEM Sites-SeitenDiese Komponenten stellen einen bedeutenden Fortschritt bei der Erstellung adaptiver Formulare dar und sorgen für beeindruckende Anwendererlebnisse. In diesem Artikel wird der ältere Ansatz zum Erstellen adaptiver Formulare mithilfe von Foundation-Komponenten beschrieben.
Zwar wird 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, Familienstand 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 werden müssen und dann in adaptiven Formularen wiederverwendet werden können. Diese wiederverwendbaren, unabhängigen Segmente werden als adaptive Formularfragmente bezeichnet.
Erstellen eines Fragments create-a-fragment
Sie können adaptive Formularfragmente von Grund auf neu erstellen oder ein Bedienfeld in einem vorhandenen adaptiven Formular als Fragment speichern.
Neuerstellen von Fragmenten create-fragment-from-scratch
-
Melden Sie sich bei der Author-Instanz von AEM Forms unter https://[Hostname]:[Port]/aem/forms.html an.
-
Klicken Sie auf Erstellen > Adaptives Formularfragment.
-
Geben Sie Titel, Name, Beschreibung und Tags für das Fragment an.
note note NOTE 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. -
Klicken Sie, um die Registerkarte Formularmodell zu öffnen. Wählen Sie dann aus der Dropdown-Liste Auswählen eines der folgenden Fragmentmodelle:
-
Keine: Gibt an, dass das Fragment von Grund auf ohne Formularmodell erstellt werden soll.
note note NOTE Im adaptiven Formularen, die auf Kernkomponenten basieren, können Sie ein einzelnes Formularfragment mehrmals in einem Formular verwenden. Es werden sowohl auf nichts basierende als auch schemabasierte Formularfragmente unterstützt. -
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 Dropdown-Liste auswählen.
Außerdem können Sie ein adaptives Formularfragment aus Unterformularen erstellen, die nicht als Fragmente in der Formularvorlage markiert sind, indem Sie den SOM-Ausdruck für das Unterformular 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.
-
-
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 in der 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. Sie können dann Formularmodellelemente auf das Fragment ziehen. Die hinzugefügten Formularmodellelemente werden in Formularkomponenten konvertiert, wobei die ursprünglichen Eigenschaften des verbundenen XDP oder XSD beibehalten werden.
Bereich als Fragment speichern save-panel-as-a-fragment
-
Öffnen Sie ein adaptives Formular mit dem Panel, das Sie als adaptives Formularfragment speichern möchten.
-
Klicken Sie in der Symbolleiste des Bedienfelds auf Als Fragment speichern. Das Dialogfeld „Als Fragment speichern“ wird geöffnet.
note note NOTE Wenn das Bedienfeld, das Sie als Fragment speichern, ein untergeordnetes Bedienfeld umfasst, ist dieses auch im resultierenden Fragment enthalten. -
Geben Sie im Dialogfeld für die Fragmenterstellung die folgenden Informationen an:
-
Name: Name des Fragments. Der Standardwert ist der Elementname des Panels. Dies ist ein Pflichtfeld.
note note NOTE 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. -
Titel: Titel des Formulars. Der Standardwert ist der Titel des Bedienfelds.
-
Beschreibung: Beschreibung des Fragments.
-
Tags: Kennzeichnet Metadaten für das Fragment.
-
Zielpfad: Pfad zum Repository, in dem das Fragment gespeichert wird. Wenn Sie keinen Pfad angeben, wird ein Knoten mit dem Namen des Fragments neben dem Knoten erstellt, der das adaptive Formular enthält. Das Fragment wird in diesem Knoten gespeichert.
-
Formularmodell: Je nach Formularmodell für das adaptive Formular wird im Feld das XML-Schema, die Formularvorlage oder Keine angezeigt. Dies ist ein Feld, das nicht bearbeitet werden kann.
-
Fragmentmodellstamm: Diese Option 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. Sie können das Fragment nur in einem anderen adaptiven Formular wiederverwenden, wenn Sie als Fragmentmodellstamm den komplexen Typ 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 einen Fragmentmodellstamm mit komplexem Typ werden lediglich die untergeordneten Elemente des ausgewählten komplexen Typs auf der Registerkarte „Datenmodell“ des adaptiven Formulars angezeigt. Wenn Sie ein Fragment erstellen und einen komplexen Typ als Fragmentmodellstamm festlegen, können Sie es überall dort einsetzen, wo dieser komplexe Typ verwendet wird (entweder innerhalb desselben Formulars oder formularübergreifend). -
XSD-REF: Diese Option ist nur in den XSD-basierten adaptiven Formularen verfügbar. Sie zeigt den Ort des XML-Schemas an.
-
XDP-Ref: Diese Option wird nur in XDP-basierten adaptiven Formularen angezeigt. Es wird der Speicherort der XDP-Vorlage angezeigt.
Dialogfeld „Als Fragment speichern“.
-
-
Klicken Sie auf OK.
Das Panel wird am angegebenen oder am Standardspeicherort im Repository gespeichert. In einem adaptiven Formular wird das Panel 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 auf einer neuen Registerkarte oder in einem neuen Fenster im Bearbeitungsmodus geöffnet.
Arbeiten mit Fragmenten working-with-fragments
Konfigurieren des Erscheinungsbildes von Fragmenten configure-fragment-appearance
Alle Fragmente, die Sie in adaptive Formulare einfügen, werden 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 anzeigen zu können:
-
Wechseln Sie zur Seite zur Konfiguration der AEM-Web-Konsole unter https://[Host]:[Port]/system/console/configMgr.
-
Suchen Sie die Web-Kanal-Konfiguration für adaptive Formulare und interaktive Kommunikation und klicken Sie darauf, um sie im Bearbeitungsmodus zu öffnen.
-
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 insert-a-fragment-in-an-adaptive-form
Die adaptiven Formularfragmente, die Sie erstellen, werden auf der Registerkarte „Adaptive Formularfragmente“ der AEM-Inhaltssuche angezeigt. So fügen Sie ein adaptives Formularfragment in ein adaptives Formular ein:
-
Öffnen Sie im Bearbeitungsmodus das adaptive Formular, in das Sie ein adaptives Formularfragment einfügen möchten.
-
Klicken Sie in der Seitenleiste auf Assets
Sie können auch festlegen, dass alle adaptiven Formularfragmente angezeigt werden oder dass nach Formularmodell (Formularvorlage, XML-Schema oder Allgemein) gefiltert wird.
-
Ziehen Sie ein adaptives Formularfragment auf das adaptive Formular.
note note NOTE Das Fragment des adaptiven Formulars ist nicht für das Authoring vom adaptiven Formular aus aktiviert. Darüber hinaus ist es nicht möglich, ein XSD-basiertes Fragment in einem JSON-basierten adaptiven Formular und umgekehrt zu verwenden.
Das adaptive Formularfragment wird als Verweis in das adaptive Formular eingefügt und mit dem eigenständigen adaptiven Formularfragment synchronisiert. Das bedeutet, dass beim Aktualisieren des adaptiven Formularfragments die Änderungen in allen adaptiven Formularen übernommen werden, in denen das Fragment verwendet wird.
Einbetten eines Fragments in ein adaptives Formular embed-a-fragment-in-adaptive-form
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 using-fragments-within-fragments
Sie können verschachtelte adaptive Formularfragmente erstellen, d. h. ein Fragment in ein anderes Fragment ziehen, um eine verschachtelte Fragmentstruktur zu erhalten.
Ändern von Fragmenten change-fragments
Sie können ein adaptives Formularfragment ändern oder durch ein anderes ersetzen, indem Sie im Dialogfeld „Komponente bearbeiten“ die Eigenschaft Fragment-Asset auswählen für ein Panel mit adaptivem Formularfragment verwenden.
Generieren eines Datensatzdokuments für adaptive Formularfragmente generate-DOR-for-fragments
Mit dem Nachweis (Document of Record, DoR) können Sie Informationen zu Ihren Formularen im Druck- oder Dokumentformat speichern. Dadurch können Sie jederzeit Informationen über Ihre Kundinnen und Kunden nachverfolgen und mithilfe des Nachweises Formulare und Inhalte im PDF-Format archivieren. Erfahren Sie, wie Sie ein Datensatzdokument für adaptive Formularfragmente generieren.
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.
- Wenn Sie auf nichts basierende Formularfragmente mehrfach in einem adaptiven Formular verwenden, wird eine Datensynchronisierung zwischen den Feldern der Fragmente durchgeführt. Das Problem mit der Datensynchronisierung tritt nicht in auf Kernkomponenten basierenden Formularfragmenten auf, bei denen Sie ein Fragment entweder auf einem Schema basierend oder auf nichts basierend mehrmals in einem Formular verwenden können.
Automatisches Zuordnen von Fragmenten für die Datenbindung auto-mapping-of-fragments-for-data-binding
Wenn Sie ein adaptives Formularfragment mit einer XFA-Formularvorlage oder einem komplexen XSD-Typ erstellen und es 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. komplexen XSD-Typ zugeordnet ist.
Das Fragment-Asset und dessen Bindungen können im Dialogfeld „Komponente bearbeiten“ geändert werden.
Verwalten von Fragmenten manage-fragments
Sie können mithilfe von AEM Forms mehrere Aktionen für adaptive Formularfragmente ausführen.
-
Rufen Sie
https://[hostname]:'port'/aem/forms.htmlauf. -
Klicken Sie in der Symbolleiste der AEM Forms-Benutzeroberfläche auf Auswählen und wählen Sie ein adaptives Formularfragment aus. Die Symbolleiste zeigt die folgenden Vorgänge an, die Sie für das ausgewählte adaptive Formularfragment ausführen können.
Lokalisieren von adaptiven Formularen mit Fragmenten localizing-adaptive-form-containing-fragments
Zum Lokalisieren eines adaptiven Formulars, das adaptive Formularfragmente enthält, müssen Sie die Fragmente und das Formular separat lokalisieren. Auf diese Weise muss ein Fragment nur einmal lokalisiert werden und kann dann später in mehreren adaptiven Formularen wiederverwendet werden.
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.
- 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. Im Falle eines XSD-basierten adaptiven Formulars ist 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. Zum Beispiel wird in einem XSD-basierten adaptiven Formular ein XDP-basiertes Fragment nicht unterstützt und umgekehrt.
- Adaptive Formularfragmente sind auf der Registerkarte „Adaptive Formularfragmente“ der 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.
- 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 als Verweis im adaptiven Formular eingefügt wurden.
- Wenn Sie ein aktualisiertes adaptives Formularfragment veröffentlichen, werden die Änderungen in den veröffentlichten Instanzen des adaptiven Formulars übernommen, in denen das Fragment verwendet wird.
- Adaptive Formulare, die die Überprüfungskomponente enthalten, unterstützen keine anonymen Benutzenden. Außerdem wird davon abgeraten, 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 reference-fragments
Es sind Referenzfragmente für adaptive Formulare verfügbar, die Sie zum Erstellen von Formularen verwenden können. Weitere Informationen finden Sie unter Referenzfragmente.