Creazione di tag in un’applicazione AEM building-tagging-into-an-aem-application
Per lavorare in modo programmatico con i tag o estenderli all’interno di un’applicazione AEM personalizzata, questa pagina descrive l’utilizzo di
che interagisce con il
Per informazioni correlate sull’assegnazione tag, consulta:
- Amministrazione dei tag per informazioni sulla creazione e la gestione dei tag e sui tag di contenuto applicati.
- Utilizzo dei tag per informazioni sui tag del contenuto.
Panoramica dell’API di assegnazione tag overview-of-the-tagging-api
L'implementazione del framework dei tag nell'AEM consente la gestione di tag e contenuti di tag tramite l'API JCR. TagManager garantisce che i tag immessi come valori nella proprietà dell'array di stringhe cq:tags
non siano duplicati, rimuove i TagID che puntano a tag non esistenti e aggiorna i TagID per i tag spostati o uniti. TagManager utilizza un listener di osservazione JCR che ripristina eventuali modifiche non corrette. Le classi principali si trovano nel pacchetto com.day.cq.tagging:
- JcrTagManagerFactory: restituisce un'implementazione basata su JCR di
TagManager
. È l’implementazione di riferimento dell’API di assegnazione tag. TagManager
- consente di risolvere e creare tag in base a percorsi e nomi.Tag
- definisce l'oggetto tag.
Ottenere un TagManager basato su JCR getting-a-jcr-based-tagmanager
Per recuperare un'istanza TagManager, è necessario disporre di un JCR Session
e chiamare getTagManager(Session)
:
@Reference
JcrTagManagerFactory jcrTagManagerFactory;
TagManager tagManager = jcrTagManagerFactory.getTagManager(session);
Nel contesto Sling tipico, puoi anche adattarti a TagManager
da ResourceResolver
:
TagManager tagManager = resourceResolver.adaptTo(TagManager.class);
Recupero di un oggetto Tag retrieving-a-tag-object
È possibile recuperare Tag
tramite TagManager
, risolvendo un tag esistente o creandone uno:
Tag tag = tagManager.resolve("my/tag"); // for existing tags
Tag tag = tagManager.createTag("my/tag"); // for new tags
Per l'implementazione basata su JCR, che mappa Tags
su JCR Nodes
, puoi utilizzare direttamente il meccanismo adaptTo
di Sling se disponi della risorsa (ad esempio, /content/cq:tags/default/my/tag
):
Tag tag = resource.adaptTo(Tag.class);
Mentre un tag può essere convertito solo *da *una risorsa (non un nodo), un tag può essere convertito *sia in un nodo che in una risorsa:
Node node = tag.adaptTo(Node.class);
Resource node = tag.adaptTo(Resource.class);
Node
a Tag
non è possibile perché Node
non implementa il metodo Sling Adaptable.adaptTo(Class)
.Recupero e impostazione dei tag getting-and-setting-tags
// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);
// Setting tags to a Resource:
tagManager.setTags(resource, tags);
Ricerca di tag searching-for-tags
// Searching for the Resource objects that are tagged with the tag object:
Iterator<Resource> it = tag.find();
// Retrieving the usage count of the tag object:
long count = tag.getCount();
// Searching for the Resource objects that are tagged with the tagID String:
RangeIterator<Resource> it = tagManager.find(tagID);
RangeIterator
valido da utilizzare:com.day.cq.commons.RangeIterator
Eliminazione dei tag deleting-tags
tagManager.deleteTag(tag);
Replica dei tag replicating-tags
È possibile utilizzare il servizio di replica ( Replicator
) con i tag perché i tag sono di tipo nt:hierarchyNode
:
replicator.replicate(session, replicationActionType, tagPath);
Assegnazione di tag sul lato client tagging-on-the-client-side
Il widget del modulo CQ.tagging.TagInputField
è per l'immissione di tag. Dispone di un menu a comparsa per selezionare da tag esistenti, include il completamento automatico e molte altre funzioni. Il relativo xtype è tags
.
Tag Garbage Collector the-tag-garbage-collector
Il garbage collector dei tag è un servizio in background che consente di pulire i tag nascosti e non utilizzati. I tag nascosti e inutilizzati sono tag al di sotto di /content/cq:tags
che hanno una proprietà cq:movedTo
e non sono utilizzati in un nodo di contenuto. Il conteggio è pari a zero. Utilizzando questo processo di eliminazione lenta, non è necessario aggiornare il nodo del contenuto (ovvero la proprietà cq:tags
) come parte dell'operazione di spostamento o unione. I riferimenti nella proprietà cq:tags
vengono aggiornati automaticamente quando la proprietà cq:tags
viene aggiornata, ad esempio tramite la finestra di dialogo delle proprietà della pagina.
Il garbage collector dei tag viene eseguito per impostazione predefinita una volta al giorno. Puoi configurarlo in:
http://localhost:4502/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector
Ricerca di tag ed elenco di tag tag-search-and-tag-listing
La ricerca dei tag e l’elenco dei tag funzionano come segue:
-
La ricerca di TagID cerca i tag la cui proprietà
cq:movedTo
è impostata su TagID e segue icq:movedTo
TagID. -
La ricerca del titolo del tag consente di cercare solo i tag che non hanno una proprietà
cq:movedTo
.
Tag in lingue diverse tags-in-different-languages
Come descritto nella documentazione per l'amministrazione dei tag, nella sezione Gestione dei tag in lingue diverse è possibile definire un tag title
in lingue diverse. Al nodo del tag viene quindi aggiunta una proprietà sensibile alla lingua. Questa proprietà ha il formato jcr:title.<locale>
, ad esempio jcr:title.fr
per la traduzione francese. <locale>
deve essere una stringa internazionale ISO minuscola e utilizzare "_" invece di "-", ad esempio: de_ch
.
Quando il tag Animals viene aggiunto alla pagina Products, il valore stockphotography:animals
viene aggiunto alla proprietà cq:tags
del nodo /content/geometrixx/en/products/jcr:content. Viene fatto riferimento alla traduzione dal nodo del tag.
L'API lato server ha localizzato title
metodi correlati:
-
- getLocalizedTitle(Locale locale)
- getLocalizedTitlePaths()
- getLocalizedTitles()
- getTitle(Lingua locale)
- getTitlePath(impostazioni locali)
-
- canCreateTagByTitle(String tagTitlePath, impostazioni locali)
- createTagByTitle(String tagTitlePath, impostazioni locali)
- resolveByTitle(String tagTitlePath, impostazioni locali)
In AEM, la lingua può essere ottenuta o dalla lingua della pagina o dalla lingua dell’utente:
-
per recuperare la lingua della pagina in una JSP:
currentPage.getLanguage(false)
-
per recuperare la lingua utente in una JSP:
slingRequest.getLocale()
currentPage
e slingRequest
sono disponibili in una JSP tramite il tag <cq:definedObjects>.
Per i tag, la localizzazione dipende dal contesto, in quanto il tag titles
può essere visualizzato nella lingua della pagina, nella lingua dell'utente o in qualsiasi altra lingua.
Aggiunta di una nuova lingua alla finestra di dialogo Modifica tag adding-a-new-language-to-the-edit-tag-dialog
Nella procedura seguente viene descritto come aggiungere una lingua (finlandese) alla finestra di dialogo Modifica tag:
-
In CRXDE, modificare la proprietà multivalore
languages
del nodo/content/cq:tags
. -
Aggiungere
fi_fi
, che rappresenta la lingua finlandese, e salvare le modifiche.
La nuova lingua (finlandese) è ora disponibile nella finestra di dialogo dei tag delle proprietà della pagina e nella finestra di dialogo Modifica tag quando si modifica un tag nella console Assegnazione tag.
/libs/wcm/core/resources/languages
./content/cq:tags
sui valori predefiniti. Pertanto, è necessario aggiungerlo dalle proprietà prima dell’installazione.