Adaptive Formularfragmente

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.). Ein Formularentwickler muss diese gängigen Segmente jedes Mal erstellen, wenn ein neues Formular erstellt wird.

Adaptive Formulare bieten einen praktischen Mechanismus, um Formularsegmente wie ein Feld oder eine Gruppe von Feldern nur einmal zu erstellen und sie in adaptiven Formularen wiederzuverwenden. Diese wiederverwendbaren, unabhängigen Segmente werden als „adaptive Formularfragmente“ bezeichnet.

Erstellen eines Fragments

Sie können adaptive Formularfragmente von Grund auf neu erstellen oder ein Fenster 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, Name, Beschreibung und Tags für das Fragment an.

    HINWEIS

    Stellen Sie sicher, dass Sie einen eindeutigen Namen für das Fragment eingeben. 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:

    • Kein: Das Fragment wird von Grund auf ohne Formularmodell erstellt.
    • 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.

    Erstellen eines adaptiven Formulars mit einer Formularvorlage als Modell

    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 wählen.

    Auswählen von Teilformularen aus der angegebenen Formularvorlage

    Außerdem können Sie ein adaptives Formularfragment aus Teilformularen erstellen, die nicht als Fragmente in der Formularvorlage markiert sind, indem Sie den SOM-Ausdruck für das Teilformular in der Dropdownliste 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.

    Erstellen eines adaptiven Formularfragments, das auf einem XML-Schema basiert

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

    Wählen Sie einen komplexen Typ aus dem angegebenen XML-Schema-Modell.

  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 zum Erstellen adaptiver Formulare.

Wenn Sie ein XML-Schema oder eine XDP-Formularvorlage als Formularmodell für das Fragment ausgewählt haben, wird eine neue Registerkarte mit der Formularmodellhierarchie in der Inhaltssuche 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

  1. Öffnen Sie ein adaptives Formular, das dieses Bedienfeld enthält, das 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 Bereich 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 eingeben. 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 ein Knoten mit demselben Namen wie der 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 das XML-Schema, die Formularvorlage oder Ohne 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. 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: Diese Option ist nur in den XDP-basierten adaptiven Formularen verfügbar. Es wird der Speicherort der XDP-Vorlage angezeigt.

    save-fragment

    Dialogfeld „Als Fragment speichern“.

  4. Klicken Sie auf OK.

    Das Fenster wird am angegebenen oder am Standardspeicherort im Repository gespeichert. In einem adaptiven Formular wird das Fenster durch einen Schnappschuss 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.

    Bearbeiten von Fragmenten

Arbeiten mit Fragmenten

Konfigurieren des Erscheinungsbildes von Fragmenten

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 konfigurieren, um das vollständige Fragment anstelle des Platzhalterbildes anzuzeigen.

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 von Fragment aktivieren, um das vollständige Fragment anstelle des Platzhalterbildes anzuzeigen.

Einfügen eines Formularfragments in ein adaptives Formular

Die adaptive Formularfragmente, die Sie erstellen, werden auf der Registerkarte „Adaptive Formularfragmente“ der AEM Inhaltssuche angezeigt. Einfügen eines adaptiven Formularfragments in ein adaptives Formular

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

  2. Klicken Sie in der Seitenleiste auf Assets assets-browser. 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 auf das adaptive Formular.

    HINWEIS

    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, wenn Sie das adaptive Formularfragment aktualisieren, werden die Änderungen in allen adaptiven Formularen übernommen, in denen das Fragment verwendet wird.

Einbetten eines Formularfragments 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.

Einbetten eines Formularfragments in ein adaptives Formular

HINWEIS

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

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.

Ändern von Fragmenten

Sie können ein adaptives Formularfragment ändern oder durch ein anderes ersetzen, indem Sie die Eigenschaft Fragmentasset auswählen im Dialogfeld „Komponente bearbeiten“ eines adaptiven Formularfragments verwenden.

Automatisches Zuordnen von Fragmenten für die Datenbindung

Wenn Sie ein adaptives Formularfragment mithilfe 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.

HINWEIS

Sie können auch 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 mehrere Vorgänge auf adaptive Formularfragmente mithilfe von AEM Forms ausführen.

  1. Rufen Sie https://[hostname]:'port'/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 enthält die folgenden Vorgänge, die Sie auf dem ausgewählten adaptiven Formularfragment ausführen können.

Vorgang

Beschreibung

Öffnen

Öffnet das Dialogfeld adaptive Formularfragment im Bearbeitungsmodus.

Eigenschaften anzeigen

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

Kopieren

Kopiert das ausgewählte Fragment. Das Symbol „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 erstellen

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

Lokalisieren von adaptiven Formularen mit Fragmenten

Zum Lokalisieren eines adaptiven Formulars, das adaptive Formularfragmente enthält, müssen Sie das Fragment 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.

HINWEIS

Die Lokalisierungsschlüssel im Fragment werden nicht in der XLIFF-Datei für ein adaptives Formular angezeigt.

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 XDP-Fragment des untergeordneten Elements 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 in einem adaptiven Formular, das ein anderes Formulardatenmodell verwendet, wird nicht unterstützt. Zum Beispiel wird ein XDP-basiertes Fragment in einem XSD-basierten adaptiven Formular nicht unterstützt und umgekehrt.
  • Adaptive Formularfragmente sind auf der Registerkarte „Adaptive Formularfragmente“ in der AEM Inhaltssuche verfügbar.
  • Alle Ausdrücke, Skripts 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 adaptive Formularfragmente, die als Verweis eingefügt wurden, nicht innerhalb eines adaptiven Formulars bearbeiten. 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 das eigenständige adaptive Formularfragment veröffentlichen, das als Verweis im adaptiven Formular eingefügt wurde.
  • Wenn Sie ein aktualisiertes adaptives Formularfragment veröffentlichen, werden die Änderungen in den veröffentlichten Instanzen des adaptiven Formulars vorgenommen, in denen das Fragment verwendet wird.
  • Adaptive Formulare, die die Verify-Komponente enthalten, unterstützen 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 vorhanden, die Sie verwenden können, um die Formular zu erstellen. Weitere Informationen finden Sie unter Referenzfragmente.

Auf dieser Seite