Creación del etiquetado en aplicaciones AEM

Para trabajar mediante programación con etiquetas o ampliar etiquetas dentro de una aplicación de AEM personalizada, este documento describe el uso de la variable

• API de etiquetado

que interactúa con el

• Marco de etiquetado

Para información relacionada con el etiquetado:

• Consulte Uso de etiquetas para obtener información sobre el etiquetado de contenido como autor de contenido.
• Consulte Administración de etiquetas para conocer la perspectiva de un administrador sobre la creación y administración de etiquetas, así como sobre las etiquetas de contenido que se han aplicado.

Información general sobre la API de etiquetado

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

• JcrTagManagerFactory : devuelve una implementación de TagManager basada en JCR. Es la implementación de referencia de la API de etiquetado.
• TagManager : permite resolver y crear etiquetas por rutas y nombres.
• Tag - define el objeto tag .

Obtención de un TagManager basado en JCR

Para recuperar una instancia 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 un TagManager desde el ResourceResolver:

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

Recuperación de un objeto Tag

Se puede recuperar un Tag mediante el TagManager resolviendo una etiqueta existente o creando una nueva:

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 a JCR Nodes, puede utilizar directamente el mecanismo adaptTo de Sling si dispone del recurso (por ejemplo, /content/cq:tags/default/my/tag):

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

Aunque una etiqueta solo puede convertirse desde un recurso (no un nodo), una etiqueta puede convertirse a tanto en un nodo como en un recurso:

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

Obtención y configuración de etiquetas

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

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

Búsqueda de 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 tags

tagManager.deleteTag(tag);

Duplicación de etiquetas

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

replicator.replicate(session, replicationActionType, tagPath);

El recolector de residuos de etiquetas

El recolector de residuos de etiquetas es un servicio de fondo que limpia las etiquetas que están ocultas y que no se utilizan. Las etiquetas ocultas y no utilizadas son etiquetas debajo de /content/cq:tags que tienen una propiedad cq:movedTo y que no se utilizan en un nodo de contenido. Tienen un recuento de cero. Al utilizar este proceso de eliminación diferido, el nodo de contenido (es decir, la propiedad cq:tags ) no tiene que actualizarse como parte de la operación de mover o de combinar. Las referencias de 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 la página.

El recolector de residuos de etiquetas se ejecuta de forma predeterminada una vez al día. Esto se puede configurar en:

http://<host>:<port>/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

Búsqueda de etiquetas y Lista de etiquetas

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

• La búsqueda de TagID busca las etiquetas que tienen la propiedad cq:movedTo establecida en TagID y sigue a través de cq:movedTo TagIDs.
• La búsqueda del título de la etiqueta solo busca las etiquetas que no tienen una propiedad cq:movedTo .

Etiquetas en diferentes idiomas

Una etiqueta title se puede definir en diferentes idiomas. A continuación, se agrega una propiedad que distingue entre idiomas al nodo de etiqueta . 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úscula y utilizar guiones bajos (_) en lugar de guiones o guiones (-), por ejemplo: de_ch.

Por ejemplo, cuando la etiqueta Animals se agrega a la página Products, el valor stockphotography:animals se agrega a la propiedad cq:tags del nodo /content/wknd/en/products/jcr:content. Se hace referencia a la traducción desde el nodo tag .

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

• com.day.cq.tagging.Tag
  • getLocalizedTitle(Locale locale)
  • getLocalizedTitlePaths()
  • getLocalizedTitles()
  • getTitle(Locale locale)
  • getTitlePath(Locale locale)
• com.day.cq.tagging.TagManager
  • canCreateTagByTitle(String tagTitlePath, Locale locale)
  • createTagByTitle(String tagTitlePath, Locale locale)
  • resolveByTitle(String tagTitlePath, Locale locale)

En AEM, el idioma se puede obtener desde el idioma de la página o desde el idioma del usuario.

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

El siguiente procedimiento describe cómo añadir un nuevo idioma (por ejemplo, finés) al cuadro de diálogo Tag Edit:

1. En CRXDE, edite la propiedad de varios valores languages del nodo /content/cq:tags.
2. Agregue fi_fi, que representa la configuración regional finlandesa, y guarde los cambios.

El finés ahora está disponible en el cuadro de diálogo etiqueta de las propiedades de página y en el cuadro de diálogo Editar etiqueta al editar una etiqueta en la consola Etiquetado.