AEM Creación de etiquetas en una aplicación de building-tagging-into-an-aem-application

AEM Para trabajar mediante programación con etiquetas o ampliar etiquetas dentro de una aplicación personalizada, esta página describe el uso de la variable

Que interactúa con el

Para obtener información relacionada con el etiquetado, consulte:

Información general sobre la API de etiquetado overview-of-the-tagging-api

AEM La implementación del marco de etiquetado en las etiquetas permite la administración de etiquetas y el contenido de etiquetas mediante la API de JCR. TagManager garantiza que las etiquetas introducidas como valores en la propiedad de matriz de cadenas cq:tags no se dupliquen, elimina los TagID que apuntan a etiquetas no existentes y actualiza los TagID para las etiquetas movidas o combinadas. TagManager utiliza un detector de observación JCR que revierte cualquier cambio incorrecto. Las clases principales se encuentran en el paquete com.day.cq.tagging:

Obtener un TagManager basado en JCR getting-a-jcr-based-tagmanager

Para recuperar una instancia de TagManager, debe tener un JCR Session y llamar a getTagManager(Session):

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

En el contexto típico de Sling, también puede adaptarse a TagManager desde ResourceResolver:

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

Recuperación de un objeto Tag retrieving-a-tag-object

Se puede recuperar un(a) Tag a través de TagManager, resolviendo una etiqueta existente o creando una:

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

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

Para la implementación basada en JCR, que asigna Tags al JCR Nodes, puede utilizar directamente el mecanismo adaptTo de Sling si tiene el recurso (por ejemplo, /content/cq:tags/default/my/tag):

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

Aunque una etiqueta solo se puede convertir *de *un recurso (no un nodo), una etiqueta se puede convertir *a *un nodo y un recurso :

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

Obtención y configuración de etiquetas getting-and-setting-tags

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

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

Búsqueda de etiquetas 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);

Eliminación de etiquetas deleting-tags

tagManager.deleteTag(tag);

Duplicación de etiquetas replicating-tags

Es posible utilizar el servicio de replicación (Replicator) con etiquetas porque las etiquetas son del tipo nt:hierarchyNode:

replicator.replicate(session, replicationActionType, tagPath);

Etiquetado en el lado del cliente tagging-on-the-client-side

El widget de formulario CQ.tagging.TagInputField sirve para escribir etiquetas. Tiene un menú emergente para seleccionar entre las etiquetas existentes, incluye finalización automática y muchas otras funciones. Su xtype es tags.

El recolector de basura de etiquetas the-tag-garbage-collector

El recolector de etiquetas es un servicio en segundo plano que limpia las etiquetas ocultas y no utilizadas. Las etiquetas ocultas y no utilizadas son etiquetas por debajo de /content/cq:tags que tienen una propiedad cq:movedTo y no se utilizan en un nodo de contenido; tienen un recuento de cero. Al utilizar este proceso de eliminación diferida, no es necesario actualizar el nodo de contenido (es decir, la propiedad cq:tags) como parte de la operación de mover o combinar. Las referencias en la propiedad cq:tags se actualizan automáticamente cuando se actualiza la propiedad cq:tags, por ejemplo, a través del cuadro de diálogo de propiedades de página.

El recolector de elementos no utilizados se ejecuta de forma predeterminada una vez al día. Puede configurarlo en:

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

Búsqueda de etiquetas y Listado de etiquetas tag-search-and-tag-listing

La búsqueda de etiquetas y la lista de etiquetas funcionan de la siguiente manera:

Etiquetas en diferentes idiomas tags-in-different-languages

Como se describe en la documentación para la administración de etiquetas, en la sección Administración de etiquetas en diferentes idiomas, una etiqueta titlese puede definir en diferentes idiomas. A continuación, se agrega una propiedad sensible al idioma al nodo de etiquetas. Esta propiedad tiene el formato jcr:title.<locale>, por ejemplo, jcr:title.fr para la traducción al francés. <locale> debe ser una cadena de configuración regional ISO en minúsculas y usar "_" en lugar de "-", por ejemplo: de_ch.

Cuando se agrega la etiqueta Animals a la página Productos, el valor stockphotography:animals se agrega a la propiedad cq:tags del nodo /content/geometrixx/en/products/jcr:content. Se hace referencia a la traducción desde el nodo de etiqueta.

La API del lado del servidor ha localizado title métodos relacionados:

AEM En la práctica, el idioma se puede obtener en el idioma de la página o en el idioma del usuario:

currentPage y slingRequest están disponibles en un JSP a través de la etiqueta <cq:definedObjects>.

Para el etiquetado, la localización depende del contexto, ya que la etiqueta titles se puede mostrar en el idioma de la página, en el idioma del usuario o en cualquier otro idioma.

Adición de un nuevo idioma al cuadro de diálogo Editar etiqueta adding-a-new-language-to-the-edit-tag-dialog

El siguiente procedimiento describe cómo agregar un idioma (finés) al cuadro de diálogo Editar etiqueta:

El nuevo idioma (finés) ya está disponible en el cuadro de diálogo de etiquetas de las propiedades de página y en el cuadro de diálogo Editar etiqueta al editar una etiqueta en la consola Etiquetado.