Konfigurieren von Datenquellen

Mit der AEM Forms-Datenintegration können Sie unterschiedliche Datenquellen konfigurieren und eine Verbindung zu ihnen herstellen. 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, Oracle RDBMS, postgreSQL und Sybase
• AEM-Benutzerprofil
• RESTful-Webservices
• SOAP-basierte Webservices
• OData-Services

Die Datenintegration unterstützt standardmäßig die Authentifizierungstypen OAuth2.0 (Autorisierungs-Code, Client-Anmeldeinformationen), Standardauthentifizierung sowie API-Schlüssel und ermöglicht die Implementierung benutzerdefinierter Authentifizierung für den Zugriff auf Web-Services. 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-Konsolenkonfiguration konfigurieren. Gehen Sie folgendermaßen vor:

1. Wechseln Sie zur AEM-Web-Konsole unter https://server:host/system/console/configMgr.

2. Suchen Sie die Konfiguration Apache Sling Connection Pooled DataSource. Tippen Sie auf die Konfiguration, um sie 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 Passwort zum Herstellen der Verbindung mit dem 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.
   2. Geben Sie im Feld Plain Text das Kennwort oder eine beliebige Zeichenfolge zum Verschlüsseln an und tippen Sie auf Protect.

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

4. Aktivieren Sie Test bei Entnahme oder Test bei Rückgabe, 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 im Feld Überprüfungsabfrage ein, um Verbindungen aus dem Pool zu validieren. Die Abfrage muss mindestens eine Zeile zurückgeben. Legen Sie je nach Datenbank eine der folgenden Optionen fest:

   • SELECT 1 (MySQL und MS SQL)
   • SELECT 1 from dual (Oracle)

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

   HINWEIS

   Wenn Ihr Datenmodell in Forms ein Objekt enthält, das ein reserviertes Keyword für Ihre relationale Datenbank ist, kann dies zu Problemen beim Hinzufügen, Aktualisieren oder Abrufen von Daten führen. Vermeiden Sie daher die Verwendung solcher Objekte in Ihrem Formulardatenmodell.

Konfigurieren des AEM-Benutzerprofils

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

1. Wechseln Sie zur AEM-Web-Console unter https://'[server]:[port]'system/console/configMgr.

2. Suchen Sie nach AEM Forms Data Integrations - User Profile Connector Configuration und tippen Sie darauf, 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 bezeichnet alle Knoten unter dem Knoten profile/empLocation/ im AEM-Benutzerprofil in der CRXDE-Struktur. Das bedeutet, dass das Formulardatenmodell auf die Eigenschaft city des Typs string in jedem Knoten unter dem profile/empLocation/-Knoten zugreifen kann. Die Knoten, die die angegebene Eigenschaft enthalten, müssen jedoch einer einheitlichen Struktur entsprechen.

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

Einstellen des Ordners für Cloud-Service-Konfigurationen

Alle Cloud-Service-Konfigurationen in AEM werden im Ordner /conf im AEM-Repository zusammengefasst. 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. Geben Sie im Dialogfeld Konfiguration erstellen einen Titel für den Ordner an 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-Webservice kann mithilfe von Swagger-Spezifikationen im JSON- oder YAML-Format in einer -Definitionsdatei beschrieben werden. Um den RESTful-Webservice in den AEM-Cloud-Services zu konfigurieren, müssen Sie entweder über die Swagger-Datei auf Ihrem Dateisystem verfügen oder über die URL, 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 Sie auf Erstellen, um den Assistenten für das Erstellen von Datenquellkonfigurationen zu öffnen. 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 Dropdown-Liste der Swagger-Quelle aus und geben Sie dementsprechend die URL zur Swagger-Definitionsdatei an oder laden Sie die Swagger-Datei aus Ihrem lokalen Dateisystem hoch.

   • Auf Grundlage der Eingabe der Swagger-Quelle werden folgende Felder mit Werten vorbefüllt:

     • Schema: Die von der REST-API verwendeten Übertragungsprotokolle. Die Anzahl der in der Dropdown-Liste angezeigten Schematypen hängt von den Schemas ab, die in der Swagger-Quelle definiert wurden.

     • Host: Der Domain-Name 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 vorbefüllten Werte für diese Felder.

   • Wählen Sie den Authentifizierungstyp – Ohne, OAuth2.0 (Autorisierungs-Code, Client-Anmeldeinformationen), Standardauthentifizierung, API-Schlüssel, benutzerdefinierte Authentifizierung oder gegenseitige Authentifizierung – für den Zugriff auf den RESTful-Service aus und geben Sie dementsprechend die 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 Anforderungskopfzeile oder als Abfrageparameter gesendet werden. Wählen Sie eine dieser Optionen aus der Dropdown-Liste Speicherort und geben Sie den Namen der Kopfzeile oder des Abfrageparameters im Feld Parametername entsprechend an.

   Wenn Sie Gegenseitige Authentifizierung als Authentifizierungstyp angeben, lesen Sie Zertifikatbasierte gegenseitige Authentifizierung für RESTful- und SOAP-Web-Services.

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

