Einbinden von Tagging in eine AEM-Anwendung building-tagging-into-an-aem-application

Für das programmatische Arbeiten mit Tags oder das Erweitern von Tags in einem benutzerdefinierten AEM-Programm wird in diesem Dokument die Verwendung der

die mit dem

Weitere Informationen zum Tagging finden Sie unter:

Übersicht über die Tagging-API overview-of-the-tagging-api

Die Implementierung des Tagging-Frameworks in AEM ermöglicht die Verwaltung von Tags und Tag-Inhalten mithilfe der JCR-API. Der TagManager stellt sicher, dass Tags, die als Werte in der Zeichenfolgen-Array-Eigenschaft cq:tags eingegeben wurden, nicht dupliziert werden. Er entfernt TagIDs, die auf nicht vorhandene Tags verweisen, und aktualisiert TagIDs für verschobene oder zusammengefügte Tags. TagManager verwendet einen JCR Observation Listener, der alle falschen Änderungen zurücksetzt. Die wichtigsten Klassen befinden sich im Paket com.day.cq.tagging:

Abrufen eines JCR-basierten TagManagers getting-a-jcr-based-tagmanager

Um eine TagManager-Instanz abzurufen, benötigen Sie eine JCR-Session, und Sie müssen getTagManager(Session) aufrufen:

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

Im typischen Sling-Kontext können Sie sich auch mit dem ResourceResolver an einen TagManager anpassen:

TagManager tagManager = resourceResolver.adaptTo(TagManager.class);

Abrufen eines Tag-Objekts retrieving-a-tag-object

Ein Tag kann über den TagManager abgerufen werden, indem entweder ein vorhandenes Tag aufgelöst oder eines erstellt wird:

Tag tag = tagManager.resolve("my/tag"); // for existing tags

Tag tag = tagManager.createTag("my/tag"); // for new tags

Für die JCR-basierte Implementierung, die Tags auf JCR-Nodes abbildet, können Sie den Mechanismus adaptTo von Sling direkt verwenden, wenn Sie die Ressource haben (z. B. /content/cq:tags/default/my/tag):

Tag tag = resource.adaptTo(Tag.class);

Während ein Tag nur „von“ einer Ressource (kein Knoten) konvertiert werden kann, kann ein Tag sowohl in einen Knoten als auch in eine Ressource konvertiert werden :

Node node = tag.adaptTo(Node.class);
Resource node = tag.adaptTo(Resource.class);

Abrufen und Festlegen von Tags getting-and-setting-tags

// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);

// Setting tags to a Resource:
tagManager.setTags(resource, tags);

Suchen nach Tags searching-for-tags

// Searching for the Resource objects that are tagged with the tag object:
Iterator<Resource> it = tag.find();

// Retrieving the usage count of the tag object:
long count = tag.getCount();

// Searching for the Resource objects that are tagged with the tagID String:
 RangeIterator<Resource> it = tagManager.find(tagID);

Löschen von Tags deleting-tags

tagManager.deleteTag(tag);

Replizieren von Tags replicating-tags

Es ist möglich, den Replikations-Service (Replicator) mit Tags zu verwenden, da Tags vom Typ nt:hierarchyNode sind:

replicator.replicate(session, replicationActionType, tagPath);

Tagging auf der Client-Seite tagging-on-the-client-side

Das Formular-Widget CQ.tagging.TagInputField dient zur Eingabe von Tags. Es beinhaltet ein Popup-Menü für die Auswahl vorhandener Tags, einschließlich Autovervollständigen und vieler anderer Funktionen. Sein xtype ist tags.

Der Tag Garbage Collector the-tag-garbage-collector

Der Tag Garbage Collector ist ein Hintergrund-Service, der die ausgeblendeten und nicht verwendeten Tags bereinigt. Ausgeblendete und nicht verwendete Tags sind Tags unter /content/cq:tags, die eine Eigenschaft cq:movedTo haben und nicht auf einem Inhaltsknoten verwendet werden, d. h. ihre Anzahl beträgt null. Durch Verwenden dieses Lazy-Deletion-Prozesses muss der Inhaltsknoten (d. h. die Eigenschaft cq:tags) nicht als Teil des Verschiebungs- oder des Zusammenführungsvorgangs aktualisiert werden. Die Verweise in der Eigenschaft cq:tags werden automatisch aktualisiert, wenn die Eigenschaft cq:tags aktualisiert wird, z. B. durch das Seiteneigenschaften-Dialogfeld.

Der Garbage Collector für Tags wird standardmäßig einmal täglich ausgeführt. Sie können ihn hier konfigurieren:

http://localhost:4502/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

Tag-Suche und Tag-Auflistung tag-search-and-tag-listing

Die Tag-Suche und die Tag-Auflistung funktionieren folgendermaßen:

Tags in verschiedenen Sprachen tags-in-different-languages

Wie in der Dokumentation zur Verwaltung von Tags im Abschnitt Verwalten von Tags in verschiedenen Sprachen beschrieben, kann ein Tag-title in verschiedenen Sprachen definiert werden. Eine sprachempfindliche Eigenschaft wird dann dem Tag-Knoten hinzugefügt. Diese Eigenschaft weist das Format jcr:title.<locale> auf, beispielsweise jcr:title.fr für die französische Übersetzung. <locale> muss eine ISO-Gebietsschema-Zeichenfolge in Kleinbuchstaben sein und „_“ anstelle von „-“ enthalten, z. B. de_ch.

Wenn das Tag Animals zur Produktseite hinzugefügt wird, wird der Wert stockphotography:animals zur Eigenschaft cq:tags des Knotens „/content/geometrixx/de/products/jcr:content“ hinzugefügt. Die Übersetzung wird vom Tag-Knoten referenziert.

Die Server-seitige API verfügt über lokalisierte title-bezogene Methoden:

In AEM kann die Sprache entweder aus der Seitensprache oder aus der Benutzersprache abgerufen werden:

currentPage und slingRequest sind in einer JSP über das Tag <cq:definedObjects> verfügbar.

Beim Tagging hängt die Lokalisierung vom Kontext ab, da das Tag titles in der Seitensprache, in der Anwendersprache oder in jeder anderen Sprache angezeigt werden kann.

Hinzufügen einer neuen Sprache zum Dialogfeld „Tag bearbeiten“ adding-a-new-language-to-the-edit-tag-dialog

Im folgenden Verfahren wird beschrieben, wie Sie eine Sprache (Finnisch) zum Dialogfeld Tag bearbeiten hinzufügen:

Die neue Sprache (Finnisch) ist jetzt im Tag-Dialogfeld der Seiteneigenschaften und im Dialogfeld Tag bearbeiten verfügbar, wenn Sie ein Tag in der Tagging-Konsole bearbeiten.