Verwenden von Formulardatenmodellen

Letzte Aktualisierung: 2024-03-04
  • Erstellt für:
  • Beginner
    Intermediate
    Admin
    User
Version Artikel-Link
AEM 6.5 Hier klicken
AEM as a Cloud Service Dieser Artikel

data-integration

Mit der Experience Manager Forms-Datenintegration können Sie unterschiedliche Back-End-Datenquellen verwenden, um ein Formulardatenmodell zu erstellen, das Sie als Schema in verschiedenen Workflows für adaptive Formulare verwenden können. Dafür ist das Konfigurieren von Datenquellen und das Erstellen von Formulardatenmodellen erforderlich, basierend auf Datenmodellobjekten sowie Services, die in den Datenquellen verfügbar sind. Weitere Informationen finden Sie in den folgenden Themen:

Ein Formulardatenmodell ist eine Erweiterung des JSON-Schemas, die Sie verwenden können für:

Erstellen adaptiver Formulare und Fragmente

Sie können adaptive Formulare und adaptive Formularfragmente auf Grundlage eines Formulardatenmodells erstellen. Gehen Sie wie folgt vor, um ein Formulardatenmodell beim Erstellen eines adaptiven Formulars oder eines adaptiven Formularfragments zu verwenden:

  1. Wählen Sie auf der Registerkarte „Formularmodell“ im Bildschirm „Eigenschaften hinzufügen“ Formulardatenmodell aus der Dropdownliste Auswählen aus.

    Create-af-1-1

  2. Wählen Sie Formulardatenmodell auswählen, um es zu erweitern. Alle verfügbaren Formulardatenmodelle werden aufgelistet.

    Wählen Sie ein Formulardatenmodell aus.

    Create-af-2-1

  3. (Nur adaptive Formularfragmente) Sie können ein adaptives Formularfragment auf Grundlage eines einzelnen Datenmodellobjekts in einem Formulardatenmodell erstellen. Erweitern Sie die Dropdown-Liste mit den Definitionen für Formulardatenmodelle. Hier sind sämtliche Datenmodellobjekte im angegebenen Formulardatenmodell aufgelistet. Wählen Sie ein Datenmodellobjekt aus der Liste aus.

    create-af-3

    Sobald das auf einem Formulardatenmodell basierende adaptive Formular oder Formularfragment erstellt ist, werden Formulardatenmodellobjekte auf der Registerkarte Data Sources des Inhaltsbrowsers im Editor für adaptive Formulare angezeigt.

    HINWEIS

    Für adaptive Formularfragmente werden nur das beim Authoring gewählte Datenmodellobjekt und die mit diesem verknüpften Datenmodellobjekte auf der Registerkarte „Data Sources“ angezeigt.

    data-model-object-tab

    Indem Sie Datenmodellobjekte in das adaptive Formular oder Fragment ziehen und dort ablegen, können Sie Formularfelder hinzufügen. Die hinzugefügten Formularfelder behalten die Metadateneigenschaften und die Bindung mit den Datenmodellobjekteigenschaften bei. Durch die Bindung wird sichergestellt, dass die Feldwerte bei der Formularübermittlung in den entsprechenden Datenquellen aktualisiert und vorausgefüllt werden, wenn das Formular gerendert wird.

Vorschau mit Beispieldaten

Mit dem Formulardatenmodelleditor können Sie Beispieldaten für Datenmodellobjekte im Formulardatenmodell generieren und bearbeiten. Sie können diese Daten zur Vorschau und zum Testen adaptiver -Formulare verwenden. Sie müssen die Beispieldaten vor der Vorschau generieren, wie beschrieben unter Arbeiten mit einem Formulardatenmodell.

Um ein adaptives Formular mit Beispieldaten in der Vorschau anzuzeigen, öffnen Sie das Formular im Autorenmodus und wählen Sie Vorschau.

Vorbefüllen mit dem Formulardatenmodell-Service

Experience Manager Forms bietet einen standardmäßigen Vorbefüllungs-Service für Formulardatenmodelle, den Sie für adaptive Formulare auf Grundlage eines Formulardatenmodells aktivieren können. Der Vorbefüllungs-Service fragt Datenquellen nach Datenmodellobjekten im adaptiven Formular ab und befüllt dementsprechend Daten, während das Formular oder die Kommunikation gerendert wird.

Um den Vorbefüllungs-Service für ein adaptives Formular zu aktivieren, öffnen Sie die Eigenschaften des Containers für ein adaptives Formular und wählen Sie Vorbefüllungs-Service für Formulardatenmodell aus der Dropdown-Liste Vorbefüllungs-Service im Akkordeon „Standard“ aus. Speichern Sie anschließend die Eigenschaften.

prefill-service

Schreiben von übermittelten adaptiven Formulardaten in Datenquellen

Sie können ein auf einem Formulardatenmodell basierendes Formular so konfigurieren, dass die vom Benutzer im Formular übermittelten Daten für ein Datenmodellobjekt bei der Übermittlung in dessen Datenquellen geschrieben werden. Zu diesem Zweck stellen Experience Manager Forms die Übermittlungsaktion für Formulardatenmodelle zur Verfügung. Standardmäßig ist diese nur für adaptive Formulare verfügbar, die auf einem Formulardatenmodell basieren. Durch diese Aktion werden übermittelte Daten für ein Datenmodellobjekt in dessen Datenquelle geschrieben.

