Konfigurieren von Datenquellen

Erfahren Sie, wie Sie verschiedene Arten von Datenquellen konfigurieren und das Erstellen von Formulardatenmodellen nutzen können.

Mit der AEM Forms-Datenintegration können Sie unterschiedliche Datenquellen konfigurieren und Verbindungen zu ihnen herzustellen. Die folgenden Datenquellen werden standardmäßig unterstützt. Es ist jedoch möglich, mit nur wenigen Anpassungen auch andere Datenquellen zu integrieren.

  • Relationale Datenbanken: MySQL, Microsoft SQL Server, IBM DB2 und Oracle RDBMS
  • AEM-Benutzerprofil
  • RESTful-Webservices
  • SOAP-basierte Webservices
  • OData-Services

Die Datenintegration unterstützt standardmäßig die Authentifizierungstypen OAuth2.0, Standardauthentifizierung sowie API-Schlüssel und ermöglicht die Implementierung benutzerdefinierter Authentifizierung für den Zugriff auf Webservices. RESTful-, SOAP-basierte und OData-Dienste werden in AEM-Cloud-Services, JDBC für relationale Datenbanken und der Connector für AEM-Profile dagegen in der AEM-Webkonsole konfiguriert.

Konfigurieren relationaler Datenbanken

Sie können relationale Datenbanken mithilfe der AEM Web Console-Konfiguration konfigurieren. Gehen Sie folgendermaßen vor:

  1. Rufen Sie AEM Webkonsole auf unter https://[server]:[host]/system/console/configMgr.

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

  3. Geben Sie im Konfigurationsdialogfeld die Details für die Datenbank an, die Sie konfigurieren möchten, z. B.:

    • Name der Datenquelle
    • Datenquellendienst-Eigenschaft, in der der Name der Datenquelle gespeichert wird
    • Java-Klassenname für den JDBC-Treiber
    • JDBC-Verbindungs-URI
    • Benutzername und Kennwort zum Herstellen der Verbindung zum JDBC-Treiber
    HINWEIS

    Stellen Sie sicher, dass Sie vertrauliche Informationen wie Kennwörter verschlüsseln, bevor Sie die Datenquelle konfigurieren. Gehen Sie zum Verschlüsseln wie folgt vor:

    1. Rufen Sie https://[server]:[port]/system/console/crypto auf.
    2. Geben Sie im Feld Plain Text das Kennwort bzw. die zu verschlüsselnde Zeichenfolge ein und klicken Sie auf Protect.

    Der verschlüsselte Text wird im Feld Geschützter Text angezeigt, das Sie in der Konfiguration angeben können.

  4. Aktivieren Sie Test on Borrow oder Test on Return, um festzulegen, dass die Objekte vor der Entnahme oder bei der Rückgabe aus dem bzw. in den Pool validiert werden sollen.

  5. Geben Sie eine SQL SELECT-Abfrage in das Feld Validation Query ein, damit Verbindungen aus dem Pool validiert werden. Die Abfrage muss mindestens eine Zeile zurückgeben. Legen Sie die für Ihre Datenbank geeignete Option fest:

    • SELECT 1 (MySQL und MS SQL)
    • SELECT 1 from dual (Oracle)
  6. Tippen Speichern , um die Konfiguration zu speichern.

AEM-Benutzerprofil konfigurieren

Sie können das AEM-Benutzerprofil mithilfe der User Profile Connector-Konfiguration in der AEM-Webkonsole konfigurieren. Gehen Sie folgendermaßen vor:

  1. Rufen Sie AEM Webkonsole auf unter https://[server]:[host]/system/console/configMgr.

  2. Suchen nach AEM Forms-Datenintegrationen - Benutzerprofil-Connector-Konfiguration und tippen Sie auf , um die Konfiguration im Bearbeitungsmodus zu öffnen.

  3. Im Dialogfeld für die Benutzerprofil-Connector-Konfiguration können Sie Benutzerprofileigenschaften hinzufügen, entfernen oder aktualisieren. Die angegebenen Eigenschaften sind zur Verwendung im Formulardatenmodell verfügbar. Verwenden Sie das folgende Format, um Benutzerprofileigenschaften festzulegen:

    name=[property_name_with_location_in_user_profile],type=[property_type]

    Beispiele:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    HINWEIS

    Die * im obigen Beispiel bedeutet, dass alle Knoten unter profile/empLocation/ Knoten in AEM Benutzerprofil in der CRXDE-Struktur. Das bedeutet, dass das Formulardatenmodell auf die city Eigenschaft des Typs string in jedem Knoten unter profile/empLocation/ Knoten. Die Knoten, die die angegebene Eigenschaft enthalten, müssen jedoch einer einheitlichen Struktur entsprechen.

  4. Tippen Speichern , um die Konfiguration zu speichern.

