Sie sehen sich Hilfeinhalte der folgenden Version an:
- 6.4
- Ältere Versionen
Diese Schulung ist ein Schritt in der Serie Erstellen Sie Ihr erstes adaptives Formular. Es wird empfohlen, der Serie in chronologischer Reihenfolge zu folgen, um den vollständigen Anwendungsfall zu verstehen, auszuführen und zu demonstrieren. |
Mit dem AEM Forms-Datenintegrationsmodul können Sie ein Formulardatenmodell aus verschiedenen Backend-Datenquellen wie AEM-Benutzerprofil, RESTful-Webdiensten, SOAP-basierten Webdiensten, OData-Diensten und relationalen Datenbanken erstellen. Sie können Datenmodellobjekte und -Dienste in einem Formulardatenmodell konfigurieren und einem adaptiven Formular zuordnen. Adaptive Formularfelder sind an Datenmodellobjekteigenschaften gebunden. Mit den Diensten können Sie das adaptive Formular vorab befüllen und gesendete Formulardaten zurück an das Datenmodellobjekt schreiben.
Weitere Informationen zum Formulardatenmodell und zur Formulardatenintegration finden Sie unter Datenintegration für AEM Forms.
Diese Schulung führt Sie durch die Schritte zum Vorbereiten, Erstellen, Konfigurieren und Zuordnen eines Formulardatenmodells mit einem adaptiven Formular. Am Ende dieser Schulung können Sie Folgendes:
- Konfigurieren der MySQL-Datenbank als Datenquelle
- Erstellen eines Formulardatenmodells mit der MySQL-Datenbank
- Konfigurieren eines Formulardatenmodells
- Testen eines Formulardatenmodells
Das Formulardatenmodell sieht etwa wie folgt aus:

