Verwenden eines Formulardatenmodells use-form-data-model
Mit der AEM Forms-Datenintegration können Sie unterschiedliche Backend-Datenquellen verwenden, um ein Formulardatenmodell zu erstellen, das Sie als Schema in verschiedenen adaptiven Formularen und interaktiven Kommunikationsarbeitsabläufen verwenden können. Dazu müssen Sie Datenquellen konfigurieren und ein Formulardatenmodell basierend auf Datenmodellobjekten und Diensten erstellen, die in Datenquellen verfügbar sind. Weitere Informationen finden Sie in den folgenden Themen:
Ein Formulardatenmodell ist eine Erweiterung des JSON-Schemas, die Sie wie folgt verwenden können:
- Adaptive Formulare und Fragmente erstellen
- Interaktive Kommunikation und Bausteine wie Text, Liste und Bedingungsfragmente erstellen
- Vorschau für interaktive Kommunikation mit Beispieldaten
- Adaptive Formulare und interaktive Kommunikation ausfüllen
- Gesendete adaptive Formulardaten zurück in Datenquellen schreiben
- Dienste über Regeln für adaptive Formulare aufrufen
Erstellen adaptiver Formulare und Fragmente create-af
Sie können adaptive Formulare und adaptive Formularfragmente basierend auf einem Formulardatenmodell. Gehen Sie wie folgt vor, um beim Erstellen eines adaptiven Formulars oder adaptiven Formularfragments ein Formulardatenmodell zu verwenden:
-
Wählen Sie auf der Registerkarte „Formularmodell“ im Bildschirm „Eigenschaften hinzufügen“ Formulardatenmodell aus der Dropdown-Liste Auswählen.
-
Tippen Sie auf Formulardatenmodell auswählen, um es zu erweitern. Alle verfügbaren Formulardatenmodelle werden aufgelistet.
Wählen Sie ein Formulardatenmodell aus.
-
(Nur adaptive Formularfragmente) Sie können ein adaptives Formularfragment erstellen, das auf nur einem Datenmodellobjekt in einem Formulardatenmodell basiert. Erweitern Definitionen des Formulardatenmodells Dropdown-Liste. Es listet alle Datenmodellobjekte im angegebenen Formulardatenmodell auf. Wählen Sie ein Datenmodellobjekt aus der Liste aus.
Sobald das auf einem Formulardatenmodell basierende adaptive Formular oder Formularfragment erstellt ist, werden Formulardatenobjekte auf der Registerkarte Datenmodellobjekte des Inhaltsbrowsers im Editor für adaptive Formulare 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 bei und binden mit den Datenmodellobjekteigenschaften. Durch die Bindung wird sichergestellt, dass die Feldwerte bei der Formularübermittlung in den entsprechenden Datenquellen aktualisiert und vorausgefüllt werden, wenn das Formular wiedergegeben wird.
Interaktive Kommunikation erstellen create-ic
Sie können eine interaktive Kommunikation basierend auf einem Formulardatenmodell erstellen, mit dem Sie die interaktive Kommunikation mit Daten aus konfigurierten Datenquellen vorbefüllen können. Darüber hinaus können die Bausteine einer interaktiven Kommunikation wie Text-, Listen- und Bedingungsdokumentfragmente auf einem Formulardatenmodell basieren.
Sie können beim Erstellen einer interaktiven Kommunikation oder eines Dokumentfragments ein Formulardatenmodell auswählen. Die folgende Abbildung zeigt die Registerkarte Allgemein des Dialogfelds Interaktive Kommunikation erstellen .
Registerkarte "Allgemein"im Dialogfeld "Interaktive Kommunikation erstellen"
Weitere Informationen finden Sie unter:
Interaktive Kommunikation erstellen
Text in interaktiven Kommunikationen
Bedingungen in interaktiven Kommunikationen
Vorschau mit Beispieldaten preview-ic
Mit dem Formulardatenmodell-Editor können Sie Beispieldaten für Datenmodellobjekte im Formulardatenmodell generieren und bearbeiten. Sie können diese Daten verwenden, um interaktive Kommunikation und adaptive Formulare in der Vorschau anzuzeigen und zu testen. Sie müssen die Beispieldaten vor der Vorschau generieren, wie beschrieben unter Arbeiten mit einem Formulardatenmodell.
So zeigen Sie eine Vorschau einer interaktiven Kommunikation mit Musterformulardaten an:
- Navigieren Sie auf dem AEM-Server zu Formulare > Formulare und Dokumente.
- Wählen Sie eine interaktive Kommunikation und tippen Sie auf Vorschau in der Symbolleiste, um Webkanal, Druckkanal oder Beide Kanäle auszuwählen und eine Vorschau der interaktiven Kommunikation anzuzeigen.
- Stellen Sie im Vorschau-Dialogfeld [Kanal] sicher, dass Testdaten des Formulardatenmodells ausgewählt ist, und tippen Sie auf Vorschau.
Die interaktive Kommunikation öffnet sich mit vorbefüllten Beispieldaten.
Um ein adaptives Formular mit Beispieldaten in der Vorschau anzuzeigen, öffnen Sie das adaptive Formular im Autorenmodus und tippen Sie auf Vorschau.
Vorbefüllen mit dem Formulardatenmodelldienst prefill
AEM Forms bietet einen vordefinierten Vorbefüllungs-Dienst für Formulardatenmodelle, den Sie für adaptive Formulare und interaktive Kommunikation basierend auf dem Formulardatenmodell aktivieren können. Der Vorbefüllungs-Dienst fragt Datenquellen für Datenmodellobjekte im adaptiven Formular und in der interaktiven Kommunikation ab und füllt dementsprechend beim Rendern des Formulars oder der Kommunikation Daten vorab.
Um den Vorbefüllungs-Dienst für Formulardatenmodell für ein adaptives Formular zu aktivieren, öffnen Sie die Eigenschaften des Containers für adaptive Formulare und wählen Sie Vorfüllservice für Formulardatenmodell von Vorbefüllungs-Dienst im Akkordeon Allgemein angezeigt. Speichern Sie anschließend die Eigenschaften.
Um den Vorbefüllungs-Dienst für Formulardatenmodelle in einer interaktiven Kommunikation zu konfigurieren, können Sie im Dropdown-Liste für den Vorbefüllungs-Dienst den Vorbefüllungs-Dienst für Formulardatenmodelle während der Erstellung auswählen, oder später, indem Sie die Eigenschaften ändern.
Dialogfeld "Eigenschaften bearbeiten"für eine interaktive Kommunikation
Gesendete adaptive Formulardaten in Datenquellen schreiben write-af
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. Um diesen Anwendungsfall zu erreichen, stellt AEM Forms Übermittlungsaktion für Formulardatenmodell, ist standardmäßig 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 Adaptive Form-Container-Eigenschaften und wählen Sie Übermitteln mit dem Formulardatenmodell aus dem Dropdown-Menü „Übermittlungsaktion“ unter dem Akkordeon „Übermittlung“. Suchen Sie dann ein Datenmodellobjekt und wählen Sie es aus dem Name des zu sendenden Datenmodellobjekts Dropdown-Liste. Speichern Sie die Eigenschaften.
Beim Senden des Formulars werden die Daten für das konfigurierte Datenmodellobjekt in die entsprechende Datenquelle geschrieben.
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 ein Datenmodellobjekt hinzu, das eine binäre Eigenschaft enthält.
-
Ziehen Sie im adaptiven Formular die Komponente Dateianhang aus dem Komponentenbrowser in das adaptive Formular und legen Sie sie dort ab.
-
Tippen Sie auf die hinzugefügte Komponente, um sie auszuwählen, und tippen Sie dann auf
-
Tippen Sie im Feld „Bindungsverweis“ auf
Tippen Sie auf
-
Aktivieren Sie im Abschnitt Übermittlung der Eigenschaften des Containers für adaptive Formulare die Option Übermitteln von Formularanlagen. Er sendet den Anhang im Feld der binären Eigenschaft bei der Formularübermittlung an die Datenquelle.
Dienste in adaptiven Formularen mithilfe von Regeln aufrufen invoke-services
In einem auf einem Formulardatenmodell basierenden adaptiven Formular können Sie Regeln erstellen, um die im Formulardatenmodell konfigurierten Dienste aufzurufen. Für die Operation Dienste aufrufen werden alle verfügbaren Dienste im Formulardatenmodell aufgelistet und Sie können die Eingabe- und Ausgabefelder für den Dienst wählen. Sie können auch die Wert einstellen Regeltyp zum Aufrufen eines Formulardatenmodelldienstes und zum Festlegen des Werts eines Felds auf die vom Dienst zurückgegebene Ausgabe.
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. Informationen zur API finden Sie unter API zum Aufrufen des Formulardatenmodelldienstes.