Verwenden eines Formulardatenmodells (FDM) use-form-data-model
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:
-
Wählen Sie auf der Registerkarte „Formularmodell“ im Bildschirm „Eigenschaften hinzufügen“ Formulardatenmodell aus der Dropdownliste Auswählen aus.
-
Wählen Sie zum Erweitern Formulardatenmodell auswählen aus. Alle verfügbaren Formulardatenmodelle (FDM) werden aufgelistet.
Wählen Sie ein Formulardatenmodell aus.
-
(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.
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. 
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.
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:
-
Öffnen Sie den Inhalts-Browser und wählen Sie die Guide-Container-Komponente Ihres adaptiven Formulars aus.
-
Klicken Sie auf das Symbol für die Guide-Container-Eigenschaften
-
Klicken Sie auf die Registerkarte Übermittlung.
-
Wählen Sie aus der Dropdown-Liste Übermittlungsaktion die Option Mit Formulardatenmodell absenden.
-
Geben Sie das Datenmodell an, das übermittelt werden soll.
-
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.
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:
-
Fügen Sie dem Formulardatenmodell (FDM) ein Datenmodellobjekt hinzu, das eine binäre Eigenschaft enthält.
-
Ziehen Sie im adaptiven Formular die Komponente Dateianhang per Drag-and-Drop aus dem Komponenten-Browser auf das adaptive Formular.
-
Wählen Sie die hinzugefügte Komponente und wählen Sie dann
-
Wählen Sie im Feld „Bindungsverweis“ die Option
Wählen Sie
-
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.
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:
- Navigieren Sie zur Experience Manager-Web-Konsole unter
https://server:host/system/console/configMgr. - Suchen Sie das Whitelisting des Formulardatenmodells für den Dienstaufruf auf adaptiver Formularebene – Konfigurations-Factory.
- Klicken Sie auf das
- 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. - 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. - 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.
- Eine Konfigurationsdatei erstellen.
- Legen Sie Eigenschaften von getContentPathPattern und getFormDataModelPathPattern fest.
- Stellen Sie das Projekt bereit.
Ähnliche Artikel
- E-Mail senden
- An SharePoint senden
- Mit Formulardatenmodell senden
- An Azure Blob Storage senden
- An REST-Endpunkt senden
- An OneDrive senden
- AEM-Workflow aufrufen
- An Power Automate senden
- An Workfront Fusion senden
- Verbinden eines adaptiven Formulars mit einer Salesforce-Anwendung
- Verbinden eines adaptiven Formulars mit Microsoft