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, Standardauthentifizierung und API-Schlüssel und ermöglicht die Implementierung einer 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. Rufen Sie AEM Webkonsole unter https://server:host/system/console/configMgr auf.

  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. Wechseln Sie zu https://'[server]:[port]'/system/console/crypto.
    1. Geben Sie im Feld **Nur Text** das Kennwort oder eine beliebige Zeichenfolge zum Verschlüsseln an und tippen 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 Sie auf 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. Wechseln Sie zur AEM Web-Konsole unter https://'[server]:[port]'system/console/configMgr.

  2. Suchen Sie nach AEM Forms Data Integrations - User Profile Connector Configuration 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

    Der * im obigen Beispiel zeigt alle Knoten unter dem Knoten profile/empLocation/ im Benutzerprofil AEM CRXDE-Struktur an. Das bedeutet, dass das Formulardatenmodell auf die Eigenschaft city des Typs string zugreifen kann, die in einem beliebigen Knoten unter dem Knoten profile/empLocation/ vorhanden ist. Die Knoten, die die angegebene Eigenschaft enthalten, müssen jedoch einer einheitlichen Struktur entsprechen.

  4. Tippen Sie auf Speichern, um die Konfiguration zu speichern.

Ordner für Cloud-Dienstkonfigurationen konfigurieren

HINWEIS

Die Konfiguration für den Ordner "Cloud-Services"ist für die Konfiguration von Cloud-Services für RESTful-, SOAP- und OData-Dienste erforderlich.

Alle Cloud Service-Konfigurationen in AEM sind im Ordner /conf im AEM Repository konsolidiert. 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. Navigieren Sie zu Tools > Allgemein > Konfigurations-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 globalund 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 Ordner zu erstellen, der für Cloud Service-Konfigurationen aktiviert ist.

RESTful-Webdienste konfigurieren

Der RESTful-Webdienst kann mithilfe von Swagger-Spezifikationen im JSON- oder YAML-Format in einer Swagger-Definitionsdatei beschrieben werden. Um den RESTful-Webdienst in AEM-Cloud-Services zu konfigurieren, stellen Sie sicher, dass sich die Swagger-Datei in Ihrem Dateisystem oder die URL befindet, unter der die Datei gehostet wird.

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

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

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

  2. Tippen Sie auf Erstellen, um den Assistenten Datenquellenkonfiguration erstellen zu öffnen. 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 URL oder Datei aus der Dropdown-Liste Swagger-Quelle aus und geben Sie dementsprechend die Swagger-URL in die Swagger-Definitionsdatei ein oder laden Sie die Swagger-Datei aus Ihrem lokalen Dateisystem hoch.

    • Basierend auf der Swagger Source-Eingabe 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 - Keine, OAuth2.0, Standardauthentifizierung, API-Schlüssel, Benutzerdefinierte Authentifizierung oder gegenseitige Authentifizierung - für den Zugriff auf den RESTful-Dienst aus und geben Sie dementsprechend Details für die Authentifizierung an.

    Wenn Sie API-Schlüssel als Authentifizierungstyp auswählen, geben Sie den Wert für den API-Schlüssel an. Der API-Schlüssel kann als Anforderungsheader oder Abfrageparameter gesendet werden. Wählen Sie aus der Dropdownliste Position eine dieser Optionen aus und geben Sie den Namen der Kopfzeile oder des Abfrageparameters entsprechend im Feld Parametername an.

    Wenn Sie Mutual Authentication als Authentifizierungstyp auswählen, finden Sie weitere Informationen unter Zertifikatbasierte gegenseitige Authentifizierung für RESTful- und SOAP-Webdienste.

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

HTTP-Client-Konfiguration des Formulardatenmodells zur Leistungsoptimierung

