Framework di assegnazione tag AEM aem-tagging-framework

L’assegnazione tag consente di categorizzare e organizzare i contenuti. I tag possono essere classificati in base a uno spazio dei nomi e a una tassonomia. Per informazioni dettagliate sull’utilizzo dei tag:

Questo articolo si concentra sul framework sottostante che supporta l’assegnazione tag in AEM e su come utilizzarlo come sviluppatore.

Introduzione introduction

Per assegnare tag ai contenuti e utilizzare l’infrastruttura di tag AEM:

Tag : cq:Tag Node Type tags-cq-tag-node-type

La dichiarazione di un tag viene acquisita nell'archivio in un nodo di tipo cq:Tag.

Un tag può essere una parola semplice (ad esempio, sky) o rappresentare una tassonomia gerarchica (ad esempio, fruit/apple, che indica sia il fruit generico che il apple più specifico).

I tag sono identificati da un TagID univoco.

Un tag include metadati facoltativi, ad esempio un titolo, titoli localizzati e una descrizione. Se presente, il titolo deve essere visualizzato nelle interfacce utente invece che nell’ID tag.

Il framework dei tag consente inoltre di limitare l’uso di specifici tag predefiniti da parte di autori e visitatori del sito.

Caratteristiche tag tag-characteristics

Poiché i tag sono semplicemente nodi JCR, i nomi dei nodi devono rispettare la convenzione di denominazione JCR.

ID tag tagid

Un TagID identifica un percorso che viene risolto in un nodo di tag nell’archivio.

In genere, il TagID è un TagID abbreviato che inizia con lo spazio dei nomi oppure può essere un TagID assoluto che inizia dal nodo principale della tassonomia .

Quando il contenuto viene taggato, se non esiste ancora, la proprietà [cq:tags](#tagged-content-cq-tags-property) viene aggiunta al nodo del contenuto e il TagID viene aggiunto al valore dell'array String della proprietà.

TagID è costituito da uno spazio dei nomi seguito dal valore locale TagID. I tag contenitore contengono tag secondari che rappresentano un ordine gerarchico nella tassonomia. I tag secondari possono essere utilizzati per fare riferimento ai tag come qualsiasi TagID locale. Ad esempio, è possibile assegnare tag al contenuto con fruit anche se si tratta di un tag contenitore con tag secondari, ad esempio fruit/apple e fruit/banana.

Nodo principale tassonomia taxonomy-root-node

Il nodo principale della tassonomia è il percorso di base per tutti i tag nell’archivio. Il nodo principale della tassonomia non deve essere un nodo di tipo cq:Tag.

In AEM, il percorso di base è /content/cq:tags e il nodo principale è di tipo cq:Folder.

Spazio dei nomi dei tag tag-namespace

Gli spazi dei nomi consentono di raggruppare gli elementi. Il caso d’uso più tipico è uno spazio dei nomi per sito (ad esempio, pubblico, interno e portale) o per applicazione più grande (ad esempio, WCM, Assets, Communities). Tuttavia, gli spazi dei nomi possono essere utilizzati per varie altre esigenze. Gli spazi dei nomi vengono utilizzati nell’interfaccia utente per mostrare solo il sottoinsieme di tag (ovvero i tag di un determinato spazio dei nomi) applicabile al contenuto corrente.

Lo spazio dei nomi del tag è il primo livello della sottostruttura della tassonomia, ovvero il nodo immediatamente sotto il nodo principale della tassonomia. Uno spazio dei nomi è un nodo di tipo cq:Tag il cui elemento padre non è un tipo di nodo cq:Tag.

Tutti i tag hanno uno spazio dei nomi. Se non viene specificato alcuno spazio dei nomi, il tag viene assegnato allo spazio dei nomi predefinito, ovvero TagID default con titolo Standard Tags, ovvero /content/cq:tags/default.

Tag contenitore container-tags

Un tag contenitore è un nodo di tipo cq:Tag contenente un numero e un tipo qualsiasi di nodi figlio, che consente di migliorare il modello di tag con metadati personalizzati.

Inoltre, i tag contenitore (o super tag) in una tassonomia fungono da sottotag di tutti i tag. Ad esempio, il contenuto con tag fruit/apple è considerato essere con tag anche fruit. In altre parole, la ricerca del contenuto con tag fruit troverebbe anche il contenuto con tag fruit/apple.

Risoluzione di TagID resolving-tagids

Se l'oggetto TagID contiene i due punti (:), lo spazio dei nomi verrà separato dal tag o dalla sottotassonomia, separati da barre (/). Se l’ID tag non ha due punti, viene implicito lo spazio dei nomi predefinito.

La posizione standard e unica dei tag è inferiore a /content/cq:tags.

I tag che fanno riferimento a percorsi non esistenti o che non fanno riferimento a un nodo cq:Tag sono considerati non validi e vengono ignorati.

Nella tabella seguente vengono illustrati alcuni TagID di esempio, i relativi elementi e il modo in cui TagID viene risolto in un percorso assoluto nel repository:

Localizzazione del titolo del tag localization-of-tag-title

Quando il tag include la stringa opzionale del titolo ( jcr:title), è possibile localizzare il titolo da visualizzare aggiungendo la proprietà jcr:title.<locale>.

Per ulteriori informazioni, consulta i seguenti documenti:

Controllo accesso access-control

I tag esistono come nodi nell'archivio nel nodo principale della tassonomia 🔗. È possibile consentire o negare agli autori e ai visitatori del sito la creazione di tag in un determinato spazio dei nomi impostando ACL appropriati nell’archivio.

Inoltre, il rifiuto delle autorizzazioni di lettura per alcuni tag o spazi dei nomi controlla la possibilità di applicare tag a contenuto specifico.

Una pratica tipica include:

Contenuto assegnabile : cq:Taggable Mixin taggable-content-cq-taggable-mixin

Affinché gli sviluppatori di applicazioni possano associare tag a un tipo di contenuto, la registrazione del nodo (CND) deve includere il mixin cq:Taggable o il mixin cq:OwnerTaggable.

Il mixin cq:OwnerTaggable, che eredita da cq:Taggable, ha lo scopo di indicare che il contenuto può essere classificato dal proprietario/autore. In AEM è solo un attributo del nodo cq:PageContent. Il mixin cq:OwnerTaggable non è richiesto dal framework di assegnazione tag.

Notazione del tipo di nodo (CND) node-type-notation-cnd

Le definizioni dei tipi di nodo esistono nell’archivio come file CND. La notazione CND è definita nella documentazione JCR qui.

Le definizioni essenziali per i tipi di nodo inclusi nell’AEM sono le seguenti:

[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

Contenuto con tag: cq:tags, proprietà tagged-content-cq-tags-property

La proprietà cq:tags è un array String utilizzato per memorizzare uno o più TagID quando vengono applicati al contenuto da autori o visitatori del sito. La proprietà ha un significato solo quando viene aggiunta a un nodo definito con il mixin [cq:Taggable](#taggable-content-cq-taggable-mixin).

Spostamento e unione di tag moving-and-merging-tags

Di seguito è riportata una descrizione degli effetti nell'archivio durante lo spostamento o l'unione di tag tramite la console di assegnazione tag:

Migrazione tag tags-migration

A partire da Adobe Experience Manager 6.4, i tag sono memorizzati in /content/cq:tags, mentre le versioni precedenti memorizzavano i tag in /etc/tags.

Ogni volta che si aggiorna un sistema AEM da una versione precedente alla 6.4, è necessario migrare i tag a /content/cq:tags. Per ulteriori informazioni, vedere Ristrutturazione dell'archivio comune in AEM 6.5.