Bevor Sie beginnen, stellen Sie Folgendes sicher:
- MySQL-Datenbank mit Beispieldaten wie im Abschnitt „Voraussetzungen“ von Erstellen Sie Ihr erstes adaptives Formular beschrieben
- OSGi-Paket für MySQL JDBC-Treiber wie unter Bündeln der JDBC-Datenbanktreiber erläutert
- Adaptives Formular, wie in der ersten Schulung Adaptive Formulare erstellen
erläutert
Sie können verschiedene Arten von Datenquellen konfigurieren, um ein Formulardatenmodell zu erstellen. Für diese Schulung werden wir die MySQL-Datenbank, die Sie konfiguriert und mit Beispieldaten befüllt haben, konfigurieren. Informationen zu anderen unterstützten Datenquellen und deren Konfiguration finden Sie unter AEM Forms-Datenintegration.
Gehen Sie folgendermaßen vor, um Ihre MySQL-Datenbank zu konfigurieren:
-
-
Melden Sie sich bei der AEM Forms-Autoreninstanz als Administrator an und wechseln Sie zu den AEM-Webkonsolen-Paketen. Die Standard-URL lautet http://localhost:4502/system/console/bundles.
-
Tippen Sie auf Datei auswählen, um das OSBi-Paket für den MySQL-JDBC-Treiber auszuwählen. Wählen Sie Paket starten und Pakete aktualisieren und tippen Sie auf Installieren oder aktualisieren. Stellen Sie sicher, dass der JDBC-Treiber der Oracle Corporation für MySQL aktiv ist. Der Treiber wird installiert.
-
-
-
Wechseln zur AEM-Webkonsole unter http://localhost:4502/system/console/configMgr.
-
Geben Sie im Konfigurationsdialog die folgenden Details an:
- Datenquellenname: Sie können einen beliebigen Namen angeben, beispielsweise WeRetailMySQL.
- Name der DataSource-Diensteigenschaft : Geben Sie den Namen der Diensteigenschaft an, die den DataSource-Namen enthält. Er wird beim Registrieren der Datenquelleninstanz als OSGi-Dienst angegeben. Zum Beispiel: datasource.name.
- JDBC-Treiberklasse: Geben Sie den Java-Klassennamen des JDBC-Treibers an. Geben Sie für die MySQL-Datenbank com.mysql.jdbc.Driver an.
- JDBC-Verbindungs-URI: Geben Sie die Verbindungs-URL der Datenbank an. Für MySQL-Datenbanken, die auf Port 3306 und Schema-Weretails ausgeführt werden, lautet die URL: jdbc:mysql://[server]:3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
- Benutzername: Benutzername der Datenbank. Es ist erforderlich, den JDBC-Treiber zu aktivieren, um eine Verbindung mit der Datenbank herzustellen.
- Kennwort: Kennwort für die Datenbank. Es ist erforderlich, den JDBC-Treiber zu aktivieren, um eine Verbindung mit der Datenbank herzustellen.
- Test on Borrow: Aktivieren Sie die Option Test on Borrow.
- Test on Return: Aktivieren Sie die Option Test on Return.
- Validation Query: Geben Sie eine SQL SELECT-Abfrage ein, damit Verbindungen aus dem Pool validiert werden. Die Abfrage muss mindestens eine Zeile zurückgeben. Beispiel: Wählen Sie * aus Kundendaten.
- Transaktions-Isolierung: Setzen Sie den Wert auf READ_COMMITTED.
Lassen Sie Standardwerte für andere Eigenschaften und tippen Sie auf Speichern.
-
AEM Forms bietet eine intuitive Benutzeroberfläche zum Erstellen eines Formulardatenmodells aus konfigurierten Datenquellen. Sie können mehrere Datenquellen in einem Formulardatenmodell verwenden. Für unseren Anwendungsfall verwenden wir die konfigurierte MySQL-Datenquelle.
Gehen Sie folgendermaßen vor, um ein Formulardatenmodell zu erstellen:
Zum Konfigurieren eines Formulardatenmodells gehört Folgendes:
- Hinzufügen von Datenmodellobjekten und Diensten
- Konfigurieren von Lese- und Schreibdiensten für Datenmodellobjekte
Gehen Sie folgendermaßen vor, um das Formulardatenmodell zu konfigurieren:
-
Navigieren Sie auf dem AEM-Server zu Formulare > Datenintegrationen. Die Standard-URL lautet http://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
-
Erweitern Sie den WeRailMySQL-Datenquellenbaum. Wählen Sie die folgenden Datenmodellobjekte und -dienste aus dem Schema weretail > customerdetails aus, um das Datenmodell zu bilden:
- Datenmodellobjekte:
- id
- name
- shippingAddress
- city
- state
- zipcode
- Dienste:
- get
- update
Tippen Sie auf Ausgewählte hinzufügen, um dem Formulardatenmodell ausgewählte Datenmodellobjekte und Dienste hinzuzufügen.
Hinweis:
Die Standarddienste zum Abrufen, Aktualisieren und Einfügen von JDBC-Datenquellen werden standardmäßig mit dem Formulardatenmodell bereitgestellt.
- Datenmodellobjekte:
-
-
-
Geben Sie im Dialogfeld „Eigenschaften bearbeiten“ Folgendes an:
- Titel: Geben Sie den Titel des Dienstes an. Beispiel: Lieferadresse abrufen.
- Beschreibung: Geben Sie eine Beschreibung an, die das detaillierte Funktionieren des Dienstes enthält. Beispiel:
Dieser Dienst ruft die Lieferadresse und andere Kundendaten aus der MySQL-Datenbank ab - Ausgabemodellobjekt: Wählen Sie ein Schema mit Kundendaten. Beispiel:
Schema „customerdetail“ - Array zurückgeben: Deaktivieren Sie die Option Array zurückgeben.
- Argumente: Wählen Sie das Argument mit dem Namen ID.
Tippen Sie auf Fertig. Der Dienst zum Abrufen von Kundendaten aus der MySQL-Datenbank ist konfiguriert.
-
Geben Sie im Dialogfeld „Eigenschaften bearbeiten“ Folgendes an:
- Titel: Geben Sie den Titel des Dienstes an. Beispiel: Lieferadresse aktualisieren.
- Beschreibung: Geben Sie eine Beschreibung an, die das detaillierte Funktionieren des Dienstes enthält. Beispiel:
Dieser Dienst aktualisiert die Lieferadresse und die zugehörigen Felder in der MySQL-Datenbank - Eingabemodellobjekt: Wählen Sie ein Schema mit Kundendaten. Beispiel:
Schema „customerdetail“ - Ausgabetyp: Wählen Sie BOOLEAN.
- Argumente: Wählen Sie das Argument mit dem Namen ID und customerdetails.
Tippen Sie auf Fertig. Der Dienst update zum Aktualisieren von Kundendetails in der MySQL-Datenbank ist konfiguriert.
Das Datenmodellobjekt und die Dienste im Formulardatenmodell sind konfiguriert. Sie können nun das Formulardatenmodell testen.
Sie können das Datenmodellobjekt und die Datendienste testen, um zu überprüfen, ob das Formulardatenmodell ordnungsgemäß konfiguriert ist.
Führen Sie folgende Schritte aus, um den Test durchzuführen:
-
In ähnlicher Weise können Sie das Schreibmodellobjekt und die Dienste testen.
Im folgenden Beispiel aktualisiert der Aktualisierungsdienst die Adressdetails für die ID 7102715 in der Datenbank erfolgreich.
Wenn Sie nun den Lesemodelldienst für die ID 7107215 erneut testen, werden die aktualisierten Kundendetails abgerufen und angezeigt (siehe unten).