Verwenden von Formulardatenmodellen

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. Tippen Sie auf 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 Dropdownliste Definitionen für Formulardatenmodell. 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. Für die hinzugefügten Formularfelder bleiben die Metadateneigenschaften und die Bindung der Datenmodellobjekteigenschaften erhalten. Die Bindung stellt sicher, dass die Feldwerte in den entsprechenden Datenquellen bei der Formularübermittlung aktualisiert und bei der Ausgabe des Formulars vorausgefüllt werden.

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 tippen Sie auf 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.

Um die Übermittlungsaktion für Formulardatenmodelle zu konfigurieren, öffnen Sie die Eigenschaften des Container für das adaptive Formular und wählen Sie Mit Formulardatenmodell übermitteln aus der Dropdownliste „Übermittlungsaktion“ im Akkordeon „Übermittlung“ aus. Suchen Sie dann das gewünschte Datenmodellobjekt in der Dropdownliste Name des zu übermittelnden Modellobjekts und wählen Sie es aus. Speichern Sie die Eigenschaften.

Bei Übermitteln des Formulars werden die Daten für das konfigurierte Datenmodellobjekt in die entsprechende Datenquelle geschrieben.

Mithilfe der Objekteigenschaft „Binärdatenmodell“ können Sie auch Formularanhänge an eine Datenquelle senden. Gehen Sie wie folgt vor, um Anhänge 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. Tippen Sie auf die hinzugefügte Komponente, um sie auszuwählen, und tippen Sie dann auf settings_icon, um den Eigenschaftenbrowser für die Komponente zu öffnen.

  4. Tippen Sie im Feld „Bindungsverweis“ auf 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.

    Tippen Sie auf check-button, um die Eigenschaften zu speichern. Damit ist das Anhangsfeld an die binäre Eigenschaft des Formulardatenmodells gebunden.

  5. Aktivieren Sie im Abschnitt „Übermittlung“ der Eigenschaften des Containers für das adaptive Formular die Option Formularanhänge einreichen. Dadurch wird der Anhang im Feld der binären Eigenschaft bei der Sendung des Formulars an die Datenquelle gesendet.

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. Für den Vorgang Services aufrufen werden alle verfügbaren Services im Formulardatenmodell aufgelistet 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.

Auf dieser Seite