[AEM Forms]{class="badge positive" title="Gilt für AEM Forms)."}
Erstellen eines Formulardatenmodells (FDM) create-form-data-model
Ein Formulardatenmodell (FDM) in Experience Manager Forms definiert, wie Daten zwischen Formularen und Back-End-Systemen strukturiert und ausgetauscht werden. Die Experience Manager Forms-Datenintegration bietet eine intuitive Benutzeroberfläche zum Erstellen von und Arbeiten mit Formulardatenmodellen. Ein Formulardatenmodell (FDM) stützt sich für den Austausch von Daten auf Datenquellen. Sie können jedoch ein Formulardatenmodell (FDM) (oder ohne Datenquelle). Mit dieser Flexibilität können Sie mit dem Entwerfen und Testen von Formularen beginnen, noch bevor die Backend-Konnektivität verfügbar ist, und dann Datenquellen später binden, ohne das Modell neu zu erstellen.
Je nachdem, ob Sie Datenquellen konfiguriert haben, gibt es zwei Möglichkeiten, ein Formulardatenmodell (FDM) zu erstellen:
-
Vorkonfigurierte Datenquellen verwenden: Wenn Sie Datenquellen wie in Konfigurieren von Datenquellen konfiguriert haben, können Sie diese beim Erstellen eines Formulardatenmodells (FDM) auswählen. Durch Auswahl konfigurierter Datenquellen werden alle Datenmodellobjekte, Eigenschaften und Services aus den ausgewählten Datenquellen verfügbar, damit sie im Formulardatenmodell (FDM) verwendet werden können. Dieser Ansatz eignet sich optimal, wenn Ihre Integrationsendpunkte bereits eingerichtet sind und Sie möchten, dass das FDM Live-Schema, Vorgänge und Services aus diesen Systemen widerspiegelt.
-
Ohne Datenquellen: Wenn Sie keine Datenquellen für Ihr Formulardatenmodell (FDM) konfiguriert haben, können Sie das Formulardatenmodell (FDM) weiterhin ohne Datenquellen erstellen. Sie können das Formulardatenmodell (FDM) verwenden, um adaptive Forms zu erstellen und sie mithilfe von Beispieldaten zu testen. Wenn Datenquellen verfügbar werden, können Sie das Formulardatenmodell (FDM) an Datenquellen binden. Diese Bindung wird automatisch an den zugehörigen adaptiven Forms weitergegeben. So funktionieren Formulare, die auf Beispieldaten basieren, weiterhin, sobald eine echte Back-End-Konnektivität hinzugefügt wird.
Erstellen eines Formulardatenmodells (FDM) data-sources
Stellen Sie vor dem Erstellen eines Formulardatenmodells (FDM) sicher, dass Sie die Datenquellen konfiguriert haben, die Sie im Formulardatenmodell (FDM) verwenden möchten, wie in Konfigurieren von Datenquellen beschrieben. Ein Formulardatenmodell (FDM) bietet eine einheitliche Ebene, die Adobe Experience Manager Forms mit einer oder mehreren konfigurierten Datenquellen verbindet, sodass Sie Formularfelder an Backend-Daten binden und Datenquellendienste aufrufen können. Gehen Sie folgendermaßen vor, um ein Formulardatenmodell (FDM) basierend auf konfigurierten Datenquellen zu erstellen:
-
Navigieren Sie in der Experience Manager-Autoreninstanz zu Forms > Datenintegrationen.
-
Wählen Sie Erstellen > Formulardatenmodell.
-
Im Dialogfeld „Formulardatenmodell erstellen“:
- Geben Sie einen Namen für das Formulardatenmodell (FDM) an.
- (Optional) Geben Sie einen Titel, eine Beschreibung und Tags für das Formulardatenmodell (FDM) an.
- (Optional und nur anwendbar, wenn Datenquellen konfiguriert sind) Wählen Sie das Häkchensymbol neben dem Feld Datenquellenkonfiguration und dann den Konfigurationsknoten, in dem sich die Cloud Services für die Datenquellen befinden, die Sie verwenden möchten. Daher ist die Liste der Datenquellen, die auf der nächsten Seite ausgewählt werden können, auf die Datenquellen beschränkt, die im ausgewählten Konfigurationsknoten verfügbar sind. Experience Manager-Benutzerprofildatenquellen werden jedoch standardmäßig aufgelistet. Wenn Sie keinen Konfigurationsknoten auswählen, werden Datenquellen von allen Konfigurationsknoten angezeigt.
-
Wählen Sie Weiter aus.
-
(Nur anwendbar, wenn Datenquellen konfiguriert sind) Der Bildschirm Datenquelle auswählen listet die verfügbaren Datenquellen auf. Wählen Sie die Datenquellen aus, die Sie im Formulardatenmodell verwenden möchten.
-
Wählen Erstellen und klicken Sie im Bestätigungsdialogfeld auf Öffnen, um den Formulardatenmodell-Editor zu öffnen.
Die Benutzeroberfläche des Formulardatenmodell-Editors enthält die folgenden Komponenten:
A. Datenquellen Listet die Datenquellen in einem Formulardatenmodell auf. Erweitern Sie eine Datenquelle, um ihre Datenmodellobjekte und Services anzuzeigen.
B. Datenquellendefinitionen aktualisieren Ruft alle Änderungen in den Datenquellendefinitionen aus den konfigurierten Datenquellen ab und aktualisiert sie in der Registerkarte „Datenquellen“ des Formulardatenmodelleditors. Dadurch wird sichergestellt, dass das Modell den aktuellen Status verbundener Datenquellen widerspiegelt.
C. Modell: Inhaltsbereich, in dem hinzugefügte Datenmodellobjekte erscheinen.
D. Dienste: Inhaltsbereich, in dem hinzugefügte Datenquellenvorgänge oder -Services angezeigt werden.
E. Symbolleiste Tools zum Arbeiten mit dem Formulardatenmodell (FDM). In der Symbolleiste werden je nach ausgewähltem Objekt im Formulardatenmodell (FDM) weitere Optionen angezeigt.
F. Ausgewählte hinzufügen Fügt die ausgewählten Datenmodellobjekte und Services zum Formulardatenmodell hinzu.
Weitere Informationen zum Formulardatenmodell-Editor und dazu, wie Sie damit ein Formulardatenmodell (FDM) bearbeiten und konfigurieren können, finden Sie unter Arbeiten mit einem Formulardatenmodell.
Aktualisieren von Datenquellen update
Führen Sie diese Schritte aus, um Datenquellen in einem vorhandenen Formulardatenmodell (FDM) in Adobe Experience Manager Forms hinzuzufügen, oder zu löschen. Durch die Beibehaltung der Datenquellen auf dem neuesten Stand wird sichergestellt, dass adaptive Forms, die auf dem Modell basieren, weiterhin aus den richtigen Systemen lesen und in diese schreiben.
-
Wechseln Sie zu Forms > Datenintegrationen, wählen Sie das Formulardatenmodell (FDM) in dem Sie Datenquellen hinzufügen oder aktualisieren möchten, und wählen Sie Eigenschaften.
-
Wechseln Sie in den Eigenschaften des Formulardatenmodells zur Registerkarte Quelle aktualisieren.
Auf der Registerkarte Source aktualisieren können Sie einen Konfigurationskontext auswählen und dann Datenquellen hinzufügen, ersetzen oder löschen:
-
Konfigurationskontext auswählen: Wählen Sie das Symbol „Durchsuchen“ im Feld Kontextabhängige Konfiguration und wählen Sie einen Konfigurationsknoten aus, in dem sich die Cloud-Konfiguration für die hinzuzufügende Datenquelle befindet. Dadurch wird bestimmt, welche Cloud-Konfigurationen sichtbar sind. Wenn Sie keinen Knoten auswählen, werden nur Cloud-Konfigurationen im Knoten
globalaufgelistet, wenn Sie Quellen hinzufügen auswählen. -
Neue Datenquelle hinzufügen: Wählen Sie Quellen hinzufügen und wählen Sie die Datenquellen aus, die dem Formulardatenmodell () hinzugefügt werden sollen. Alle Datenquellen, die in
globalund im ausgewählten Konfigurationsknoten konfiguriert sind, werden angezeigt (sofern vorhanden). Dadurch werden die ausgewählten Datenquellen hinzugefügt, damit ihre Datenmodellobjekte für die Bindung im Modell verfügbar werden. -
Vorhandene Datenquelle ersetzen: Um eine vorhandene Datenquelle durch eine andere Datenquelle desselben Typs zu ersetzen, wählen Sie das Symbol Bearbeiten für die Datenquelle aus und wählen Sie sie aus der Liste der verfügbaren Datenquellen aus. Wenn Sie durch eine Quelle desselben Typs ersetzen, wird die vorhandene Datenmodellstruktur beibehalten, sodass abhängige Bindungen gültig bleiben.
-
Vorhandene Datenquelle löschen: Sie zum Löschen einer vorhandenen Datenquelle das Symbol Löschen für die Datenquelle aus. Das Symbol Löschen ist deaktiviert, da ein Datenmodellobjekt aus dieser Datenquelle bereits hinzugefügt und im Formulardatenmodell (FDM) verwendet wird wodurch noch referenzierte Abhängigkeiten nicht entfernt werden können.
-
-
Wählen Sie Speichern und schließen aus, um die Aktualisierungen zu speichern.
Kontextabhängige Konfigurationen für bestimmte Ausführungsmodi runmode-specific-context-aware-config
Formulardatenmodell (FDM) verwendet kontextabhängige Konfigurationen von Sling um verschiedene Datenquellenparameter bereitzustellen, wodurch Verbindungen zu Datenquellen ermöglicht werden, die in Experience Manager Ausführungsmodi variieren. Mit dieser Funktion kann eine einzelne Bereitstellung auf unterschiedliche Endpunkte abzielen, je nachdem, ob sie in Entwicklung, Staging oder Produktion ausgeführt wird.
Wenn Formulardatenmodell (FDM) Cloud-Konfigurationen zum Speichern von Parametern verwendet, erstellen Sie diese Parameter beim Einchecken und Bereitstellen über die Versionskontrolle (Cloud Manager GIT-Repository) eine einzelne Cloud-Konfiguration mit identischen Parametern für alle Ausführungsmodi (Entwicklung, Staging und). Wenn Sie für Ihren Anwendungsfall unterschiedliche Datensätze für Test- und Produktionsumgebungen benötigen, verwenden Sie Datenquellenparameter (z. B. eine Datenquellen-URL), die für jeden Experience Manager Ausführungsmodus spezifisch sind.
Erstellen Sie dazu eine OSGi-Konfiguration die Datenquellenparameter-Wert-Paare enthält. Dadurch wird sichergestellt, dass die OSGi-Werte Vorrang haben, und dasselbe Paar aus der Formulardatenmodell (FDM)Cloud-Konfiguration zur Laufzeit überschrieben wird. Da OSGi-Konfigurationen diese Ausführungsmodi standardmäßig unterstützen, können Sie einen Datenquellenparameter basierend auf dem Ausführungsmodus in einen anderen Wert überschreiben, sodass jede Umgebung auf ihren eigenen Endpunkt aufgelöst werden kann.
So aktivieren Sie bereitstellungsspezifische Cloud-Konfigurationen im Formulardatenmodell (FDM):
-
Erstellen Sie die Cloud-Konfiguration auf der lokalen Entwicklungsinstanz. Ausführliche Anweisungen finden Sie unter Konfigurieren von Datenquellen.
-
Speichern Sie Ihre Cloud-Konfiguration im Dateisystem.
- Erstellen Sie mithilfe des Filters
/conf/{foldername}/settings/cloudconfigs/fdmein Paket. Verwenden Sie denselben{foldername}wie in Schritt 1 und ersetzen Sie für die Azure Storage-Konfigurationfdmmitazurestorage. - Erstellen Sie das Paket und laden Sie es herunter. Weitere Informationen finden Sie unter Paketaktionen.
- Erstellen Sie mithilfe des Filters
-
Integrieren Sie die Cloud-Konfiguration in den Experience Manager-Projektarchetyp.
- Entpacken Sie das heruntergeladene Paket.
- Kopieren Sie den Ordner
jcr_rootund legen Sie ihn inui.content>src>main>contentab. - Aktualisieren Sie
ui.content>src>main>content>META-INF>vault>filter.xml, sodass der Filter/conf/{foldername}/settings/cloudconfigs/fdmenthalten ist. Weitere Informationen finden Sie unter ui.content-Modul des AEM-Projektarchetyps. Wenn dieser Projektarchetyp über die Cloud Manager-Pipeline (CM) bereitgestellt wird, wird dieselbe Cloud-Konfiguration in allen Umgebungen (oder Ausführungsmodi) installiert. Um den Wert von Feldern (wie URL) von Cloud-Konfigurationen basierend auf der Umgebung zu ändern, verwenden Sie die OSGi-Konfiguration, die im folgenden Schritt behandelt wird.
-
Erstellen Sie eine kontextabhängige Apache Sling-Konfiguration. So erstellen Sie die OSGi-Konfiguration:
-
Richten Sie die OSGi-Konfigurationsdateien im Experience Manager-Projektarchetypen ein.
Erstellen Sie OSGi-Werkskonfigurationsdateien mit PID-org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider. Erstellen Sie eine Datei mit demselben Namen unter jedem Ausführungsmodus-Ordner, in dem die Werte pro Ausführungsmodus geändert werden müssen. Dadurch wird sichergestellt, dass jeder Ausführungsmodus seine eigenen Überschreibungswerte anwendet. Weitere Informationen finden Sie unter Konfigurieren von OSGi für Adobe Experience Manager. -
Legen Sie die OSGi-Konfigurations-JSON fest. Konfigurieren Sie den kontextabhängigen Konfigurations-Überschreibungsanbieter von Apache Sling so, dass umgebungsspezifische Werte bei der Bereitstellung automatisch angewendet werden. So verwenden Sie den kontextabhängigen Konfigurations-Überschreibungsanbieter für Apache Sling:
- Wählen Sie auf der
/system/console/configMgrIhrer lokalen Entwicklungsinstanz die werkseitige OSGi-Konfiguration mit dem Namen Apache Sling Context-Aware Configuration Override Provider: OSGi-Konfiguration aus. - Geben Sie eine Beschreibung ein.
- Wählen Sie aktiviert aus.
- Geben Sie unter Überschreibungen die Felder an, die basierend auf der Umgebung in der Sling-Überschreibungssyntax geändert werden müssen. Weitere Informationen finden Sie unter Kontextabhängige Konfiguration von Apache Sling – Überschreiben. Beispiel:
cloudconfigs/fdm/{configName}/url="newURL".
Fügen Sie mehrere Überschreibungen hinzu, indem Sie + auswählen. - Klicken Sie auf Speichern.
- Um die JSON-Datei für die OSGi-Konfiguration abzurufen, führen Sie die Schritte unter Generieren von OSGi-Konfigurationen mithilfe des AEM SDK-Schnellstarts aus.
- Platzieren Sie die JSON-Datei in den OSGi-Werkskonfigurationsdateien, die im vorherigen Schritt erstellt wurden.
- Ändern Sie den Wert von
newURLin der Überschreibungskonfiguration auf den richtigen Zielwert für jede Umgebung (oder jeden Ausführungsmodus), sodass jede Umgebung in eine eigene URL aufgelöst wird. - Um einen geheimen Wert basierend auf dem Ausführungsmodus zu ändern, erstellen Sie eine geheime Variable mit der Cloud Manager (CM)- und verweisen Sie später in der OSGi-Konfiguration darauf.
Wenn dieser Projektarchetyp über die Cloud Manager (CM)-Pipeline bereitgestellt wird, liefert die Überschreibung verschiedene Werte für verschiedene Umgebungen (oder Ausführungsmodi). Daher wird eine einzelne Codebasis zur Laufzeit auf eine umgebungsspezifische Konfiguration aufgelöst. Dadurch wird sichergestellt, dass alle Entwicklungs-, Staging- und Produktionsinstanzen die richtigen URL- und geheimen Werte erhalten, ohne dass manueller Code geändert wird.
note NOTE Adobe Managed Service Benutzer können die geheimen Werte mithilfe der Kryptounterstützung verschlüsseln. Weitere Informationen finden Sie Verschlüsselungsunterstützung für Konfigurationseigenschaften und platzieren Sie den verschlüsselten Text in den Wert, nachdem kontextabhängige Konfigurationen in Service Pack 6.5.13.0 verfügbar sind. - Wählen Sie auf der
-
-
Aktualisieren Sie die Datenquellendefinitionen mithilfe der Option zum Aktualisieren von Datenquellendefinitionen im Formulardatenmodell-Editor, um den Formulardatenmodell-Cache über die FDM-Benutzeroberfläche zu aktualisieren und die neueste Konfiguration zu erhalten. Dadurch wird sichergestellt, dass der FDM-Cache die neu angewendeten Überschreibungswerte widerspiegelt.
Nächste Schritte next-steps
Sie haben jetzt ein Formulardatenmodell (FDM) dem Datenquellen hinzugefügt wurden. Wenn die Datenquellen verbunden sind, besteht der nächste Schritt darin, das Formulardatenmodell (FDM) zu verfeinern und zu erweitern sodass es die Daten genau darstellt, die Ihr Formular zum Erfassen und Verarbeiten benötigt.
Bearbeiten Sie das Formulardatenmodell (FDM) um die folgenden Aufgaben auszuführen:
- Hinzufügen und Konfigurieren von Datenmodellobjekten und Diensten.
- Fügen Sie Verknüpfungen zwischen Datenmodellobjekten hinzu, um zu definieren, wie verwandte Daten verbunden werden.
- Bearbeiten der Eigenschaften vorhandener Datenmodellobjekte.
- Fügen Sie benutzerdefinierte Datenmodellobjekte und -eigenschaften hinzu, um Daten zu modellieren, die nicht in den verbundenen Datenquellen verfügbar sind.
- Generieren von Beispieldaten, um das Verhalten des Formulardatenmodells zu testen und eine Vorschau davon anzuzeigen.
Mit diesen Konfigurationsschritten können Sie das Formulardatenmodell (FDM) Ihre spezifischen Geschäftsanforderungen anpassen, bevor Sie es an ein Formular binden.
Weitere Informationen finden Sie unter Arbeiten mit einem Formulardatenmodell.