So konfigurieren Sie die Übermittlungsaktion für das Formulardatenmodell:

  1. Öffnen Sie den Inhalts-Browser und wählen Sie die Guide-Container-Komponente Ihres adaptiven Formulars aus.

  2. Klicken Sie auf das Symbol für die Guide-Container-Eigenschaften Guide-Eigenschaften. Das Dialogfeld „Container für ein adaptives Formular“ wird geöffnet.

  3. Klicken Sie auf die Registerkarte Übermittlung.

  4. Wählen Sie aus der Dropdown-Liste Übermittlungsaktion die Option Mit Formulardatenmodell absenden.

    Aktionskonfiguration

  5. Geben Sie das Datenmodell an, das übermittelt werden soll.

  6. Klicken Sie auf Fertig.

Beim Senden des Formulars werden die Daten für das konfigurierte Datenmodellobjekt in die entsprechende Datenquelle geschrieben. Darüber hinaus können Sie einen Formularanhang mit einem Formulardatenmodell und einem Datensatzdokument (Document of Record) an die Datenquelle senden. Weitere Informationen zum Formulardatenmodell finden Sie unter AEM Forms Datenintegration.

HINWEIS

AEM as a Cloud Service bietet verschiedene vordefinierte Übermittlungsaktionen für die Verarbeitung von Formularübermittlungen. Weitere Informationen zu diesen Optionen finden Sie im Artikel Übermittlungsaktion für adaptive Formulare.

Sie können auch Formularanhänge mit der Objekteigenschaft des binären Datenmodells an eine Datenquelle senden. Führen Sie folgende Schritte aus, um Anlagen an eine JDBC-Datenquelle zu senden:

  1. Fügen Sie dem Formulardatenmodell ein Datenmodellobjekt hinzu, das eine binäre Eigenschaft enthält.

  2. Ziehen Sie im adaptiven Formular die Komponente Dateianhang aus dem Komponentenbrowser auf das adaptive Formular.

  3. Wählen Sie die hinzugefügte Komponente und wählen Sie dann settings_icon, um den Eigenschaften-Browser für die Komponente zu öffnen.

  4. Wählen Sie im Feld „Bindungsverweis“ die Option foldersearch_18, navigieren Sie zur binären Eigenschaft, die Sie im Formulardatenmodell hinzugefügt haben, und wählen Sie sie aus. Konfigurieren Sie weitere Eigenschaften entsprechend.

    Wählen Sie check-button, um die Eigenschaften zu speichern. Das Anlagenfeld ist jetzt an die binäre Eigenschaft des Formulardatenmodells gebunden.

  5. Aktivieren Sie im Übermittlungsabschnitt der Eigenschaften des Containers für adaptive Formulare die Option Formularanhänge einreichen. Dies sendet den Anhang im Feld der binären Eigenschaft bei der Formularübermittlung an die Datenquelle.

Aufrufen von Services in adaptiven Formularen mithilfe von Regeln

In einem auf einem Formulardatenmodell basierenden adaptiven Formular können Sie Regeln erstellen, um die im Formulardatenmodell konfigurierten Services aufzurufen. Der Vorgang Services aufrufen listet alle verfügbaren Services im Formulardatenmodell auf, und Sie können die Ein- und Ausgabefelder für den Service auswählen. Sie können mit dem Regeltyp Wert festlegen außerdem einen Formulardatenmodell-Service aufrufen und die vom Service zurückgegebene Ausgabe als Wert eines Feldes einstellen.

Beispielsweise ruft folgende Regel einen Get-Service auf, für den die Mitarbeiter-ID als Eingabe angegeben werden muss und der die entsprechenden Werte in den Feldern für die Angehörigen-ID, den Nachnamen, den Vornamen und das Geschlecht zurückgibt.

invoke-service

Darüber hinaus können Sie mithilfe der guidelib.dataIntegrationUtils.executeOperation-API ein JavaScript im Codeeditor für den Regeleditor schreiben.

Aufrufen eines Formulardatenmodells mit benutzerdefinierten Funktionen

Sie können ein Formulardatenmodell aus dem Regeleditor mithilfe benutzerdefinierter Funktionen aufrufen. Um das Formulardatenmodell aufzurufen, fügen Sie der Zulassungsliste ein Formulardatenmodell hinzu. So fügen Sie ein Formulardatenmodell zu einer Zulassungsliste hinzu:

  1. Navigieren Sie zur Experience Manager-Web-Konsole unter https://server:host/system/console/configMgr.
  2. Suchen Sie das Whitelisting des Formulardatenmodells für den Dienstaufruf auf adaptiver Formularebene – Konfigurations-Factory.
  3. Klicken Sie auf das Plus-Symbol, um die Konfiguration hinzuzufügen.
  4. Fügen Sie ein Inhaltspfadmuster hinzu, um den Speicherort Ihrer adaptiven Formulare anzugeben. Standardmäßig lautet der Wert /content/forms/af/(.*), was alle adaptiven Formulare umfasst. Sie können auch den Pfad für ein bestimmtes adaptives Formular angeben.
  5. Fügen Sie ein Pfadmuster des Formulardatenmodells hinzu, um den Speicherort des Formulardatenmodells anzugeben. Standardmäßig lautet der Wert /content/dams/formsanddocuments-fdm/(.*), was alle Formulardatenmodelle umfasst. Sie können auch den Pfad für ein bestimmtes Formulardatenmodell angeben.
  6. Speichern Sie die Einstellungen.

Die hinzugefügte Konfiguration wird unter der Option Whitelisting des Formulardatenmodells für den Dienstaufruf auf adaptiver Formularebene – Konfigurations-Factory gespeichert.

HINWEIS

So rufen Sie ein Formulardatenmodell durch ein AEM -Archetyp-Projekt über den Regeleditor mit benutzerdefinierten Funktionen auf:

  1. Eine Konfigurationsdatei erstellen.
  2. Legen Sie Eigenschaften von getContentPathPattern und getFormDataModelPathPattern fest.
  3. Stellen Sie das Projekt bereit.

Ähnliche Artikel

Auf dieser Seite