Schulung: Formulardatenmodell erstellen tutorial-create-form-data-model

04-create-form-data-model-main

Dieses Tutorial ist ein Teil der Serie Erstellen Ihres ersten adaptives Formulars. Adobe empfiehlt, der Reihe chronologisch zu folgen, um den gesamten Anwendungsfall des Tutorials zu verstehen, auszuführen und praktisch zu erleben.

Über das Tutorial about-the-tutorial

Mit dem Datenintegrationsmodul von AEM Forms können Sie ein Formulardatenmodell aus verschiedenen Backend-Datenquellen wie AEM-Benutzerprofil, RESTful-Web-Services, SOAP-basierten Web-Services, OData-Services und relationalen Datenbanken erstellen. Sie können Datenmodellobjekte und -dienste in einem Formulardatenmodell konfigurieren und einem adaptiven Formular zuordnen. Adaptive Formularfelder sind an Datenmodellobjekt-Eigenschaften 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.

Dieses Tutorial führt Sie durch die Schritte zum Vorbereiten, Erstellen, Konfigurieren und Verknüpfen eines Formulardatenmodells mit einem adaptiven Formular. Am Ende dieses Tutorials können Sie Folgendes:

Das Formulardatenmodell sieht etwa wie folgt aus:

form-data-model_l

A. Konfigurierte Datenquellen B. Datenquellenschemata C. Verfügbare Services D. Datenmodellobjekte E. Konfigurierte Services

Voraussetzungen prerequisites

Bevor Sie beginnen, stellen Sie Folgendes sicher:

Schritt 1: Konfigurieren der MySQL-Datenbank als Datenquelle config-database

