Verwalten von Taxonomiedaten managing-taxonomy-data

Erfahren Sie, wie Sie Taxonomiedaten für die Verwendung von Tags mit Ihren AEM mit Edge Delivery Services-Sites verwalten.

Einführung introduction

Tagging ist eine wichtige Funktion, mit der Sie Ihre Seiten organisieren und verwalten können. Mit der Tagging-Konsole in AEM können Sie eine umfangreiche Taxonomie von Tags erstellen, um Ihre Seiten zu organisieren.

Diese Tags sind nicht nur für Sie und Ihre Autorenschaft bei der Organisation Ihrer Inhalte nützlich, sondern möglicherweise auch für Ihre Leserinnen und Leser. Tags und ihre Taxonomie können in Komponenten auf der Seite verwendet werden, um Ihren Leserinnen und Lesern beim Navigieren durch Ihre Inhalte zu helfen.

Der universelle Editor funktioniert nur mit den IDs Ihrer Tags. Durch Erstellung einer Taxonomieseite für Ihre Inhalte stellen Sie die Beschreibungen dieser Tags in allen Sprachen für den universellen Editor bereit, damit diese Informationen beim Rendern von Inhalten verwendet werden können.

Erstellen einer Taxonomieseite creating

Eine Taxonomie wird erstellt wie jede andere Seite in AEM.

  1. Navigieren Sie zur Sites-Konsole.

  2. Wählen Sie den Ort aus, an dem Ihre Taxonomie erstellt werden soll.

  3. Tippen oder klicken Sie auf Erstellen > Seite.

    Seite erstellen

  4. Wählen Sie auf der Registerkarte Vorlage des Assistenten Seite erstellen die Vorlage Taxonomie aus und tippen oder klicken Sie auf Weiter.

    Vorlage „Taxonomie“

  5. Geben Sie auf der Registerkarte Eigenschaften des Assistenten Seite erstellen einen aussagekräftigen Titel für die Seite ein und verwenden Sie im Feld Tags die Tag-Auswahl, um die Tags oder Namespaces auszuwählen, die in Ihre Taxonomie eingeschlossen werden sollen.

    Taxonomieeigenschaften

  6. Tippen oder klicken Sie auf Erstellen.

Die Taxonomieseite wird erstellt. Im Dialogfeld Erfolg können Sie auf das Dialogfeld Fertig tippen oder klicken, um die Nachricht zu schließen, oder auf Öffnen, um die Seite im Seiteneditor bearbeiten.

Notieren Sie sich den Namen der resultierenden Taxonomieseite (er wird noch in den folgenden Schritten gebraucht).

Bearbeiten einer Taxonomieseite editing

Sie beginnen mit der Bearbeitung einer Taxonomieseite wie bei jeder anderen Seite in AEM.

  1. Navigieren Sie zur Sites-Konsole.

  2. Wählen Sie die Taxonomie aus, die bearbeitet werden soll.

  3. Tippen oder klicken Sie in der Aktionsleiste auf Bearbeiten.

  4. Der Seiteneditor wird mit der Taxonomie geöffnet.

    • Die Taxonomieseite ist im Seiteneditor schreibgeschützt.

    Bearbeiten der Taxonomie

  5. Tippen oder klicken Sie in der Symbolleiste auf das Symbol Seiteninformationen und wählen Sie Eigenschaften öffnen aus.

    Eigenschaften öffnen

  6. Im Fenster Seiteneigenschaften können Sie den Namen der Seite und mithilfe der Tag-Auswahl die in Ihrer Taxonomie enthaltenen Tags und Namespaces aktualisieren.

    Bearbeiten der Seiteneigenschaften

  7. Tippen oder klicken Sie auf Speichern und schließen.

Die im Seiteneditor angezeigte Seite ist schreibgeschützt, da der Inhalt der Taxonomie automatisch anhand der ausgewählten Tags und Namespaces generiert wird. Sie dienen als eine Art Filter für die automatische Generierung des Inhalts der Taxonomie. Daher gibt es keinen Grund, die Seite direkt im Editor zu bearbeiten.

AEM aktualisiert den Inhalt der Taxonomieseite automatisch, wenn Sie die zugrunde liegenden Tags und Namespaces aktualisieren. Sie müssen Taxonomie jedoch nachÄnderungen erneut veröffentlichen, um diese Änderungen für Ihre Benutzer verfügbar zu machen.

Aktualisieren von „paths.json“ für die Taxonomieveröffentlichung paths-json

Wie beim Verwalten und Veröffentlichen von Tabellendaten für Ihre Edge Delivery Services-Site müssen Sie Ihre paths.json-Datei Ihres Projekts aktualisieren, um die Veröffentlichung Ihrer Taxonomiedaten zu ermöglichen.

  1. Öffnen Sie den Stamm Ihres Projekts in GitHub.

  2. Tippen oder klicken Sie auf die Datei paths.json, um ihre Details zu öffnen, und dann auf das Symbol Bearbeiten.

    Datei paths.json

  3. Fügen Sie eine Zeile hinzu, um Ihre neue Taxonomie einer .json-Ressource zuzuordnen.

    code language-json
    {
      "mappings": [
       "/content/<site-name>/:/",
       "/content/<site-name>/<taxonomy-page-name>:/<taxonomy-json-name>.json"
      ]
    }
    
    • <taxonomy-page-name> muss mit dem Namen der von erstellten Taxonomieseite.
    • <taxonomy-json-name> kann ein beliebiger gültiger Name sein.
  4. Klicken Sie auf Änderungen bestätigen…, um die Änderungen an main zu speichern.

    • Bestätigen Sie entweder für main oder erstellen Sie eine Abruf-Anforderung gemäß Ihrem Prozess.