Einstellen des Ordners für Cloud-Service-Konfigurationen

HINWEIS

Die Konfiguration des Cloud Services-Ordners ist erforderlich, um Cloud Services für RESTful-, SOAP- und OData-Services zu konfigurieren.

Alle Cloud Service-Konfigurationen in AEM werden im /conf Ordner in AEM Repository. Standardmäßig enthält der Ordner conf den Ordner global, in dem Sie Cloud Service-Konfigurationen erstellen können. Sie müssen ihn jedoch manuell für Cloud-Konfigurationen aktivieren. Sie können auch zusätzliche Ordner in conf erstellen, um Cloud Service-Konfigurationen zu erstellen und zu organisieren.

Konfigurieren des Ordners für Cloud Service-Konfigurationen:

  1. Wählen Sie Tools > Allgemein > Konfigurationsbrowser.

    • Weitere Informationen finden Sie in der Dokumentation zum 🔗Konfigurationsbrowser.
  2. Gehen Sie folgendermaßen vor, um den globalen Ordner für Cloud-Konfigurationen zu aktivieren, oder überspringen Sie diesen Schritt, um einen anderen Ordner für Cloud Service-Konfigurationen zu erstellen und zu konfigurieren.

    1. Wählen Sie im Konfigurationsbrowser den Ordner global aus und tippen Sie auf Eigenschaften.
    2. Aktivieren Sie im Dialogfeld Konfigurationseigenschaften die Option Cloud-Konfigurationen.
    3. Tippen Sie auf Speichern und schließen, um die Konfiguration zu speichern und das Dialogfeld zu schließen.
  3. Tippen Sie im Konfigurationsbrowser auf Erstellen.

  4. Legen Sie im Dialogfeld Konfiguration erstellen einen Titel für den Ordner fest und aktivieren Sie Cloud-Konfigurationen.

  5. Tippen Sie auf Erstellen, um den für Cloud Service-Konfigurationen aktivierten Ordner zu erstellen.

Konfigurieren von RESTful-Webservices

Der RESTful-Webdienst kann mithilfe von Swagger-Spezifikationen im JSON- oder YAML-Format in einer Swagger-Definitionsdatei. Um den RESTful-Webdienst in den AEM-Cloud-Services zu konfigurieren, müssen Sie entweder über die Swagger-Datei auf Ihrem System oder über die URL verfügen, unter der die Datei gehostet wird.

Gehen Sie wie folgt vor, um RESTful-Services zu konfigurieren:

  1. Wechseln Sie zu Tools > Cloud Services > Data Sources. Tippen Sie, um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.

    Weitere Informationen zum Erstellen und Konfigurieren eines Ordners für Cloud Service-Konfigurationen finden Sie unter Konfigurieren des Ordners für Cloud Service-Konfigurationen.

  2. Tippen Erstellen , um Dialogfeld "Datenquellenkonfiguration erstellen". Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie RESTful-Service aus der Dropdown-Liste Service-Typ aus, suchen Sie optional nach einem Miniaturbild für die Konfiguration und tippen Sie auf Weiter.

  3. Geben Sie folgende Details für den RESTful-Service an:

    • Wählen Sie „URL“ oder „Datei“ aus der Swagger Source-Dropdownliste aus und geben Sie dementsprechend die URL zur Swagger-Definitionsdatei an oder laden Sie die Swagger-Datei aus Ihrem lokalen Dateisystem hoch.
    • Wählen Sie den Authentifizierungstyp – Ohne, OAuth2.0, Standardauthentifizierung, API-Schlüssel oder benutzerdefinierte Authentifizierung – für den Zugriff auf den RESTful-Service aus und geben Sie dementsprechend die Details für die Authentifizierung an.
  4. Tippen Sie auf Erstellen, um die Cloud-Konfiguration für den RESTful-Service zu erstellen.

SOAP-Webservices konfigurieren

