El etiquetado permite clasificar y organizar el contenido. Las etiquetas se pueden clasificar por un área de nombres y una taxonomía. Para obtener información detallada sobre el uso de etiquetas:
AEM Este artículo se centra en el marco de trabajo subyacente que admite el etiquetado en los grupos de trabajo y en cómo aprovecharlo como desarrollador.
AEM Para etiquetar contenido y aprovechar la infraestructura de etiquetado de la:
cq:Tag
en el nodo raíz de taxonomía.NodeType
debe incluir el cq:Taggable
mixin.TagID
se añade al nodo de contenido cq:tags
y se resuelve en un nodo de tipo cq:Tag
.La declaración de una etiqueta se captura en el repositorio en un nodo de tipo cq:Tag.
sky
) o representan una taxonomía jerárquica (por ejemplo, fruit/apple
, es decir, tanto la fruta genérica como la manzana más específica).TagID
.TagID
, cuando esté presente.El marco de etiquetado también permite restringir la capacidad de los autores y visitantes del sitio para utilizar solo etiquetas específicas predefinidas.
cq:Tag
.TagID
.TagID
siempre incluye un namespace.jcr:title
(el Título que se mostrará en la interfaz de usuario) es opcional.jcr:description
La propiedad es opcional.A TagID
identifica una ruta que se resuelve en un nodo de etiqueta del repositorio.
Normalmente, la variable TagID
es una abreviatura TagID
empezando por el área de nombres o puede ser un valor absoluto TagID
a partir de nodo raíz de taxonomía.
Cuando se etiqueta contenido, si aún no existe, la variable cq:tags
se agrega al nodo de contenido y la propiedad TagID
se añade a la propiedad de String
valor de matriz.
El TagID
consiste en un namespace seguido del local TagID
. Etiquetas de contenedor tienen subetiquetas que representan un orden jerárquico en la taxonomía. Las subetiquetas se pueden utilizar para hacer referencia a las etiquetas del mismo modo que cualquier etiqueta local TagID
. Por ejemplo, al etiquetar contenido con fruit
se permite, incluso si es una etiqueta contenedora con etiquetas secundarias, como fruit/apple
y fruit/banana
.
El nodo raíz de taxonomía es la ruta base para todas las etiquetas del repositorio. El nodo raíz de taxonomía debe no ser un nodo de tipo cq:Tag
.
AEM En el caso de los usuarios, la ruta base es /content/cq:tags
y el nodo raíz es del tipo cq:Folder
.
Las áreas de nombres permiten agrupar cosas. El caso de uso más típico es tener un área de nombres por sitio (por ejemplo, pública frente a interna) o por aplicación más grande (por ejemplo, Sites o Assets), pero las áreas de nombres se pueden utilizar para otras necesidades. Los espacios de nombres se utilizan en la interfaz de usuario de para mostrar solo el subconjunto de etiquetas (es decir, las etiquetas de un determinado espacio de nombres) que se aplica al contenido actual.
El área de nombres de la etiqueta es el primer nivel del subárbol de taxonomía, que es el nodo situado inmediatamente debajo de nodo raíz de taxonomía. Un área de nombres es un nodo de tipo cq:Tag
cuyo elemento principal no es un cq:Tag
tipo de nodo.
Todas las etiquetas tienen un área de nombres. Si no se especifica ningún área de nombres, la etiqueta se asigna al área de nombres predeterminada, que es TagID
default
, es decir:. /content/cq:tags/default
. El título predeterminado es Standard Tags
en tales casos.
Una etiqueta contenedora es un nodo de tipo cq:Tag
que contenga cualquier número y tipo de nodos secundarios, lo que permite mejorar el modelo de etiquetas con metadatos personalizados.
Además, las etiquetas de contenedor (o superetiquetas) en una taxonomía sirven como subsuma de todas las subetiquetas: por ejemplo, el contenido etiquetado con fruit/apple
se considera etiquetado con fruit
también, es decir, buscar contenido que acaba de etiquetarse con fruit
también encontraría el contenido etiquetado con fruit/apple
.
Si el ID de etiqueta contiene dos puntos (:
), los dos puntos separan el área de nombres de la etiqueta o subtaxonomía, que luego se separan con barras diagonales normales (/
). Si el ID de etiqueta no tiene dos puntos, el área de nombres predeterminada es implícita.
A continuación, se muestra la ubicación estándar y exclusiva de las etiquetas /content/cq:tags
.
Etiquetas que hacen referencia a rutas no existentes o que no apuntan a una ruta cq:Tag
Los nodos de se consideran no válidos y se ignoran.
La siguiente tabla muestra algunos ejemplos TagID
s, sus elementos y cómo TagID
se resuelve en una ruta absoluta en el repositorio:
TagID |
Espacio de nombres | ID local | Etiqueta(s) de contenedor | Etiqueta de hoja | Ruta de etiqueta absoluta del repositorio |
---|---|---|---|---|---|
dam:fruit/apple/braeburn |
dam |
fruit/apple/braeburn |
fruit ,apple |
braeburn |
content/cq:tags/dam/fruit/apple/braeburn |
color/red |
default |
color/red |
color |
red |
/content/cq:tags/default/color/red |
sky |
default |
sky |
(ninguno) | sky |
/content/cq:tags/default/sky |
dam: |
dam |
(ninguno) | (ninguno) | (ninguno) | /content/cq:tags/dam |
content/cq:tags/category/car |
category |
car |
car |
car |
content/cq:tags/category/car |
Cuando la etiqueta incluye la cadena de título opcional jcr:title
, es posible localizar el título para mostrarlo añadiendo la propiedad jcr:title.<locale>
.
Para obtener más información, consulte:
Las etiquetas existen como nodos en el repositorio en la variable nodo raíz de taxonomía. Permitir o denegar a los autores y visitantes del sitio la creación de etiquetas en un área de nombres determinada se puede lograr estableciendo ACL adecuados en el repositorio.
La denegación de permisos de lectura para determinadas etiquetas o áreas de nombres controlará la capacidad de aplicar etiquetas a contenido específico.
Una práctica típica incluye:
tag-administrators
acceso de escritura de grupo/función a todas las áreas de nombres (agregar/modificar en /content/cq:tags
). AEM Este grupo incluye a los usuarios que ya están preparados para su uso en el momento de la compra.add_node
bajo /content/cq:tags/some_namespace
)Para que los desarrolladores de aplicaciones adjunten el etiquetado a un tipo de contenido, el registro del nodo (CND) debe incluir el cq:Taggable
mixin o el cq:OwnerTaggable
mixin.
El cq:OwnerTaggable
mixin, que hereda de cq:Taggable
, tiene la intención de indicar que el propietario/autor puede clasificar el contenido. AEM En el caso de los informes, solo es un atributo de la variable cq:PageContent
nodo. El cq:OwnerTaggable
El marco de etiquetado no requiere el mixin.
Se recomienda habilitar solo las etiquetas en el nodo de nivel superior de un elemento de contenido agregado (o en su jcr:content
node). Algunos ejemplos son:
cq:Page
) donde la variable jcr:content
el nodo es del tipo cq:PageContent
, que incluye el cq:Taggable
mixin.cq:Asset
) donde la variable jcr:content/metadata
El nodo siempre tiene el cq:Taggable
mixin.Las definiciones del tipo de nodo existen en el repositorio como archivos CDN. La notación CDN se define como parte de la variable Documentación de JCR..
AEM Las definiciones esenciales para los tipos de nodo incluidos en la lista de nombres de dominio son las siguientes:
[cq:Tag] > mix:title, nt:base
orderable
- * (undefined) multiple
- * (undefined)
+ * (nt:base) = cq:Tag version
[cq:Taggable]
mixin
- cq:tags (string) multiple
[cq:OwnerTaggable] > cq:Taggable
mixin
El cq:tags
La propiedad es un String
matriz utilizada para almacenar uno o más TagID
Es cuando los autores o visitantes del sitio los aplican al contenido. La propiedad solo tiene significado cuando se agrega a un nodo que se define con la variable cq:Taggable
mixin.
AEM Para aprovechar la funcionalidad de etiquetado de etiquetas, las aplicaciones desarrolladas personalizadas no deben definir propiedades de etiquetas distintas de cq:tags
.
A continuación se describen los efectos que se producen en el repositorio al mover o combinar etiquetas mediante la consola Etiquetado.
Cuando la etiqueta A se mueva o combine en la etiqueta B en /content/cq:tags
:
La etiqueta A no se elimina y recibe un cq:movedTo
propiedad.
cq:movedTo
apunta a la etiqueta B.
Esta propiedad significa que la etiqueta A se ha movido o combinado en la etiqueta B.
Al mover la etiqueta B, se actualizará esta propiedad en consecuencia.
Por lo tanto, la etiqueta A está oculta y solo se mantiene en el repositorio para resolver los ID de etiqueta en los nodos de contenido que apuntan a la etiqueta A.
El recolector de elementos no utilizados de etiquetas elimina las etiquetas como la etiqueta A una vez que los nodos de contenido no las señalan.
Un valor especial para cq:movedTo
la propiedad es nirvana
, que se aplica cuando se elimina la etiqueta, pero no se puede eliminar del repositorio porque hay subetiquetas con un cq:movedTo
eso debe mantenerse.
El cq:movedTo
La propiedad solo se añade a la etiqueta movida o combinada si se cumple cualquiera de estas condiciones:
La etiqueta B se crea (en caso de movimiento) y recibe un cq:backlinks
propiedad.
cq:backlinks
mantiene las referencias en la otra dirección, es decir, conserva una lista de todas las etiquetas que se han movido o combinado con la etiqueta B.
Esto es necesario principalmente para mantener cq:movedTo
propiedades actualizadas cuando la etiqueta B se mueve, combina o elimina, o cuando la etiqueta B está activada, en cuyo caso todas sus etiquetas de backlinks deben activarse también.
El cq:backlinks
La propiedad solo se añade a la etiqueta movida o combinada si se cumple cualquiera de estas condiciones:
Leer un cq:tags
La propiedad de un nodo de contenido implica la siguiente resolución:
/content/cq:tags
, no se devuelve ninguna etiqueta.cq:movedTo
establecida, se sigue el ID de etiqueta al que se hace referencia.
cq:movedTo
propiedad.cq:movedTo
propiedad, se lee la etiqueta.Para publicar el cambio cuando se haya movido o combinado una etiqueta, la variable cq:Tag
nodo y todos sus backlinks deben ser replicados. Esto se realiza automáticamente cuando la etiqueta se activa en la consola de administración de etiquetas.
Actualizaciones posteriores en la página cq:tags
limpie automáticamente las referencias antiguas. Esto se activa porque la resolución de una etiqueta desplazada a través de la API devuelve la etiqueta de destino, proporcionando así el ID de etiqueta de destino.