Dieser Vorgang muss nur einmal pro Taxonomieseite durchgeführt werden. Danach können Sie Ihre Taxonomie veröffentlichen.

TIP
Weitere Informationen zu Pfadzuordnungen finden Sie im Dokument Pfadzuordnung für Edge Delivery Services.

Veröffentlichen einer Taxonomie publishing

Eine Taxonomie steht dem universellen Editor oder Ihren Benutzenden erst nach deren Veröffentlichung zur Verfügung.

Taxonomieseiten werden wie jede andere Seite veröffentlicht, indem die Symbole Quick Publish oder Veröffentlichung verwalten in der Symbolleiste.

Sie müssen Ihre Taxonomieseite jedes Mal erneut veröffentlichen, wenn Sie:

  • die Seite bearbeiten,
  • die in Ihrer Taxonomieseite enthaltenen Tags und Namespaces bearbeiten oder neue hinzufügen.

Wenn Sie eine neue Taxonomieseite erstellen, müssen Sie zunächst eine Zuordnung zur paths.json-Datei in Ihrem Projekt hinzufügen.

Zugreifen auf Taxonomieinformationen accessing

Sobald Ihre Taxonomie veröffentlicht wurde, können ihre Informationen vom universellen Editor genutzt und für Ihre Benutzenden sichtbar gemacht werden.

Sie können auf die Taxonomie als JSON-Daten unter der folgenden Adresse zugreifen:

https://<branch>--<repository>--<owner>.aem.page/<taxonomy-json-name>.json

Verwenden Sie die <taxonomy-json-name>, die Sie beim Zuordnen Ihrer Taxonomie zur paths.json-Datei in Ihrem Projekt“ definiert. Die Taxonomiedaten werden wie im folgenden Beispiel als JSON-Daten zurückgegeben.

{
  "total": 3,
  "offset": 0,
  "limit": 3,
  "data": [
    {
      "tag": "default:",
      "title": "Standard Tags"
    },
    {
      "tag": "do-not-translate",
      "title": "Do Not Translate"
    },
    {
      "tag": "translate",
      "title": "Translate"
    }
  ],
  "columns": [
    "tag",
    "title"
  ],
  ":type": "sheet"
}

Diese JSON-Daten werden automatisch aktualisiert, wenn Sie die Taxonomie aktualisieren und erneut veröffentlichen. Ihre Anwendung kann für Ihre Benutzenden programmgesteuert auf diese Informationen zugreifen.

Wenn Sie Tags in mehreren Sprachen, können Sie auf diese Sprachen zugreifen, indem Sie den ISO2-Sprach-Code als Wert eines sheet= übergeben.

Anzeigen zusätzlicher Tag-Eigenschaften additional-properties

Standardmäßig enthält Ihre Taxonomie tag- und title, wie vorherigen Beispiel. Sie können Ihre Taxonomie so konfigurieren, dass zusätzliche Tag-Eigenschaften verfügbar gemacht werden. In diesem Beispiel stellen wir die Tag-Beschreibung bereit.

  1. Wählen Sie über die Sites-Konsole die von Ihnen erstellte Taxonomie aus.
  2. Tippen oder klicken Sie auf Symbolleiste auf Symbol „Eigenschaften“.
  3. Tippen oder klicken Sie Abschnitt „Zusätzliche Eigenschaften“ auf Hinzufügen um ein Feld hinzuzufügen.
  4. Geben Sie im neuen Feld den JRC-Eigenschaftsnamen ein, der angezeigt werden soll. Geben Sie in diesem Fall jcr:description für die Tag-Beschreibung ein.
  5. Tippen oder klicken Sie auf Speichern und schließen.
  6. Tippen oder klicken Sie bei weiterhin ausgewählter Taxonomie in der Symbolleiste Quick Publish.

Wenn nun auf Ihre Taxonomie zugreifen wird die Tag-Beschreibung (oder die Eigenschaft, die Sie bereitstellen möchten) in die JSON-Datei aufgenommen.

{
  "total": 3,
  "offset": 0,
  "limit": 3,
  "data": [
    {
      "tag": "default:",
      "title": "Standard Tags",
      "jcr:description": "These are the standard tags"
    },
    {
      "tag": "do-not-translate",
      "title": "Do Not Translate",
      "jcr:description": "Tag to mark pages that should not be translated"
    },
    {
      "tag": "translate",
      "title": "Translate",
      "jcr:description": "Tag to mark pages that should be translated"
    }
  ],
  "columns": [
    "tag",
    "title",
    "jcr:description"
  ],
  ":type": "sheet"
}
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab