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

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 entornos de y en cómo utilizarlo como desarrollador.

Introducción introduction

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

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 representan una taxonomía jerárquica (por ejemplo, fruit/apple, es decir, tanto el genérico fruit y los más específicos 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

Dado que las etiquetas son simplemente nodos JCR, los nombres de nodo deben cumplir con las Convenciones 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 por nodo raíz de taxonomía.

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

TagID consta de un namespace seguido del TagID local. 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, al etiquetar contenido con fruit se permite, 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 el caso de los usuarios, la ruta base es /content/cq:tags y el nodo raíz es del 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 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 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 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, contenido etiquetado con fruit/apple se considera etiquetado con fruit y también. Es decir, buscar contenido etiquetado con fruit también encontraría el contenido etiquetado con fruit/apple.

Resolver TagID resolving-tagids

Si TagID contiene dos puntos (:), los dos puntos separan el área de nombres de la etiqueta o subtaxonomía, que se separa aún más con barras oblicuas (/). Si TagID 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.

Etiqueta que hace referencia a rutas no existentes o que no apuntan a una cq:Tag Los nodos de se consideran no válidos y se ignoran.

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:

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 añadiendo 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 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.

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:

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 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.

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

El cq:tags La propiedad es un String Matriz utilizada 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 la variable [cq:Taggable](#taggable-content-cq-taggable-mixin) mixin.

Mover y combinar etiquetas moving-and-merging-tags

A continuación se describen los efectos del repositorio al mover o combinar etiquetas utilizando consola de etiquetado:

Migración de etiquetas tags-migration

A partir de 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 la versión anterior a la versión 6.4, las etiquetas deben migrarse a /content/cq:tags. Consulte AEM Reestructuración común de repositorios en 6.5 para obtener más información.