Para trabajar mediante programación con etiquetas o ampliar etiquetas dentro de una aplicación de AEM personalizada, esta página describe el uso de la variable
que interactúa con el
Para obtener información relacionada con el etiquetado, consulte :
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 de matriz de cadenas cq:tags
no se dupliquen, elimina los TagID que apuntan a etiquetas no existentes y actualiza los TagID para etiquetas movidas o combinadas. TagManager utiliza un detector de observación JCR que revierte los cambios incorrectos. Las clases principales están en el paquete com.day.cq.tagging:
TagManager
. 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.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 Sling típico también puede adaptarse a un TagManager
desde el ResourceResolver
:
TagManager tagManager = resourceResolver.adaptTo(TagManager.class);
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 tiene el recurso (por ejemplo, /content/cq:tags/default/my/tag
):
Tag tag = resource.adaptTo(Tag.class);
Aunque una etiqueta solo se puede convertir *desde *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);
No es posible la adaptación directa de Node
a Tag
, ya que Node
no implementa el método Sling Adaptable.adaptTo(Class)
.
// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);
// Setting tags to a Resource:
tagManager.setTags(resource, 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);
El RangeIterator
válido para usar es:
com.day.cq.commons.RangeIterator
tagManager.deleteTag(tag);
Es posible utilizar el servicio de replicación ( Replicator
) con etiquetas porque las etiquetas son de tipo nt:hierarchyNode
:
replicator.replicate(session, replicationActionType, tagPath);
CQ.tagging.TagInputField
es un widget de formulario para introducir etiquetas. Tiene un menú emergente para seleccionar etiquetas existentes, incluye la finalización automática y muchas otras funciones. Su xtype es tags
.
El recolector de elementos no utilizados de etiquetas es un servicio de fondo que limpia las etiquetas que están ocultas y no se usan. Las etiquetas ocultas y no utilizadas son etiquetas inferiores a /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 diferido, el nodo de contenido (es decir, la propiedad cq:tags
) no tiene que actualizarse como parte de la operación de mover o 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 página.
El recolector de elementos no utilizados de etiquetas se ejecuta de forma predeterminada una vez al día. Puede configurarse en:
http://localhost:4502/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector
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
configurada en TagID y sigue los cq:movedTo
TagIDs.
La búsqueda de título de etiqueta solo busca las etiquetas que no tienen una propiedad cq:movedTo
.
Como se describe en la documentación para la administración de etiquetas, en la sección Administración de etiquetas en diferentes idiomas, se puede definir una etiqueta title
en diferentes idiomas. A continuación, se agrega una propiedad que distingue entre lenguajes 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úscula y utilizar "_" en lugar de "-", por ejemplo: de_ch
.
Cuando se agrega la etiqueta Animals a la página Products, 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 los métodos relacionados con title
:
En AEM, el idioma se puede obtener desde el idioma de la página o desde el idioma del usuario:
para recuperar el idioma de la página en un JSP:
currentPage.getLanguage(false)
para recuperar el idioma del usuario en un JSP:
slingRequest.getLocale()
currentPage
y slingRequest
están disponibles en un JSP a través de la <cq:definedobjects> etiqueta .
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.
El siguiente procedimiento describe cómo agregar un nuevo idioma (finés) al cuadro de diálogo Editar etiqueta:
En CRXDE, edite la propiedad de varios valores languages
del nodo /content/cq:tags
.
Añada fi_fi
, que representa la configuración regional finlandesa, y guarde los cambios.
El nuevo idioma (finés) ahora 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.
El nuevo idioma debe ser uno de los idiomas AEM reconocidos, es decir, debe estar disponible como nodo por debajo de /libs/wcm/core/resources/languages
.