Experience Manager Forms Formulardatenmodell bei der Integration mit RESTful-Webdiensten, da die Datenquelle HTTP-Client-Konfigurationen zur Leistungsoptimierung enthält.
Führen Sie die folgenden Schritte aus, um den HTTP-Client des Formulardatenmodells zu konfigurieren:

  1. Melden Sie sich bei Experience Manager Forms Autoreninstanz als Administrator an und gehen Sie zu den Webkonsolen-Bundles Experience Manager. Die Standard-URL lautet https://localhost:4502/system/console/configMgr.

  2. Tippen Sie auf Http-Client-Konfiguration des Formulardatenmodells für die REST-Datenquelle.

  3. Im Dialogfeld Formulardatenmodell HTTP-Client-Konfiguration für REST-Datenquelle :

    • Geben Sie die maximal zulässige Anzahl von Verbindungen zwischen dem Formulardatenmodell und den RESTful-Webdiensten im Feld Verbindungsgrenze insgesamt an. Der Standardwert ist 20 Verbindungen.

    • Geben Sie im Feld Verbindungsgrenze pro Route die maximal zulässige Anzahl von Verbindungen für jede Route an. Der Standardwert ist 2 Verbindungen.

    • Geben Sie im Feld Keep live die Dauer an, für die eine persistente HTTP-Verbindung aufrechterhalten wird. Der Standardwert ist 15 Sekunden.

    • Geben Sie im Feld Verbindungstimeout die Dauer an, für die der Experience Manager Forms-Server auf die Herstellung einer Verbindung wartet. Der Standardwert ist 10 Sekunden.

    • Geben Sie im Feld Socket-Timeout den maximalen Zeitraum für Inaktivität zwischen zwei Datenpaketen an. Der Standardwert ist 30 Sekunden.

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, um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.

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

  2. Tippen Sie auf Erstellen, um den Assistenten Datenquellenkonfiguration erstellen zu öffnen. 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 an, um den in WSDL erwähnten Dienstendpunkt zu überschreiben.

    • Wählen Sie den Authentifizierungstyp - Keine, OAuth2.0, Standardauthentifizierung, Benutzerdefinierte Authentifizierung, X509-Token oder Gegenseitige Authentifizierung - 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 Feld Key Alias an. Geben Sie im Feld Time To Live die Zeit in Sekunden an, bis die Authentifizierungsanforderung gültig bleibt. Optional können Sie den Nachrichtentext oder die Kopfzeile des Zeitstempels oder beides signieren.

      Wenn Sie Mutual Authentication als Authentifizierungstyp auswählen, finden Sie weitere Informationen unter Zertifikatbasierte gegenseitige Authentifizierung für RESTful- und SOAP-Webdienste.

  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:

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-Dienste > Datenquellen. Tippen Sie, um den Ordner auszuwählen, in dem Sie eine Cloud-Konfiguration erstellen möchten.

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

  2. Tippen Sie auf Erstellen, um den Assistenten Datenquellenkonfiguration erstellen zu öffnen. 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 - 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-Dienst zu erstellen.

Zertifikatbasierte gegenseitige Authentifizierung für RESTful- und SOAP-Webdienste

Wenn Sie die gegenseitige Authentifizierung für das Formulardatenmodell aktivieren, authentifizieren sowohl die Datenquelle als auch AEM Server, der das Formulardatenmodell ausführt, die Identität der anderen, bevor Daten freigegeben werden. Sie können die gegenseitige Authentifizierung für REST- und SOAP-basierte Verbindungen (Datenquellen) verwenden. So konfigurieren Sie die gegenseitige Authentifizierung für ein Formulardatenmodell in Ihrer AEM Forms-Umgebung:

  1. Laden Sie den privaten Schlüssel (Zertifikat) auf den Server AEM Forms hoch. So laden Sie den privaten Schlüssel hoch:
    1. Melden Sie sich bei Ihrem AEM Forms-Server als Administrator an.
    2. Navigieren Sie zu Tools > Sicherheit > Benutzer. Wählen Sie den Benutzer fd-cloudservice aus und tippen Sie auf Eigenschaften.
    3. Öffnen Sie die Registerkarte Keystore, erweitern Sie die Option Privaten Schlüssel aus KeyStore-Datei hinzufügen, laden Sie die KeyStore-Datei hoch, geben Sie die Aliase und Kennwörter an und tippen Sie auf Senden. Das Zertifikat wird hochgeladen. Der Alias für den privaten Schlüssel wird im Zertifikat erwähnt und beim Erstellen des Zertifikats festgelegt.
  2. Hochladen des Vertrauenszertifikats in den Global Trust Store. Hochladen des Zertifikats:
    1. Navigieren Sie zu Tools > Sicherheit > Trust Store.
    2. Erweitern Sie die Option Zertifikat aus CER-Datei hinzufügen, tippen Sie auf Zertifikatdatei auswählen, laden Sie das Zertifikat hoch und tippen Sie auf Senden.
  3. Konfigurieren Sie die Webdienste SOAP oder RESTful als Datenquelle und wählen Sie Gegenseitige Authentifizierung als Authentifizierungstyp aus. Wenn Sie mehrere selbstsignierte Zertifikate für fd-cloudservice Benutzer konfigurieren, geben Sie den Namen des Schlüsselalias für das Zertifikat an.

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