Verwenden von Daten aus Ihrer Datenquelle

Wählen Sie Datenquellen im linken Bereich aus, 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 Bedienfeld „Datenquellen“ werden die verfügbaren Inhaltsfragment-Generatoren aufgelistet.

Wählen Sie Hinzufügen, um einen neuen Inhaltsausschnitt-Generator hinzuzufügen. Das Bedienfeld Inhaltsfragmentgenerator hinzufügen wird geöffnet.

{width="500"}

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 gemäß Ihren Datenanforderungen.

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.

Wählen Sie im Dropdown-Menü Datenzuordnungsvorlage“ die Vorlage aus, die Ihrer Datenquelle.
Die vordefinierten 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.

Das Ressource-Dropdown 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 stellen Sie eine Verbindung mit ihr her, um ein Inhaltsfragment oder ein Thema mithilfe des Generators dafür zu erstellen.

Wählen Sie Abrufen aus, 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.

1. Die Vorschau zeigt, wie die Daten angezeigt werden, wenn sie in den Inhalt eingefügt werden. Die Vorschau zeigt einen kleinen Bruchteil der Daten im Format der ausgewählten Vorlage an.
   Zum Beispiel:

   • Wenn Sie die SQL-Tabellenvorlage 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.

2. Die Quellansicht zeigt die Daten in der DITA-Quellansicht an.

   {width="500"}

   *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 wählen Sie dann Hinzufügen. Der Liste wird ein neuer Inhaltsausschnitt-Generator hinzugefügt.

Wählen Sie eine Datenquelle aus, um die Inhaltsfragmentgeneratoren und die Themengeneratoren anzuzeigen, die für die ausgewählte Datenquelle verfügbar sind.

{width="300"}

Hinzufügen eines Themengenerators für eine verbundene Datenquelle.

Wählen Sie Hinzufügen und wählen Sie Themengenerator aus der Dropdown-Liste aus, 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 Bedienfelds Themengenerator hinzufügen ein:

Konfiguration abrufen

{width="300"}

Fügen Sie die Datenabfrage, die Datenzuordnungsvorlage und die Stammknotendetails für den Themengenerator hinzu und geben Sie ihm im Bedienfeld Konfiguration abrufen einen eindeutigen Namen.

1. 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 gemäß 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.

2. 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
   Sie sehen die Optionen zum Hochladen oder Durchsuchen von Dateien anstelle einer Datenabfrage, wenn Sie einen Datei-Connector verwenden.

3. Wählen Sie im Dropdown-Menü Datenzuordnungsvorlage“ die Vorlage aus, die Ihrer Datenquelle.

   note note
   NOTE
   Wenn Ihr Administrator benutzerdefinierte Vorlagen konfiguriert hat, werden Ihnen diese Vorlagen auch in der Dropdown-Liste angezeigt (basierend auf den Vorlagenpfadkonfigurationen, die von Ihrem Administrator durchgeführt wurden). Sie können beispielsweise eine Themenvorlage erstellen, die eine sortierte Liste, Tabellen, Absätze oder andere DITA-Elemente enthält.

4. Geben Sie den Stammknoten“. Dies ist der Knoten, auf dem Sie auf Ihre Daten zugreifen möchten. Der Themengenerator erstellt dann jedes Thema auf der im Stammknoten definierten Ebene. Sie können beispielsweise „Probleme“ als Stammknoten in Jira hinzufügen. Wenn eine Abfrage also 13 Probleme zurückgibt, erhalten Sie 13 Themen, ein Thema für jedes Problem.

5. Wählen Sie Abrufen aus, 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 des Themas im Format der ausgewählten Vorlage an. Sie können beispielsweise ein einzelnes Jira-Problem mit allen Feldern anzeigen, die aus der Abfrage resultieren.

6. Geben Sie den Namen des Themengenerators ein.

   note note
   NOTE
   Für den Namen des neuen Themengenerators müssen Sie die Dateibenennungskonvention befolgen. Im Namen des Themengenerators darf kein Leerzeichen stehen. Außerdem können Sie keinen neuen Themengenerator mit dem Namen eines vorhandenen Themengenerators speichern. Ein Fehler tritt auf.

Ausgabekonfiguration

{width="300"}

Geben Sie Details zum Ausgabepfad und zur Themenbenennungskonvention im Bedienfeld „Ausgabekonfiguration“ ein. DITA-Map erstellen und benennen.

1. Geben Sie den Ausgabepfad ein, in dem Sie Ihre Themen speichern möchten.
2. In der Themennamenskonvention können Sie einen Wert oder eine Variable mit Velocity-Tags eingeben. Die neuen Themen folgen dem Konvent. Sie können beispielsweise den $key eingeben, um Themen basierend auf Jira-Schlüsseln zu erstellen.
3. Aktivieren Sie die Zuordnung erstellen, wenn Sie eine Zuordnung erstellen möchten, die alle generierten Themen enthält.
4. Geben Sie den Namen der neuen DITA-Zuordnung ein.

Metadaten

Wählen Sie aus der Dropdown-Liste die Metadateneigenschaften aus, die an die Themen übergeben werden sollen. Name Dropdown-Liste listet sowohl die benutzerdefinierten als auch die Standardeigenschaften auf.

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 Bedienfeld „Metadaten“ hinzu, die an die Themen übergeben werden.

Geben Sie den Namen des Generators ein und wählen Sie Speichern, um die Abfrageergebnisse zu speichern. Der Liste wird ein neuer Themengenerator hinzugefügt.

Wählen Sie Speichern und), um den Themengenerator zu speichern und neue Themen aus dem Themengenerator zu generieren.

Generieren neuer Themen aus einem vorhandenen Themengenerator.

Bearbeiten Sie eine Velocity-Vorlage im Editor.

Fügen Sie ein Tool und seine Funktion im <tool.function> hinzu. Zum Beispiel:

• Verwenden Sie $mathTool.random, um mit dem mathematischen Tool eine zufällige Zahl zu generieren.
• Um die Summe der Zahlen mithilfe des mathematischen Tools zu erzeugen, verwenden Sie $mathTool.add(num1, num2).

Verwenden Sie die Vorlage, um ein Inhaltsfragment oder 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.