DokumentationAEM GuidesDokumentation zu AEM Guides

Konfigurieren eines Datenquellen-Connectors über die Benutzeroberfläche

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experte
  • Admin

Experience Manager Guides enthält das Tool Data Sources , mit dem Sie native Connectoren für Datenquellen konfigurieren können. Sie können die Connectoren JIRA, SQL (MySQL, PostgreSQL, Microsoft SQL Server, SQLite, MariaDB, H2DB), AdobeCommerce, Elasticsearch und Generic REST Client einrichten.

Neben diesen vordefinierten Connectoren stellt Experience Manager Guides die Connectoren für die Datenquellen Salsify, Akeneo und Microsoft Azure DevOps Boards (ADO) bereit. Sie können diese Open-Source-Connectoren aus dem Maven Central Repository herunterladen und installieren. Die Benutzer können diese Connectoren dann konfigurieren.
Erfahren Sie, wie Sie einen Open-Source-Connector installieren.

Sie können auch über einen Datei-Connector eine Verbindung zu JSON-Datendateien herstellen. Laden Sie die JSON-Datei von Ihrem Computer hoch oder durchsuchen Sie sie über die Adobe Experience Manager-Assets. Erstellen Sie dann mithilfe der Generatoren Inhaltsfragmente oder Themen.

Um einen Connector zu konfigurieren, führen Sie die folgenden Schritte aus:

  1. Wählen Sie oben den Link Adobe Experience Manager aus und wählen Sie "Tools".

  2. Wählen Sie Guides aus der Liste der Tools aus.

  3. Wählen Sie die Kachel Datenquellen aus. Die Seite Data Sources wird angezeigt. Sie können die verbundenen Datenquellen anzeigen.

    Sie können zwischen der Listenansicht oder der Kachelansicht umschalten, um die verschiedenen verbundenen Datenquellen als Liste oder Kacheln anzuzeigen.

    Datenquellen, die auf der Seite "Datenquellen"aufgelistet sind {width="800"}

    Anzeigen oder Erstellen eines Datenquellen-Connectors.

  4. Klicken Sie auf Erstellen.

  5. Wählen Sie die Datenbank aus, für die Sie den Connector erstellen möchten. Beispielsweise der Elasticsearch-Connector.

    note note
    NOTE
    Alle verfügbaren nativen Datenbanken werden aufgelistet.

  6. Klicken Sie auf Weiter.

  7. Geben Sie die Konfigurations- und Verbindungsdetails gemäß der Datenbank ein.

    note tip
    TIP
    • Bewegen Infosymbol {width="25"} in der Nähe des Felds, um weitere Details dazu anzuzeigen.
    • Felder mit * sind obligatorisch. Sie können beispielsweise die folgenden Details für den Elasticsearch-Connector eingeben.
    • Name: Geben Sie den Namen der Datenquelle ein.
    • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp aus der Dropdown-Liste aus. Beispiel: Grundlegende Authentifizierung mit Benutzername und Kennwort
    • Benutzername: Geben Sie Ihren Benutzernamen ein.
    • Kennwort: Geben Sie Ihren Benutzernamen und Ihr Kennwort ein.
    • URL: Fügen Sie die API-URL hinzu.

  8. Wählen Sie die Option Factory-Vorlagen ausschließen aus, um die Factory-Vorlagen von der Verwendung für die Themen- und Snippet-Generierung auszuschließen. Sie werden nicht im Dropdown-Menü Datenzuordnungsvorlage im Dialogfeld Inhaltsfragmentgenerator hinzufügen oder im Dialogfeld Themengenerator hinzufügen angezeigt.

  9. Wählen Sie Verbindung testen aus. Sie können die Schaltfläche Verbindung testen erst anzeigen, nachdem Sie die erforderlichen Details hinzugefügt haben. Zeigen Sie eine Erfolgsmeldung an, wenn die Verbindungsdetails korrekt sind. Andernfalls wird möglicherweise eine Fehlermeldung angezeigt.

  10. Wählen Sie oben Speichern aus, um den Connector zu speichern. Zeigen Sie die Schaltfläche Speichern an, die aktiviert ist, nachdem Sie alle Details ausgefüllt haben und die Verbindung erfolgreich hergestellt wurde.

    Wenn der Connector erfolgreich gespeichert wurde, können Sie die verbundene Datenquelle auf der Seite anzeigen.

Verbindung zu mehreren Ressourcen herstellen

Sie können für einige Connectoren wie generischer REST Client, Salsify, Akeneo und Microsoft Azure DevOps-Pinnwände (ADO) mehrere Ressourcen hinzufügen oder verwenden, die auf unterschiedlichen URLs basieren. Stellen Sie dann eine Verbindung mit ihnen her, um mithilfe der Generatoren Inhaltsfragmente oder Themen zu erstellen.

Führen Sie die folgenden Schritte aus, um eine Ressource zu erstellen:

  1. Wählen Sie Symbol hinzufügen im Abschnitt URL-Ressource aus, um eine Ressource für jede URL hinzuzufügen.

  2. Konfigurieren Sie alle Details im Dialogfeld Ressource hinzufügen .

  3. Klicken Sie auf Hinzufügen.

  4. Sie können das Symbol Bearbeiten bearbeiten oder die Ressource löschen aus der Liste der URL-Ressourcen löschen.

  5. Sie können auch die Standardressourcen verwenden, die für Datenquellen wie Salsify, Akeneo und Microsoft ADO verfügbar sind. Schalten Sie die Optionen für die Ressource aus, die Sie nicht für eine Datenquelle konfigurieren möchten.

Auf diese Weise können Sie schnell Daten aus einer der Ressourcen für eine bestimmte Datenquelle in einem einzelnen Inhaltsfragment oder Thema abrufen.

Installieren eines Open-Source-Connectors install-open-source-connector

Um eine Abhängigkeit im Maven Central Repository auf den Cloud Services zu veröffentlichen, müssen Sie die Abhängigkeit für einen Open-Source-Connector einschließen und einbetten.

  1. Fügen Sie die Abhängigkeit in all/pom.xml in Ihrem Cloud Manager-Git-Projektcode hinzu. Sie können beispielsweise die folgende Abhängigkeit für den Datenquellen-Connector für Microsoft Azure DevOps-Pinnwände hinzufügen.

    code language-none 
    <dependency>
    <groupId>com.adobe.aem.addon.guides</groupId>
    <artifactId>konnect-azure-devops</artifactId>
    <version>1.0.0</version>
    <type>jar</type>
</dependency>

  2. Betten Sie die hinzugefügte Abhängigkeit ein.

    code language-none 
    &quot;
&lt;embedded>
&lt;groupId>com.adobe.aem.addon.guides&lt;/groupId>
&lt;artifactId>konnect-azure-devops&lt;/artifactId>
&lt;type>jar&lt;/type>
&lt;target>/apps/aemdoxonaemcsstageprogram-vendor-packages/content/install&lt;/target>
&lt;/embedded>
&quot;

  3. Führen Sie die Pipeline aus, um die Änderungen auf die Cloud Service anzuwenden.
    Der Connector ist in Ihrer Umgebung installiert.

Für einen Connector verfügbare Funktionen

  • Zwischen der Listenansicht oder der Kachelansicht wechseln, um die verschiedenen verbundenen Datenquellen als Liste oder Kacheln anzuzeigen.
  • Aktivieren Sie das Kontrollkästchen für einen einzelnen Connector. Klicken Sie auf Alle auswählen , um alle Connectoren auszuwählen. Sie können auf "Auswahl aufheben"klicken, wenn alle Connectoren ausgewählt sind.

Funktionen der Datenquellen auf der Seite "Datenquellen"

Bearbeiten, erneutes Verbinden, Duplizieren oder Löschen eines Datenquellen-Connectors.

Sie können die folgenden Funktionen für den Connector auf der Seite Data Sources verwenden:

  • Bearbeiten: Bearbeiten Sie die Konfigurationsdetails für den ausgewählten Connector.

  • Erneute Verbindung herstellen: Verbinden Sie sich erneut mit einem getrennten Connector.

  • Duplizieren: Erstellen Sie einen neuen doppelten Connector mit dem aktuellen Connector als Basis. Der doppelte Connector wird standardmäßig mit einem Suffix (wie connectorname_1) erstellt. Beispiel: sample-elastisches-search_1.
    Wenn der Connector mit demselben Namen vorhanden ist, wird ein Fehler angezeigt.

  • Löschen: Löschen Sie den ausgewählten Connector.

Nachdem Sie die Datenquelle konfiguriert haben, wird der Connector im Web Editor im Bereich Datenquellen aufgelistet. Anschließend können Sie eine Verbindung zur Datenquelle herstellen und ein Inhaltsfragment in Ihre Themen einfügen. Weitere Informationen finden Sie unter Einfügen eines Inhaltsfragments aus Ihrer Datenquelle.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178