Show Menu
THEMEN×

Konfigurieren von Datenquellen

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-Dienstleistungen
Die Datenintegration unterstützt standardmäßig die Authentifizierungstypen OAuth2.0, Basic Authentication und API Key und ermöglicht die Implementierung der benutzerdefinierten Authentifizierung für den Zugriff auf Webdienste. 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. Wechseln Sie zu AEM-Webkonsole 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
    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. Go to https://' # : # '/system/console/crypto.
    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. Tap Save to save the configuration.

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. Go to AEM web console at https://' # : # 'system/console/configMgr.
  2. Look for AEM Forms Data Integrations - User Profile Connector Configuration and tap to open the configuration in edit mode.
  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
    The * in the above example denotes all nodes under the profile/empLocation/ node in AEM user profile in CRXDE structure. It means that the form data model can access the city property of type string present in any node under the profile/empLocation/ node. Die Knoten, die die angegebene Eigenschaft enthalten, müssen jedoch einer einheitlichen Struktur entsprechen.
  4. Tap Save to save the configuration.

Ordner für Cloud-Dienstkonfigurationen konfigurieren

Zum Konfigurieren von Cloud-Diensten für RESTful-, SOAP- und OData-Dienste ist eine Konfiguration des Ordners für Cloud-Dienste erforderlich.
All cloud service configurations in AEM are consolidated in the /conf folder in AEM repository. Standardmäßig enthält der Ordner conf den Ordner global , in dem Sie Cloud-Dienst-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-Dienstkonfigurationen zu erstellen und zu organisieren.
Konfigurieren des Ordners für Cloud-Dienstkonfigurationen:
  1. Go to Tools > General > Configuration Browser .
  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-Dienstkonfigurationen zu erstellen und zu konfigurieren.
    1. Wählen Sie im Konfigurationsbrowser den Ordner global 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. Tap Create to create the folder enabled for cloud service configurations.

RESTful-Webdienste konfigurieren

RESTful web service can be described using Swagger specifications in JSON or YAML format in a Swagger definition file. Um RESTful-Webdienst in AEM cloud services zu konfigurieren, stellen Sie sicher, dass die Swagger-Datei im Dateisystem oder die URL, unter der die Datei gehostet wird, vorhanden ist.
Gehen Sie wie folgt vor, um RESTful-Dienste zu konfigurieren:
  1. Wechseln Sie zu Tools > Cloud-Dienste > Datenquellen . Tippen Sie auf , um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.
    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.
  2. Tap Create to open the Create Data Source Configuration wizard . Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie RESTful-Dienst aus der Dropdown-Liste Service-Typ , suchen Sie optional nach einem Miniaturbild für die Konfiguration, und tippen Sie auf Weiter .
  3. Geben Sie die folgenden Details für den RESTful-Dienst an:
    • Wählen Sie in der Dropdown-Liste "Swagger-Quelle"die Option "URL"oder "Datei"und geben Sie entsprechend die Swagger-URL zur Swagger-Definitionsdatei an oder laden Sie die Swagger-Datei aus Ihrem lokalen Dateisystem hoch.
    • Basierend auf der Swagger-Quelleingabe werden die folgenden Felder mit Werten vorausgefüllt:
      • Regelung: Die von der REST-API verwendeten Übertragungsprotokolle. Die Anzahl der in der Dropdown-Liste angezeigten Schematypen hängt von den in der Swagger-Quelle definierten Schemata ab.
      • Host: Der Domänenname oder die IP-Adresse des Hosts, der die REST-API bereitstellt. Dies ist ein Pflichtfeld.
      • Basispfad: Das URL-Präfix für alle API-Pfade. Dies ist ein optionales Feld.\
        Bearbeiten Sie bei Bedarf die vorausgefüllten Werte für diese Felder.
    • Wählen Sie den Authentifizierungstyp aus — Keine, OAuth2.0, einfache Authentifizierung, API-Schlüssel oder benutzerdefinierte Authentifizierung — , um auf den RESTful-Dienst zuzugreifen und dementsprechend Details zur Authentifizierung anzugeben.
    Wenn Sie als Authentifizierungstyp " API-Schlüssel "auswählen, geben Sie den Wert für den API-Schlüssel an. Der API-Schlüssel kann als Anforderungsheader oder als Abfrage-Parameter gesendet werden. Wählen Sie eine dieser Optionen aus der Dropdown-Liste " Position "und geben Sie den Namen der Kopfzeile bzw. des Abfrage-Parameters im Feld Parametername entsprechend an.
  4. Tippen Sie auf Erstellen , um die Cloud-Konfiguration für den RESTful-Dienst zu erstellen.

SOAP-Webdienste konfigurieren

SOAP-basierte Webdienste 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-Dienste > Datenquellen . Tippen Sie auf , um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.
    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.
  2. Tap Create to open the Create Data Source Configuration wizard . Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie SOAP Web-Dienst aus der Dropdown-Liste Service-Typ , suchen Sie optional nach einem Miniaturbild für die Konfiguration, und tippen Sie auf Weiter .
  3. Geben Sie Folgendes für den SOAP-Webdienst an:
    • WSDL-URL für den Webdienst.
    • Dienstendpunkt. Geben Sie in diesem Feld einen Wert ein, um den in WSDL erwähnten Dienstendpunkt zu überschreiben.
    • Wählen Sie den Authentifizierungstyp aus — Keine, OAuth2.0, einfache Authentifizierung, benutzerdefinierte Authentifizierung oder X509-Token — , um auf den SOAP-Dienst zuzugreifen und die Details zur Authentifizierung anzugeben.
      Wenn Sie als Authentifizierungstyp "X509-Token"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 Feld Key Alias an. Geben Sie im Feld " Zeit bis zum Live "die Zeit in Sekunden an, bis die Authentifizierungsanforderung gültig bleibt. Optional können Sie den Nachrichtentext oder die Zeitstempelüberschrift oder beides signieren.
  4. Tippen Sie auf Erstellen , um die Cloud-Konfiguration für den SOAP-Webdienst zu erstellen.

OData-Dienste konfigurieren

Ein OData-Dienst wird anhand seiner Dienststamm-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:
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-Dienste > Datenquellen . Tippen Sie auf , um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.
    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.
  2. Tap Create to open the Create Data Source Configuration wizard . Geben Sie einen Namen und optional einen Titel für die Konfiguration ein, wählen Sie OData-Dienst aus der Dropdown-Liste Service-Typ , suchen Sie optional nach einem Miniaturbild für die Konfiguration, und tippen Sie auf Weiter .
  3. Geben Sie die folgenden Details für den OData-Dienst an:
    • Dienststamm-URL für den zu konfigurierenden OData-Dienst.
    • Wählen Sie den Authentifizierungstyp aus — Keine, OAuth2.0, einfache Authentifizierung oder benutzerdefinierte Authentifizierung — , um auf den OData-Dienst zuzugreifen und die Details zur Authentifizierung anzugeben.
    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. Tap Create to create the cloud configuration for the OData service.

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. See Create form data model for details.