Sie können verschiedene Arten von Datenquellen konfigurieren, um ein Formulardatenmodell zu erstellen. Zu diesem Anleitung konfigurieren Sie die MySQL-Datenbank, die Sie konfiguriert und mit Beispieldaten aufgefüllt haben. 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:

  1. Installieren Sie den JDBC-Treiber für die MySQL-Datenbank als OSGi-Bundle:

    1. Laden Sie das MySQL JDBC-Treiber-OSGi-Bundle von http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html herunter.

    2. Melden Sie sich bei der AEM Forms-Autoreninstanz als Administrator an und wechseln Sie zu den AEM-Web-Konsole-Bundles. Die Standard-URL lautet http://localhost:4502/system/console/bundles.

    3. Auswählen Installieren/Aktualisieren. Ein Dialogfeld Pakete hochladen/installieren wird angezeigt.

    4. Wählen Sie Datei auswählen aus, um den MySQL JDBC-Treiber OSGi Paket zu durchsuchen und auszuwählen. Wählen Sie Anfang Paket und Aktualisieren Pakete aus und wählen Sie "Installieren" oder " Aktualisieren". Stellen Sie sicher, dass der JDBC-Treiber der Oracle Corporation’s für MySQL aktiv ist. Der Treiber wird installiert.

  2. Konfigurieren Sie die MySQL-Datenbank als Datenquelle:

    1. Wechseln Sie zu AEM-Web-Konsole unter http://localhost:4502/system/console/configMgr.

    2. Suchen Sie die Konfiguration Apache Sling Connection Pooled DataSource. Tippen Sie darauf, um die Konfiguration im Bearbeitungsmodus zu öffnen.

    3. 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 portieren 3306 und Schema weretailausgeführt werden, lautet die URL: jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      note note
      NOTE
      Wenn sich die MySQL-Datenbank hinter einer Firewall befindet, ist der Datenbank-Host-Name kein öffentliches DNS. Die IP-Adresse der Datenbank muss in der Datei /etc/hosts des AEM Host Computers hinzugefügt werden.
      • 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.
      note note
      NOTE
      AEM Forms unterstützt keine NT-Authentifizierung für MySQL. OK auf AEM Webkonsole unter https://localhost:4502/system/console/configMgr und suchen "Apache Sling Verbindung Pooled Datasource". Legen Sie für Eigenschaft "JDBC connection URI" den Wert von "integratedSecurity" auf "False" fest, und verwenden Sie den erstellten Benutzernamen und Kennwort zum Herstellen einer Verbindung mit MySQL der Datenbank.
      • Test on Borrow: Aktivieren Sie die Option Test on Borrow.

      • Test on Return: Aktivieren Sie die Option Test on Return.

      • Validierungsabfrage: Geben Sie eine SQL SELECT-Abfrage an, damit Verbindungen aus dem Pool validiert werden. Die Abfrage muss mindestens eine Zeile zurückgeben. Zum Beispiel select * from customerdetails.

      • Transaktions-Isolierung: Setzen Sie den Wert auf READ_COMMITTED.

        Belassen Sie die Standardwerte(https://tomcat.apache.org/tomcat-7.0-doc/jdbc-pool.html) bei den anderen Eigenschaften und [wählen Sie Speichern ]​ aus.

        Eine Konfiguration ähnlich der folgenden wird erstellt.

        relational-database-data-source-configuration

Schritt 2: Erstellen eines Formulardatenmodells create-fdm

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 diesen Anwendungsfall können Sie die konfigurierte MySQL Datenquelle verwenden.

Gehen Sie folgendermaßen vor, um ein Formulardatenmodell zu erstellen:

  1. Navigieren Sie in der AEM-Autoreninstanz zu FormulareDatenintegration.

  2. Wählen Sie Erstellen > Formular Daten Modell.

  3. Geben Sie im Dialogfeld „Formulardatenmodell erstellen“ einen Namen für das Formulardatenmodell ein. Zum Beispiel customer-shipping-billing-details. Wählen Sie Weiter aus.

  4. Im Bildschirm „Datenquelle auswählen“ werden alle konfigurierten Datenquellen angezeigt. Auswählen WeRetailMySQL Datenquelle und wählen Sie Erstellen.

    data-source-selection

Das Formulardatenmodell customer-shipping-billing-details wird erstellt.

Schritt 3: Konfigurieren des Formulardatenmodells config-fdm

Das Konfigurieren des Formulardatenmodells umfasst Folgendes:

  • Hinzufügen von Datenmodellobjekten und Diensten
  • Konfigurieren von Lese- und Schreibdiensten für Datenmodellobjekte

Gehen Sie wie folgt vor, um das Formulardatenmodell zu konfigurieren:

  1. Navigieren Sie in der AEM-Autoreninstanz zu Formulare > Datenintegrationen. Die Standard-URL lautet https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

  2. Das Formulardatenmodell customer-shipping-billing-details, dass Sie zuvor erstellt haben, ist hier aufgeführt. Öffnen Sie es im Bearbeitungsmodus.

    Die ausgewählte Datenquelle WeRetailMySQL wird im Formulardatenmodell konfiguriert.

    default-fdm

  3. Erweitern Sie den WeRailMySQL-Datenquellenbaum. Wählen Sie die folgenden Datenmodellobjekte und -dienste aus der Schema von weretail > customerdetails aus, damit Sie ein Datenmodell erstellen können:

    • Datenmodellobjekte:

      • id
      • name
      • shippingAddress
      • city
      • state
      • Postleitzahl
    • Dienste:

      • Abrufen
      • Aktualisieren

    Wählen Sie hinzufügen Selected aus, um dem Formulardatenmodell ausgewählte Modellobjekte und Dienste hinzuzufügen.

    WeRetail-Schema

    note note
    NOTE
    Die Standard-Services zum Abrufen, Aktualisieren und Einfügen von JDBC-Datenquellen werden standardmäßig mit dem Formulardatenmodell bereitgestellt.
  4. Konfigurieren Sie die Lese- und Schreibdienste für das Datenmodellobjekt.

    1. Wählen Sie die customerdetails Datenmodellobjekt und auswählen Eigenschaften bearbeiten.

    2. Wählen Sie aus dem Dropdown-Menü „Lesedienst“ get. Das Argument id, das der Primärschlüssel im Datenmodellobjekt des „customerdetails“ ist, wird automatisch hinzugefügt. Wählen Sie aem_6_3_edit und konfigurieren Sie das Argument wie folgt.

      read-default

    3. Wählen Sie auf ähnliche Weise Aktualisieren als Schreibdienst. Das Objekt customerdetails wird automatisch als Argument hinzugefügt. Das Argument wird wie folgt konfiguriert.

      write-default

      Fügen Sie das Argument id hinzu und konfigurieren Sie es wie folgt.

      id-arg

    4. Wählen Sie Fertig aus, um die Eigenschaften des Datenmodellobjekts zu speichern. Wählen Sie dann Speichern aus, um das Formulardatenmodell zu speichern.

      Die Dienste get und update werden als Standarddienste für das Datenmodellobjekt hinzugefügt.

      data-model-object

  5. Wechseln Sie zur Registerkarte Dienste und konfigurieren Sie die Dienste get und update.

    1. Wählen Sie den Get-Dienst und dann Bearbeiten Eigenschaften aus. Das Dialogfeld „Eigenschaften“ wird geöffnet.

    2. Geben Sie im Dialogfeld „Eigenschaften bearbeiten“ Folgendes an:

      • Titel: Geben Sie den Titel des Dienstes an. Zum Beispiel: Versandadresse abrufen.

      • Beschreibung: Geben Sie eine Beschreibung an, die eine detaillierte Funktionsweise 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:

        customerdetail schema

      • Array zurückgeben: Deaktivieren Sie die Option Array zurückgeben.

      • Argumente: Wählen Sie das Argument mit dem Namen ID aus.

      Klicken Sie auf Fertig. Der Dienst zum Abrufen von Kundendaten aus der MySQL-Datenbank ist konfiguriert.

      shiiping-address-retrieve

    3. Wählen Sie den Update-Dienst und dann Bearbeiten Eigenschaften aus. Das Dialogfeld „Eigenschaften“ wird geöffnet.

    4. Geben Sie im Dialogfeld Eigenschaften bearbeiten Folgendes an:

      • Titel: Geben Sie den Titel des Dienstes an. Beispiel: Versandadresse aktualisieren.

      • Beschreibung: Geben Sie eine Beschreibung an, die eine detaillierte Funktionsweise des Dienstes enthält. Beispiel:

        Dieser Service aktualisiert die Lieferadresse und die zugehörigen Felder in der MySQL-Datenbank

      • Eingabemodellobjekt: Wählen Sie ein Schema mit Kundendaten. Beispiel:

        customerdetail schema

      • Ausgabetyp: Wählen Sie BOOLEAN.

      • Argumente: Wählen Sie den Argumentnamen , die ID und die Kundendetails aus.

      Klicken Sie auf Fertig. Der Service update zur Aktualisierung der Kundendaten in der MySQL-Datenbank ist konfiguriert.

      shiiping-address-update

Das Datenmodellobjekt und die Dienste im Formulardatenmodell sind konfiguriert. Sie können das Formulardatenmodell jetzt testen.

Schritt 4: Testen des Formulardatenmodells test-fdm

Sie können das Datenmodellobjekt und die Services testen, um zu überprüfen, ob das Formulardatenmodell ordnungsgemäß konfiguriert ist.

Führen Sie folgende Schritte aus, um den Test durchzuführen:

  1. OK Sie zur Modell-Tab, wählen Sie das Datenmodellobjekt "customerdetails" und anschließend Test Modell-Objekt aus.

  2. Wählen Sie im Fenster Modell/Dienst testen Modellobjekt lesen aus der Dropdown-Liste Modell/Dienst auswählen auswählen.

  3. Geben Sie im Abschnitt customerdetails einen Wert für das ID-Argument an, das in der konfigurierten MySQL Datenbank vorhanden ist, und wählen Sie Test aus.

    Die Kundendetails, die der angegebenen ID zugeordnet sind, werden abgerufen und im Abschnitt Ausgabe angezeigt, wie unten gezeigt.

    test-read-model

  4. Auf ähnliche Weise können Sie das Schreib-Modellobjekt und die Dienste testen.

    Im folgenden Beispiel ändert der Aktualisierungsdienst erfolgreich die Adressdetails für die ID 7102715 in der Datenbank.

    test-write-model

    Wenn Sie nun den Lesemodelldienst für die ID 7107215 erneut Test, werden die aktualisierten Kundendetails wie unten dargestellt abgerufen und angezeigt.

    read-updated

NOTE
Sie können die SharePoint Liste-Konfiguration mithilfe Formular Daten Modells in einem adaptiven Formular erstellen und verwenden, um Daten oder generierte Datensatzdokumente in einer SharePoint-Liste zu speichern. Detaillierte Schritte finden Sie unter Verbinden eines adaptiven Formular mit Microsoft SharePoint-Liste®.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2