SOAP-basierte Webservices werden mithilfe von WSDL-Spezifikationen (Web Services Description Language) beschrieben. Um den SOAP-basiertenWebdienst in den AEM-Cloud-Services zu konfigurieren, benötigen Sie die WSDL-URL für den Webdienst. Gehen Sie dann wie folgt vor:

  1. Wechseln Sie zu Tools > Cloud Services > Data Sources. Tippen Sie, um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.

    Weitere Informationen zum Erstellen und Konfigurieren eines Ordners für Cloud Service-Konfigurationen finden Sie unter Konfigurieren des Ordners für Cloud Service-Konfigurationen.

  2. Tippen Erstellen , um Dialogfeld "Datenquellenkonfiguration erstellen". Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie SOAP-Webservice aus der Dropdown-Liste Service-Typ aus, suchen Sie optional nach einem Miniaturbild für die Konfiguration, und tippen Sie auf Weiter.

  3. Geben Sie Folgendes für den SOAP-Webservice an:

    • WSDL-URL für den Webservice.

    • Service-Endpunkt. Geben Sie in diesem Feld einen Wert ein, um den in WSDL erwähnten Service-Endpunkt zu überschreiben.

    • Wählen Sie den Authentifizierungstyp - Keine, OAuth2.0, Standardauthentifizierung, Benutzerdefinierte Authentifizierung oder X509-Token - für den Zugriff auf den SOAP-Dienst aus und geben Sie dementsprechend die Details für die Authentifizierung an.

      Wenn Sie "X509 Token"als Authentifizierungstyp auswählen, konfigurieren Sie das X509-Zertifikat. Weitere Informationen finden Sie unter Einrichten von Zertifikaten.
      Geben Sie den KeyStore-Alias für das X509-Zertifikat im Schlüsselalias -Feld. Geben Sie die Zeit in Sekunden, bis die Authentifizierungsanforderung gültig bleibt, im Time to Live -Feld. Optional können Sie den Nachrichtentext oder die Kopfzeile des Zeitstempels oder beides signieren.

  4. Tippen Sie auf Erstellen, um die Cloud-Konfiguration für den SOAP-Webservice zu erstellen.

Konfigurieren von OData-Services

Ein OData-Service wird anhand seiner Service-Stamm-URL identifiziert. Stellen Sie zum Konfigurieren eines OData-Dienstes in AEM-Cloud-Services sicher, dass Sie die Dienststamm-URL für den Service haben, und gehen Sie folgendermaßen vor:

HINWEIS

Eine schrittweise Anleitung zum Konfigurieren von Microsoft Dynamics 365, online oder On-Premise, finden Sie unter Microsoft Dynamics OData-Konfiguration .

  1. Wechseln Sie zu Tools > Cloud Services > Datenquellen. Tippen Sie, um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.

    Weitere Informationen zum Erstellen und Konfigurieren eines Ordners für Cloud Service-Konfigurationen finden Sie unter Konfigurieren des Ordners für Cloud Service-Konfigurationen.

  2. Tippen Erstellen , um Dialogfeld "Datenquellenkonfiguration erstellen". Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie OData-Service aus der Dropdown-Liste „Service-Typ“ aus, suchen Sie optional nach einem Miniaturbild für die Konfiguration und tippen Sie auf Weiter.

  3. Geben Sie folgende Details für den OData-Service an:

    • Service-Stamm-URL für den zu konfigurierenden OData-Service.
    • Wählen Sie den Authentifizierungstyp - Keine, OAuth2.0, Standardauthentifizierung oder Benutzerdefinierte Authentifizierung - für den Zugriff auf den OData-Dienst aus und geben Sie dementsprechend die Details für die Authentifizierung an.
    HINWEIS

    Sie müssen den OAuth 2.0-Authentifizierungstyp auswählen, um eine Verbindung mit Microsoft Dynamics-Diensten herzustellen, die den OData-Endpunkt als Dienststamm nutzen.

  4. Tippen Sie auf Erstellen, um die Cloud-Konfiguration für den OData-Service zu erstellen.

Nächste Schritte

Sie haben die Datenquellen konfiguriert. Als Nächstes können Sie ein Formulardatenmodell erstellen oder, falls Sie bereits ein Formulardatenmodell ohne Datenquelle erstellt haben, können Sie es den soeben konfigurierten Datenquellen zuordnen. Weitere Informationen finden Sie unter Erstellen eines Formulardatenmodells.

Auf dieser Seite