HTTP-Client-Konfiguration des Formulardatenmodells zur Leistungsoptimierung

Das Formulardatenmodell von Experience Manager Forms bei der Integration mit RESTful-Web-Services als Datenquelle umfasst HTTP-Client-Konfigurationen zur Leistungsoptimierung.
Führen Sie die folgenden Schritte aus, um den HTTP-Client des Formulardatenmodells zu konfigurieren:

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

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

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

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

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

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

   • Geben Sie im Feld Verbindungs-Zeitüberschreitung die Dauer an, für die der Experience Manager Forms-Server auf eine Verbindung wartet. Der Standardwert ist 10 Sekunden.

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

SOAP-Webservices konfigurieren

SOAP-basierte Webservices werden mithilfe von WSDL-Spezifikationen (Web Services Description Language) beschrieben. Um den SOAP-basierten Web-dienst 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 Sie auf Erstellen, um den Assistenten für das Erstellen von Datenquellkonfigurationen zu öffnen. 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 (Autorisierungs-Code, Client-Anmeldeinformationen), Standardauthentifizierung, benutzerdefinierte Authentifizierung, X509-Token oder gegenseitige Authentifizierung – für den Zugriff auf den SOAP-Service aus und geben Sie dementsprechend die Details für die Authentifizierung an.

     Wenn Sie X509-Token als Authentifizierungstyp verwenden, konfigurieren Sie das X509-Zertifikat. Weitere Informationen finden Sie unter Einrichten von Zertifikaten.
     Geben Sie im Feld Schlüssel-Alias den KeyStore-Alias für das X509-Zertifikat an. Geben Sie im Feld Gültigkeitsdauer die Zeit in Sekunden an, während der die Authentifizierungsanfrage gültig bleibt. Optional können Sie den Nachrichtentext oder die Kopfzeile des Zeitstempels oder beides signieren.

     Wenn Sie Gegenseitige Authentifizierung als Authentifizierungstyp angeben, lesen Sie Zertifikatbasierte gegenseitige Authentifizierung für RESTful- und SOAP-Web-Services.

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-Services in AEM-Cloud-Services sicher, dass Sie die Dienststamm-URL für den Service haben, und gehen Sie folgendermaßen vor:

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 Sie auf Erstellen, um den Assistenten für das Erstellen von Datenquellkonfigurationen zu öffnen. 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 – Ohne, OAuth2.0 (Autorisierungs-Code, Client-Anmeldeinformationen), Standardauthentifizierung oder benutzerdefinierte Authentifizierung – für den Zugriff auf den OData-Service 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 Cloudkonfiguration für den OData-Dienst zu erstellen.

Zertifikatbasierte gegenseitige Authentifizierung für RESTful- und SOAP-Web-Services

Wenn Sie die gegenseitige Authentifizierung für das Formulardatenmodell aktivieren, authentifizieren sowohl die Datenquelle als auch der AEM-Server, auf dem das Formulardatenmodell ausgeführt wird, die Identität der jeweils anderen Seite, 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 AEM Forms-Server 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 fd-cloudservice-Benutzer 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 Aliasnamen 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. Laden Sie das Vertrauenszertifikat in den Global Trust Store hoch. 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 Zertifikatsdatei auswählen, laden Sie das Zertifikat hoch und tippen Sie auf Senden.
3. Konfigurieren Sie SOAP- oder RESTful-Web-Services als Datenquelle und wählen Sie als Authentifizierungstyp Gegenseitige Authentifizierung. Wenn Sie mehrere selbstsignierte Zertifikate für fd-cloudservice-Benutzer konfigurieren, geben Sie den Schlüsselaliasnamen 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 eine Datenquelle erstellt haben, können Sie es den schon konfigurierten Datenquellen zuordnen. Weitere Informationen finden Sie unter Erstellen eines Formulardatenmodells.