Formulardatenmodell (FDM) verwenden use-form-data-model

Version
Artikel-Link
AEM 6.5
Hier klicken
AEM as a Cloud Service
Dieser Artikel

data-integration

Experience Manager Forms Mit der Datenintegration können Sie unterschiedliche Backend-Datenquellen verwenden, um ein Formulardatenmodell (FDM) zu erstellen, das Sie als Schema in verschiedenen adaptiven Forms verwenden können. Workflows. Dazu müssen Datenquellen konfiguriert und Formulardatenmodell (FDM) basierend auf Datenmodellobjekten und Diensten erstellt werden, die in Datenquellen verfügbar sind. Weitere Informationen finden Sie in den folgenden Themen:

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

Erstellen adaptiver Formulare und Fragmente create-af

Sie können Adaptives Forms und adaptive Formularfragmente basierend auf einem Formulardatenmodell (FDM). Gehen Sie wie folgt vor, um ein Formulardatenmodell (FDM) beim Erstellen eines adaptiven Formulars oder 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 zum Erweitern Formulardatenmodell auswählen aus. Alle verfügbaren Formulardatenmodelle (FDM) werden aufgelistet.

    Wählen Sie ein Formulardatenmodell aus.

    Create-af-2-1

  3. (Nur adaptive Formularfragmente) Sie können ein adaptives Formularfragment erstellen, das auf nur einem Datenmodellobjekt in einem Formulardatenmodell (FDM) basiert. Erweitern Sie die Dropdown-Liste mit den Definitionen für Formulardatenmodelle. Es listet alle Datenmodellobjekte im angegebenen Formulardatenmodell (FDM) auf. Wählen Sie ein Datenmodellobjekt aus der Liste aus.

    create-af-3

    Nachdem das auf einem Formulardatenmodell (FDM) basierende adaptive Formular- oder Formularfragment erstellt wurde, werden Formulardatenmodellobjekte in der Variablen Data Sources Registerkarte des Inhalts-Browsers im Editor für adaptive Formulare.

    note note
    NOTE
    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 preview-ic

Mit dem Formulardatenmodell-Editor können Sie Beispieldaten für Datenmodellobjekte im Formulardatenmodell (FDM) 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 prefill

Experience Manager Forms bietet einen vordefinierten Vorbefüllungs-Dienst für Formulardatenmodelle, den Sie für die adaptive Forms aktivieren können basierend auf dem Formulardatenmodell (FDM). 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 write-af

Wenn ein Benutzer ein Formular sendet, das auf einem Formulardatenmodell (FDM) basiert, können Sie das Formular so konfigurieren, dass gesendete Daten für ein Datenmodellobjekt in dessen Datenquellen geschrieben werden. Um diesen Anwendungsfall zu erreichen, Experience Manager Forms bereitstellen Übermittlungsaktion für Formulardatenmodell, die standardmäßig nur für adaptive Forms auf der Basis eines Formulardatenmodells (FDM) verfügbar sind. 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 (FDM) und einem Datensatzdokument (DoR) an die Datenquelle senden. Weitere Informationen zum Formulardatenmodell (FDM) finden Sie unter AEM Forms Datenintegration.

NOTE
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 (FDM) 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 und navigieren Sie zu der binären Eigenschaft, die Sie im Formulardatenmodell (FDM) hinzugefügt haben. Konfigurieren Sie weitere Eigenschaften entsprechend.

    Wählen Sie check-button aus, um die Eigenschaften zu speichern. Das Anlagenfeld ist jetzt an die binäre Eigenschaft des Formulardatenmodells (FDM) 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 invoke-services

In einem adaptiven Formular, das auf einem Formulardatenmodell (FDM) basiert, können Sie Regeln erstellen zum Aufrufen von Diensten, die im Formulardatenmodell (FDM) konfiguriert sind. Die Dienste aufrufen -Vorgang in einer Regel listet alle verfügbaren Dienste im Formulardatenmodell (FDM) auf und ermöglicht es Ihnen, Eingabe- und Ausgabefelder für den Dienst auszuwä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 (FDM) mithilfe benutzerdefinierter Funktionen invoke-form-data-model-using-custom-functions

Sie können ein Formulardatenmodell aus dem Regeleditor mithilfe benutzerdefinierter Funktionen aufrufen. Um das Formulardatenmodell (FDM) 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. Hinzufügen Pfadmuster des Formulardatenmodells um den Speicherort des Formulardatenmodells (FDM) anzugeben. Standardmäßig lautet der Wert /content/dams/formsanddocuments-fdm/(.*) , das das gesamte Formulardatenmodell (FDM) umfasst. Sie können auch den Pfad für ein bestimmtes Formulardatenmodell (FDM) 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.

NOTE
So rufen Sie ein Formulardatenmodell (FDM) über ein AEM Archetypprojekt über benutzerdefinierte Funktionen im Regeleditor auf:
  1. Eine Konfigurationsdatei erstellen.
  2. Legen Sie Eigenschaften von getContentPathPattern und getFormDataModelPathPattern fest.
  3. Stellen Sie das Projekt bereit.

Ähnliche Artikel

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab