Eine Datenquelle ist ein System, in dem Sie die Daten für Ihr Unternehmen speichern und verwalten. Dies sind Ihre Datensatzsysteme wie JIRA, SQL-Datenbanken, PIM oder PLM. AEM Guides bietet die Möglichkeit, eine Verbindung mit Ihrer Datenquelle herzustellen und die Daten daraus zu verwenden.
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.
Data Sources-Bedienfeld
Wählen Sie im linken Bereich die Option Datenquellen aus, um die verbundenen Datenquellen anzuzeigen. Das Bedienfeld Data Sources wird geöffnet und zeigt alle verbundenen Datenquellen an.
Je nach Einrichtung kann Ihr Administrator einen Datenquellen-Connector konfigurieren:
Wenn Sie die Version von Juli 2023 oder September 2023 verwenden, erfahren Sie im Cloud Service-Installations- und Konfigurationshandbuch, wie Sie einen Datenquellen-Connector konfigurieren 1}.
On-Premise Software
Wenn Sie Version 4.3.1 oder höher verwenden, erfahren Sie im On-Premise-Installations- und Konfigurationshandbuch, wie Sie einen Datenquellen-Connector über die Benutzeroberfläche 🔗 konfigurieren.
Wenn Sie Version 4.3 verwenden, erfahren Sie im On-Premise-Installations- und Konfigurationshandbuch, wie Sie einen Datenquell-Connector 🔗 konfigurieren.
NOTE
Daraufhin werden die Datenquellen angezeigt, für die Ihr Administrator den Connector konfiguriert hat.
Listenansicht oder Kachelansicht anzeigen
Sie können zwischen der Listen- oder der Kachelansicht umschalten, um die verschiedenen Datenquellen in Form einer Liste oder als Kacheln anzuzeigen.
Wählen Sie eine Datenquelle aus, um die Inhaltsfragment-Generatoren und die Themengeneratoren anzuzeigen, die für die ausgewählte Datenquelle verfügbar sind.
Listenansicht
Liste der verbundenen Datenquellen.
Kachelansicht
Zeigen Sie die verbundenen Datenquellen als Kacheln an.
Sie können die Daten aus Datenquellen auf zwei Arten verwenden:
Inhaltsfragment einfügen
Thema erstellen
Inhaltsfragment aus Ihrer Datenquelle einfügen
AEM Guides bietet die Funktion zum Herstellen einer Verbindung mit Ihrer Datenquelle. Sie können Ihre Daten abrufen, in Ihre Themen einfügen und sie bearbeiten. Sie können einfach ein Inhaltsfragment mit dem Inhaltsfragment-Generator erstellen und es in Ihren Themen wiederverwenden.
Führen Sie die folgenden Schritte aus, um ein Inhaltsfragment mit dem Inhaltsfragment-Generator zu erstellen und es in Ihr Thema einzufügen:
Wählen Sie Data Sources aus. im linken Bereich, um die verbundenen Datenquellen anzuzeigen.
Wählen Sie eine Datenquelle aus, um die für die ausgewählte Datenquelle verfügbaren Inhaltsfragment-Generatoren anzuzeigen.
{width="300"}
Im Bereich "Data Sources"werden die verfügbaren Inhaltsfragmentgeneratoren aufgelistet.
Wählen Sie Hinzufügen aus, um einen neuen Inhaltsfragment-Generator hinzuzufügen. Das Bedienfeld Snippet-Generator hinzufügen wird geöffnet.
Geben Sie die Abfrage in das Textfeld Datenabfrage ein. Wählen Sie Beispielabfrage kopieren aus, um eine Datenabfrage schnell zu kopieren. Anstatt die Abfrage manuell zu erstellen, können Sie die Beispielabfrage kopieren und in das Textfeld Datenabfrage einfügen. Bearbeiten Sie dann einfach die Abfrage entsprechend Ihren Datenanforderungen.
note note
NOTE
Experience Manager bietet verschiedene Beispielabfragen für alle Ressourcen in den verschiedenen Datenquellen. Diese werden der Datenquelle zugeordnet, aus der Sie die Daten abrufen.
Wenn Sie einen Datei-Connector verwenden, können Sie die JSON-Datei von Ihrem Computer hochladen oder eine JSON-Datei aus Adobe Experience Manager-Assets durchsuchen.
note note
NOTE
Wenn Sie einen Datei-Connector verwenden, werden Sie die Optionen zum Hochladen oder Durchsuchen von Dateien anstelle einer Datenabfrage anzeigen.
Wählen Sie im Dropdown-Menü Datenzuordnungsvorlage die Vorlage aus, die Ihrer Datenquelle zugeordnet ist. Die nativen Vorlagen für die ausgewählte Datenquelle werden in der Dropdown-Liste angezeigt. Sie können beispielsweise die Vorlage "sql-table"für die Datenquelle "PostgreSQL"anzeigen.
note note
NOTE
Wenn Ihr Administrator benutzerdefinierte Vorlagen konfiguriert hat, werden diese Vorlagen auch in der Dropdown-Liste angezeigt (basierend auf den von Ihrem Administrator durchgeführten Vorlagenpfadkonfigurationen).
Sie können auch Velocity-Tools in den Vorlagen verwenden. Erfahren Sie mehr darüber, wie Sie Velocity-Tools verwenden.
Das Dropdown-Menü Ressource wird für einige Connectoren wie REST Client, Salsify, Akeneo und Microsoft ADO angezeigt. Wählen Sie eine Ressource aus dem Dropdown-Menü aus und verbinden Sie sie, um einen Inhaltsausschnitt oder ein Thema mit dem Generator dafür zu erstellen.
note note
NOTE
Ihr Administrator kann beim Konfigurieren der Datenquellen-Connectoren Standardressourcen konfigurieren oder Ressourcen für mehrere URLs hinzufügen.
Klicken Sie auf Fetch , um die Daten aus der Datenquelle abzurufen und die Vorlage auf die Daten anzuwenden, die aus der SQL-Abfrage resultieren.
Sie können die Daten in der Vorschau oder in der DITA-Quellansicht anzeigen.
Die Vorschau zeigt an, wie die Daten beim Einfügen in den Inhalt angezeigt werden. Die Vorschau zeigt einen kleinen Teil der Daten im Format der ausgewählten Vorlage an. Zum Beispiel:
Wenn Sie die Vorlage "sql-table"ausgewählt haben, können Sie die SQL-Daten im Tabellenformat anzeigen.
Wenn Sie die Vorlage "jira-ordered-list"ausgewählt haben, können Sie eine geordnete Liste für die Jira-Probleme anzeigen.
Die Quellansicht zeigt die Daten in der DITA-Quellansicht an.
{width="800"} *Fügen Sie einen Inhaltsfragment-Generator hinzu. Zeigen Sie die Daten im Quell- oder Vorschaumodus an.*
Um die Ergebnisse der Abfrage zu speichern, geben Sie den Namen des Generators ein und klicken Sie auf ADD. Der Liste wird ein neuer Inhaltsfragment-Generator hinzugefügt.
note note
NOTE
Sie müssen die Dateibenennungskonvention für den Namen des neuen Inhaltsgenerators befolgen. Im Namen des Inhaltsfragment-Generators darf kein Leerzeichen stehen. Außerdem können Sie keinen neuen Inhaltsgenerator mit dem Namen eines vorhandenen Inhaltsgenerators speichern. Es tritt ein Fehler auf.
Optionen für einen Inhaltsfragment-Generator
Klicken Sie mit der rechten Maustaste auf einen Inhaltsfragment-Generator, um die Optionen zu öffnen. Mithilfe der Optionen können Sie die folgenden Vorgänge ausführen:
Vorschau: Mit dieser Option können Sie einen Bereich öffnen und einen kleinen Teil der Anzeige der Daten in der Ausgabe anzeigen.
Einfügen: Mit dieser Option können Sie das ausgewählte Inhaltsfragment in das Thema einfügen, das im Web Editor zur Bearbeitung geöffnet wurde. Da die Daten als Snippet eingefügt werden, können Sie die Daten in Ihrem Thema auch im Web Editor bearbeiten.
note note
NOTE
Die Option "Einfügen"wird nur angezeigt, wenn Sie ein Thema bearbeiten.
Bearbeiten: Mit dieser Option können Sie Änderungen am Inhaltsfragment-Generator vornehmen und speichern.
Löschen: Mit dieser Option können Sie den ausgewählten Inhaltsfragment-Generator löschen.
Duplizieren: Verwenden Sie diese Option, um ein Duplikat oder eine Kopie des ausgewählten Inhaltsfragment-Generators zu erstellen. Das Duplikat wird standardmäßig mit einem Suffix (wie generator_1) erstellt.
Abfrageausschnitt einfügen
Sie können auch den Ausdruck Query Snippet einfügen verwenden aus der Hauptsymbolleiste, um das Datenfragment in die Themen einzufügen. Sie können einen Generator aus der Dropdown-Liste auswählen, Ihre Abfrage bearbeiten oder die Vorlage ändern und die Daten in Ihr Thema einfügen.
Bearbeiten und fügen Sie einen Datenausschnitt ein.
Erstellen eines Themas mit dem Themengenerator
Mit einem Themengenerator können Sie Themen erstellen, die Daten aus Ihren Quellen enthalten. Sie können schnell einen Themengenerator erstellen und dann die Themen mithilfe des Generators generieren. Jedes Thema kann Daten in verschiedenen Formaten wie Tabellen, Listen und Absätzen enthalten. In einem Thema können Sie beispielsweise eine Tabelle mit Details zu allen neuen Produkten und eine Liste aller Produkte hinzufügen, die nicht mehr zum Verkauf angeboten werden.
Der Themengenerator kann die Themen mit den Daten und eine DITA-Zuordnung für alle Themen erstellen. Sie können diese Themen auch <conref> in Ihrem Inhalt verwenden. Auf diese Weise können Sie Ihre Daten mit der Datenquelle synchronisieren und sie einfach aktualisieren.
Thema erstellen
Führen Sie die folgenden Schritte aus, um ein Thema mit dem Themengenerator zu erstellen:
Wählen Sie eine Datenquelle aus, um die Inhaltsfragment-Generatoren und die Themengeneratoren anzuzeigen, die für die ausgewählte Datenquelle verfügbar sind.
{width="300"}
Fügen Sie einen Themengenerator für eine verbundene Datenquelle hinzu.
Wählen Sie Hinzufügen und dann Themengenerator aus der Dropdown-Liste, um einen neuen Themengenerator hinzuzufügen. Das Bedienfeld Themengenerator hinzufügen wird geöffnet.
Geben Sie die Werte in die Felder unter den folgenden drei Registerkarten des Bereichs Themengenerator hinzufügen ein:
Abrufen der Konfiguration
{width="300"}
Fügen Sie die Datenabfrage, die Vorlage für die Datenzuordnung und die Details zum Stammknoten für den Themengenerator hinzu und geben Sie ihm im Bereich "Fetch Configuration"einen eindeutigen Namen.
Geben Sie die Abfrage in das Textfeld Datenabfrage ein. Wählen Sie Beispielabfrage kopieren aus, um eine Datenabfrage schnell zu kopieren. Anstatt die Abfrage manuell zu erstellen, können Sie die Beispielabfrage kopieren und in das Textfeld Datenabfrage einfügen. Bearbeiten Sie dann einfach die Abfrage entsprechend Ihren Datenanforderungen.
note note
NOTE
Experience Manager bietet verschiedene Beispielabfragen für alle Ressourcen in den verschiedenen Datenquellen. Diese werden der Datenquelle zugeordnet, aus der Sie die Daten abrufen.
Wenn Sie einen Datei-Connector verwenden, können Sie die JSON-Datei von Ihrem Computer hochladen oder eine JSON-Datei aus Adobe Experience Manager-Assets durchsuchen.
note note
NOTE
Wenn Sie einen Datei-Connector verwenden, werden Sie die Optionen zum Hochladen oder Durchsuchen von Dateien anstelle einer Datenabfrage anzeigen.
Wählen Sie im Dropdown-Menü Datenzuordnungsvorlage die Vorlage aus, die Ihrer Datenquelle zugeordnet ist.
note note
NOTE
Wenn Ihr Administrator benutzerdefinierte Vorlagen konfiguriert hat, werden diese Vorlagen auch in der Dropdown-Liste angezeigt (basierend auf den von Ihrem Administrator durchgeführten Vorlagenpfadkonfigurationen). Sie können beispielsweise eine Themenvorlage erstellen, die eine geordnete Liste, Tabellen, Absätze oder andere DITA-Elemente enthält.
Geben Sie den Stammknoten ein. Dies ist der Knoten, unter dem Sie auf Ihre Daten zugreifen möchten. Der Themengenerator erstellt dann jedes Thema auf der im Stammknoten definierten Ebene. Sie können beispielsweise "issues"als Stammknoten in Jira hinzufügen. Wenn also eine Abfrage 13 Probleme zurückgibt, erhalten Sie 13 Themen, ein Thema für jedes Problem.
Klicken Sie auf Fetch , um die Daten aus der Datenquelle abzurufen und die Vorlage auf die Daten anzuwenden, die aus der SQL-Abfrage resultieren. Die Vorschau zeigt einen kleinen Bruchteil der Darstellung des Themas im Format der ausgewählten Vorlage. Beispielsweise können Sie ein einzelnes Jira-Problem mit allen Feldern anzeigen, die aus der Abfrage resultieren.
Geben Sie den Namen des Thema-Generators ein.
note note
NOTE
Sie müssen die Dateibenennungskonvention für den Namen des neuen Themengenerators befolgen. Im Namen des Thema-Generators darf kein Leerzeichen stehen. Außerdem können Sie keinen neuen Themengenerator mit dem Namen eines vorhandenen Themengenerators speichern. Es tritt ein Fehler auf.
Ausgabekonfiguration
{width="300"}
Geben Sie im Bereich "Ausgabekonfiguration"die Details zum Ausgabepfad und zur Themenbenennungskonvention ein. Generieren Sie eine DITA-Zuordnung und benennen Sie sie.
Geben Sie die Details für den Ausgabepfad ein, in dem Sie Ihre Themen speichern möchten.
In der Themenbenennungsregel können Sie einen Wert oder eine Variable mit Velocity-Tags eingeben. Die neuen Themen folgen dem Konvent. Sie können beispielsweise den Wert $key eingeben, um Themen basierend auf Jira-Schlüsseln zu erstellen.
Aktivieren Sie die Option Erstellen einer Zuordnung , wenn Sie eine Zuordnung erstellen möchten, die alle generierten Themen enthält.
Geben Sie den Namen der neuen DITA-Zuordnung ein.
note note
NOTE
Der Themengenerator generiert die DITA-Zuordnung auf demselben Ausgabepfad wie die Themen.
Metadaten
Wählen Sie die Metadateneigenschaften aus der Dropdown-Liste aus, um sie an die Themen zu übergeben. In der Dropdown-Liste Name werden sowohl die benutzerdefinierten als auch die Standardeigenschaften aufgelistet.
Im folgenden Screenshot sind beispielsweise dc:description, dc:language, dc:title und docstate die Standardeigenschaften, für die Sie die Werte definieren können. Sie können eine benutzerdefinierte Eigenschaft wie "author"erstellen und ihren Wert definieren.
{width="300"}
Fügen Sie die Metadateneigenschaften im Metadatenbedienfeld hinzu, um sie an die Themen zu übergeben.
Geben Sie den Namen des Generators ein und klicken Sie auf Speichern , um die Abfrageergebnisse zu speichern. Der Liste wird ein neuer Themengenerator hinzugefügt.
Klicken Sie auf Speichern und generieren , um den Themengenerator zu speichern und neue Themen aus dem Themengenerator zu generieren.
{width="650"}
Generieren Sie neue Themen aus einem vorhandenen Themengenerator.
note note
NOTE
Wenn die Themen bereits vorhanden sind, aktualisiert der Generator die Daten in den vorhandenen Themen.
Optionen für einen Themengenerator
Klicken Sie mit der rechten Maustaste auf einen Themengenerator, um die Optionen zu öffnen. Mithilfe der Optionen können Sie die folgenden Vorgänge ausführen:
Erzeugen: Mit dieser Option werden die Themen für den ausgewählten Themengenerator generiert. Sie können diese Option auch verwenden, um die vorhandenen Themen zu aktualisieren. Es stellt eine Verbindung zur Datenquelle her und ruft die aktualisierten Daten ab. Beim Generieren des Inhalts ist diese Option deaktiviert und Sie sehen einen Lader.
note note
NOTE
Wenn Ihr Thema bereits vorhanden ist, können Sie die Daten im Thema überschreiben oder als neue Version speichern.
Erstellen Sie ein Thema. Wenn die Datei bereits vorhanden ist, speichern Sie es als neue Version oder überschreiben Sie es.
Protokoll anzeigen: Wählen Sie diese Option, um die Protokolldatei zur Inhaltserstellung anzuzeigen. Die Protokolldatei wird in einer neuen Registerkarte geöffnet. Sie können die Fehler, Warnungen, Informationsmeldungen und Ausnahmen in der Protokolldatei anzeigen. Diese Option ist aktiviert, wenn Sie den Inhalt für den ausgewählten Themengenerator generiert haben.
Vorschau: Mit dieser Option können Sie einen Bereich öffnen und einen kleinen Teil der Anzeige der Daten in der Ausgabe anzeigen.
Bearbeiten: Mit dieser Option können Sie den Themengenerator ändern und speichern. Diese Option ist während der Inhaltserstellung deaktiviert.
Löschen: Mit dieser Option löschen Sie den ausgewählten Themengenerator. Diese Option ist während der Inhaltserstellung deaktiviert.
Duplizieren: Mit dieser Option wird ein Duplikat oder eine Kopie des ausgewählten Thema-Generators erstellt. Das Duplikat wird standardmäßig mit einem Suffix (wie topic-sample_1) erstellt.
Verwenden von Velocity-Tools in Datenquellenvorlagen use-velocity-tools
Experience Manager-Vorlagen unterstützen auch die Velocity-Tools (Version 2.0). Mit diesen Tools können Sie verschiedene Funktionen auf die Daten anwenden, die Sie aus den Datenquellen abrufen. Erfahren Sie mehr über die Verwendung der Velocity-Tools und die Funktionen, die Sie anwenden können.
Führen Sie die folgenden Schritte aus, um ein Velocity-Tool in einer Vorlage zu verwenden:
Bearbeiten Sie eine Velocity-Vorlage im Web-Editor.
Fügen Sie ein Tool und seine Funktion im Format <tool.function> hinzu. Zum Beispiel:
Verwenden Sie $mathTool.random, um eine zufällige Zahl mit dem Mathematiktool zu generieren.
Verwenden Sie $mathTool.add(num1, num2), um die Summe der Zahlen mit dem mathematischen Tool zu generieren.
Verwenden Sie die Vorlage, um einen Inhaltsausschnitt oder ein Thema zu erstellen.
Nachdem Sie die Vorlage auf die Daten angewendet haben, können Sie die Daten in der Vorschau oder in der DITA-Quellansicht anzeigen.
Sie können die folgenden Tools in den Velocity-Vorlagen verwenden, um verschiedene Funktionen auf die Daten anzuwenden, die Sie aus dem Connector abrufen: -$alternatorTool
