Il quadro di riferimento per l'assegnazione dei tag dell'AEM

Ultimo aggiornamento: 5 maggio 2025
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Amministratore
  • Sviluppatore

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:

  • Per informazioni sull'assegnazione di tag ai contenuti come autore di contenuti, vedere Utilizzo dei tag.
  • Per informazioni sulla creazione e la gestione dei tag e sulla modalità di applicazione dei tag di contenuto, consulta Amministrazione dei tag .

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

Introduzione

Per assegnare tag ai contenuti e utilizzare l'infrastruttura dei tag AEM:

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 significa sia il frutto generico che la mela più specifica).
  • I tag sono identificati da un TagID univoco.
  • Un tag include metadati facoltativi, ad esempio un titolo, titoli localizzati e una descrizione. Il titolo deve essere visualizzato nelle interfacce utente anziché TagID, se presente.

Il framework dei tag limita inoltre l’utilizzo da parte di autori e visitatori del sito di soli tag specifici e predefiniti.

Caratteristiche tag

  • Il tipo di nodo è cq:Tag.
  • Il nome del nodo è un componente di TagID.
  • TagID include sempre uno spazio dei nomi.
  • La proprietà jcr:title (il titolo da visualizzare nell'interfaccia utente) è facoltativa.
  • La proprietà jcr:description è facoltativa.
  • Quando si contengono nodi figlio, viene indicato come tag contenitore.
  • Il tag viene archiviato nel repository sotto un percorso di base denominato nodo principale della tassonomia.

ID tag

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

In genere, TagID è una scorciatoia TagID 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 viene aggiunta al nodo del contenuto e TagID al valore dell'array String della proprietà.

TagID è costituito da un namespace seguito dal TagID locale. 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

Il nodo principale della tassonomia è il percorso di base per tutti i tag nell’archivio. Il nodo principale della tassonomia deve essere not 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

Gli spazi dei nomi consentono di raggruppare gli elementi. Il caso d’uso più tipico consiste nell’avere uno spazio dei nomi per sito (ad esempio, pubblico rispetto a interno) o per applicazione più grande (ad esempio, Sites o Assets), ma gli spazi dei nomi possono essere utilizzati per varie altre esigenze. Nell’interfaccia utente, gli spazi dei nomi vengono utilizzati 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, ovvero /content/cq:tags/default. In questi casi, il valore predefinito è Standard Tags.

Tag contenitore

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 sommatoria di tutti i tag secondari. Ad esempio, anche il contenuto con tag fruit/apple è considerato con tag fruit. In altre parole, la ricerca del contenuto con tag fruit troverebbe anche il contenuto con tag fruit/apple.