Verwenden eines Formulardatenmodells (FDM) use-form-data-model

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 Backend-Datenquellen verwenden, um ein Formulardatenmodell (FDM) 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 (FDM) erforderlich, basierend auf Datenmodellobjekten sowie Diensten, die in den 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 adaptive Formulare und adaptive Formularfragmente auf Grundlage eines Formulardatenmodells (FDM) erstellen. Gehen Sie wie folgt vor, um ein Formulardatenmodell (FDM) 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 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 auf Grundlage eines einzelnen Datenmodellobjekts in einem Formulardatenmodell (FDM) erstellen. Erweitern Sie die Dropdown-Liste mit den Definitionen für Formulardatenmodelle. Hier sind sämtliche Datenmodellobjekte im angegebenen Formulardatenmodell (FDM) aufgelistet. Wählen Sie ein Datenmodellobjekt aus der Liste aus.

    create-af-3

    Sobald das auf einem Formulardatenmodell (FDM) basierende adaptive Formular oder Formularfragment erstellt ist, werden Formulardatenmodellobjekte auf der Registerkarte Datenquellen des Inhalts-Browsers im Editor für adaptive Formulare angezeigt.

    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 Formulardatenmodelleditor 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 vorkonfigurierten Vorbefüllungsdienst für Formulardatenmodelle, den Sie für adaptive Formulare auf Grundlage eines Formulardatenmodells (FDM) 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 write-af

Wenn Benutzende ein auf einem Formulardatenmodell (FDM) basierendes Formular übermitteln, können Sie das Formular so konfigurieren, dass die für ein Datenmodellobjekt übermittelten Daten in die zugehörigen Datenquellen geschrieben werden. Zu diesem Zweck stellt 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 (FDM) 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 (FDM) und einem Datensatzdokument (Document of Record, 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 per Drag-and-Drop aus dem Komponenten-Browser 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 aus, navigieren Sie zur binären Eigenschaft, die Sie im Formulardatenmodell (FDM) hinzugefügt haben, und wählen Sie sie aus. 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 auf einem Formulardatenmodell (FDM) basierenden adaptiven Formular können Sie Regeln erstellen, um die im Formulardatenmodell (FDM) konfigurierten Dienste aufzurufen. Der Vorgang Dienste aufrufen listet alle verfügbaren Dienste im Formulardatenmodell (FDM) auf, und Sie können die Ein- und Ausgabefelder für den Dienst 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 (FDM) mit benutzerdefinierten 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 ein Formulardatenmodell zur Zulassungsliste 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 (FDM) anzugeben. Standardmäßig lautet der Wert /content/dams/formsanddocuments-fdm/(.*), was alle Formulardatenmodelle (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) 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

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