DocumentaciónAEM 6.5Guía del usuario

Marco de trabajo de etiquetado de AEM aem-tagging-framework

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador

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:

  • Consulte el documento Uso de etiquetas para obtener información sobre cómo etiquetar contenido como autor de contenido.
  • Consulte el documento Administración de etiquetas para conocer la perspectiva del administrador sobre la creación y administración de etiquetas y sobre las etiquetas de contenido que se han aplicado.

AEM Este artículo se centra en el marco de trabajo subyacente que admite el etiquetado en los entornos de y en cómo utilizarlo como desarrollador.

Introducción introduction

AEM Para etiquetar contenido y utilizar la infraestructura de etiquetado de:

  • La etiqueta debe existir como un nodo de tipo [cq:Tag](#tags-cq-tag-node-type) bajo el nodo raíz de taxonomía.

  • El nodo de contenido etiquetado NodeType debe incluir el mixin cq:Taggable.

  • TagID se agrega a la propiedad cq:tags del nodo de contenido y se resuelve en un nodo de tipo [cq:Tag](#tags-cq-tag-node-type).

Etiquetas : cq:Tipo de nodo de etiqueta tags-cq-tag-node-type

La declaración de una etiqueta se captura en el repositorio en un nodo de tipo cq:Tag.

Una etiqueta puede ser una palabra simple (por ejemplo, sky) o representar una taxonomía jerárquica (por ejemplo, fruit/apple, es decir, tanto la genérica fruit como la más específica apple).

Las etiquetas se identifican con un TagID único.

Una etiqueta tiene información meta opcional, como un título, títulos localizados y una descripción. El título debe mostrarse en las interfaces de usuario en lugar del 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.

Características de etiquetas tag-characteristics

  • El tipo de nodo es cq:Tagn
  • El nombre de nodo es un componente de TagID.
  • TagID siempre incluye un espacio de nombres.
  • La propiedad jcr:title (el título que se mostrará en la interfaz de usuario) es opcional.
  • La propiedad jcr:description es opcional.
  • Cuando contiene nodos secundarios, la etiqueta se denomina etiqueta contenedora.
  • La etiqueta se almacena en el repositorio bajo una ruta base denominada nodo raíz de taxonomía .

Como las etiquetas son simplemente nodos JCR, los nombres de nodo deben cumplir la convención de nomenclatura JCR.

ID de etiqueta tagid

TagID identifica una ruta que se resuelve en un nodo de etiqueta del repositorio.

Normalmente, TagID es un TagID abreviado que comienza con el área de nombres o puede ser un TagID absoluto que comience desde el nodo raíz de taxonomía.

Cuando se etiqueta contenido, si aún no existe, la propiedad [cq:tags](#tagged-content-cq-tags-property) se agrega al nodo de contenido y TagID se agrega al valor de matriz String de la propiedad.

El TagID consiste en un área de nombres seguido del TagID local. Las 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 TagID local. Por ejemplo, se permite etiquetar contenido con fruit, incluso si es una etiqueta contenedora con subetiquetas, como fruit/apple y fruit/banana.

Nodo raíz de taxonomía taxonomy-root-node

El nodo raíz de taxonomía es la ruta base para todas las etiquetas del repositorio. El nodo raíz de taxonomía no debe ser un nodo de tipo cq:Tag.

AEM En la ruta de acceso base es /content/cq:tags y el nodo raíz es de tipo cq:Folder.

Área de nombres de etiqueta tag-namespace

Las áreas de nombres permiten agrupar cosas. El caso de uso más habitual es un área de nombres por sitio (por ejemplo, público, interno y portal) o por aplicación más grande (por ejemplo, WCM, Assets, Communities). Sin embargo, las áreas de nombres se pueden utilizar para otras necesidades. Los espacios de nombres se utilizan en la interfaz de usuario para mostrar únicamente 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 inmediatamente inferior al nodo raíz de taxonomía. Un área de nombres es un nodo de tipo cq:Tag cuyo primario no es un tipo de nodo cq:Tag.

Todas las etiquetas tienen un área de nombres. Si no se especifica ningún espacio de nombres, la etiqueta se asigna al espacio de nombres predeterminado, que es TagID default con el título Standard Tags, es decir, /content/cq:tags/default.

Etiquetas de contenedor container-tags

Una etiqueta contenedora es un nodo de tipo cq:Tag que contiene cualquier número y tipo de nodos secundarios, lo que permite mejorar el modelo de etiqueta 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, si busca contenido etiquetado con fruit, también encontrará el contenido etiquetado con fruit/apple.

Resolver TagID resolving-tagids

Si TagID contiene dos puntos (:), el signo de dos puntos separa el área de nombres de la etiqueta o subtaxonomía, que se separa aún más con barras diagonales (/). Si TagID no tiene dos puntos, el área de nombres predeterminada es implícita.

La ubicación estándar y única de las etiquetas está por debajo de /content/cq:tags.

Las etiquetas que hacen referencia a rutas de acceso no existentes o que no apuntan a un nodo cq:Tag se consideran no válidas y se omiten.

En la tabla siguiente se muestran algunos ejemplos de TagID, sus elementos y cómo TagID se resuelve en una ruta absoluta en el repositorio:

ID de etiqueta
Espacio de nombres
ID local
Etiquetas 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, el área de nombres
/content/cq:tags/dam
/content/cq:tags/category/car
category
car
car
car
/content/cq:tags/category/car

Localización del título de la etiqueta localization-of-tag-title

Cuando la etiqueta incluye la cadena de título opcional (jcr:title), es posible localizar el título para mostrarlo agregando la propiedad jcr:title.<locale>.

Para obtener más información, consulte los siguientes documentos:

Control de acceso access-control

Las etiquetas existen como nodos en el repositorio bajo el 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.

Además, la denegación de permisos de lectura para determinadas etiquetas o áreas de nombres controla la capacidad de aplicar etiquetas a contenido específico.

Una práctica típica incluye:

  • Permitiendo el acceso de escritura de grupo/función tag-administrators 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.
  • Permite a los usuarios/autores acceder a todas las áreas de nombres que deben poder leerlas (principalmente todas).
  • Permitir que los usuarios o los autores escriban en aquellas áreas de nombres en las que los usuarios o los autores deben poder definir libremente las etiquetas (agregue un nodo en /content/cq:tags/some_namespace)

Contenido etiquetable : cq:Taggable Mixin taggable-content-cq-taggable-mixin

Para que los desarrolladores de aplicaciones adjunten el etiquetado a un tipo de contenido, el registro del nodo (CND) debe incluir el mixin cq:Taggable o el mixin cq:OwnerTaggable.

El mixin cq:OwnerTaggable, 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 usuarios, solo es un atributo del nodo cq:PageContent. El marco de etiquetado no requiere el mixin cq:OwnerTaggable.

NOTE
Se recomienda habilitar solamente etiquetas en el nodo de nivel superior de un elemento de contenido agregado (o en su nodo jcr:content). Algunos ejemplos son:
  • Páginas (cq:Page) donde el nodo jcr:contentes del tipo cq:PageContent, que incluye el mixin cq:Taggable
  • Assets ( cq:Asset) donde el nodo jcr:content/metadata siempre tiene la mezcla cq:Taggable

Notación de tipo de nodo (CND) node-type-notation-cnd

Las definiciones de tipo de nodo existen en el repositorio como archivos CDN. La notación CDN se define como parte de la documentación JCR aquí.

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

Contenido etiquetado: cq:tags (propiedad) tagged-content-cq-tags-property

La propiedad cq:tags es una matriz String que se usa para almacenar uno o más TagID 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 el mixin [cq:Taggable](#taggable-content-cq-taggable-mixin).

NOTE
AEM Para utilizar la funcionalidad de etiquetado de la etiqueta, las aplicaciones desarrolladas personalizadas no deben definir propiedades de etiqueta distintas de cq:tags.

Mover y combinar etiquetas moving-and-merging-tags

A continuación se describen los efectos que se producen en el repositorio al mover o combinar etiquetas mediante la consola de etiquetado:

  • Cuando una etiqueta A se mueve o se combina con la etiqueta B en /content/cq:tags:

    • La etiqueta A no se ha eliminado y obtiene la propiedad cq:movedTo.
    • La etiqueta B se crea (si se ha producido un movimiento) y obtiene una propiedad cq:backlinks.

  • cq:movedTo señala 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 actualiza 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 la propiedad cq:movedTo es nirvana. Se aplica cuando se elimina la etiqueta, pero no se puede eliminar del repositorio porque hay subetiquetas con un cq:movedTo que deben conservarse.

    note note
    NOTE
    La propiedad cq:movedTo solo se agrega a la etiqueta movida o combinada si se cumple cualquiera de estas condiciones:
    1. La etiqueta se utiliza en el contenido (lo que significa que tiene una referencia) o
    2. La etiqueta tiene elementos secundarios que ya se han movido.

  • cq:backlinks mantiene las referencias en la otra dirección. Es decir, mantiene una lista de todas las etiquetas que se han movido o combinado con la etiqueta B. Esto es necesario principalmente para mantener las propiedades de cq:movedTo 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.

    note note
    NOTE
    La propiedad cq:backlinks solo se agrega a la etiqueta movida o combinada si se cumple cualquiera de estas condiciones:
    1. La etiqueta se utiliza en el contenido (lo que significa que tiene una referencia) O
    2. La etiqueta tiene elementos secundarios que ya se han movido.

  • La lectura de una propiedad cq:tags de un nodo de contenido implica la siguiente resolución:

    1. Si no hay ninguna coincidencia en /content/cq:tags, no se devuelve ninguna etiqueta.

    2. Si la etiqueta tiene una propiedad cq:movedTo establecida, se sigue el identificador de etiqueta al que se hace referencia.

      • Este paso se repite siempre que la etiqueta seguida tenga la propiedad cq:movedTo.

    3. Si la etiqueta seguida no tiene una propiedad cq:movedTo, se leerá la etiqueta.

  • Para publicar el cambio cuando se haya movido o combinado una etiqueta, se debe replicar el nodo cq:Tag y todos sus backlinks. Esto se realiza automáticamente cuando la etiqueta se activa en la consola de administración de etiquetas.

  • Las actualizaciones posteriores en la propiedad cq:tags de la página limpian 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.

NOTE
El movimiento de etiquetas es diferente de la migración de etiquetas.

Migración de etiquetas tags-migration

Desde Adobe Experience Manager 6.4, las etiquetas se almacenan en /content/cq:tags, mientras que las versiones anteriores almacenaban etiquetas en /etc/tags.

AEM Siempre que se actualice un sistema de desde una versión anterior a la 6.4, las etiquetas deben migrarse a /content/cq:tags. AEM Consulte Reestructuración común de repositorios en la versión 6.5 de para obtener más información.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2