Criação de tags em um aplicativo AEM building-tagging-into-an-aem-application

Para trabalhar programaticamente com tags ou estender tags em um aplicativo AEM personalizado, esta página descreve o uso da variável

Que interage com o

Para obter informações relacionadas à marcação, consulte:

Visão geral da API de marcação overview-of-the-tagging-api

A execução do estrutura de marcação no AEM permite o gerenciamento de tags e conteúdo de tags usando a API JCR. O TagManager garante que as tags sejam inseridas como valores na variável cq:tags As propriedades de matriz de sequência de caracteres não são duplicadas. Elas removem as TagIDs que apontam para tags não existentes e atualizam as TagIDs para tags movidas ou mescladas. O TagManager usa um ouvinte de observação JCR que reverte quaisquer alterações incorretas. As classes principais estão na com.day.cq.tagging pacote:

Obter um TagManager baseado em JCR getting-a-jcr-based-tagmanager

Para recuperar uma instância do TagManager, você deve ter um JCR Session e para chamar getTagManager(Session):

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

No contexto Sling típico, você também pode adaptar a uma TagManager do ResourceResolver:

TagManager tagManager = resourceResolver.adaptTo(TagManager.class);

Recuperação de um objeto de tag retrieving-a-tag-object

A Tag pode ser recuperado por meio da variável TagManager, resolvendo uma tag existente ou criando uma:

Tag tag = tagManager.resolve("my/tag"); // for existing tags

Tag tag = tagManager.createTag("my/tag"); // for new tags

Para a implementação baseada em JCR, que mapeia Tags no JCR Nodes, você pode usar o do Sling diretamente adaptTo mecanismo se você tiver o recurso (por exemplo, como /content/cq:tags/default/my/tag):

Tag tag = resource.adaptTo(Tag.class);

Embora uma tag só possa ser convertida *a partir de *um recurso (não um nó), uma tag pode ser convertida *em *um nó e um recurso :

Node node = tag.adaptTo(Node.class);
Resource node = tag.adaptTo(Resource.class);

Obter e definir tags getting-and-setting-tags

// Getting the tags of a Resource:
Tag[] tags = tagManager.getTags(resource);

// Setting tags to a Resource:
tagManager.setTags(resource, tags);

Pesquisando tags 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);

Exclusão de tags deleting-tags

tagManager.deleteTag(tag);

Replicação de tags replicating-tags

É possível usar o serviço de replicação ( Replicator) com tags, pois as tags são do tipo nt:hierarchyNode:

replicator.replicate(session, replicationActionType, tagPath);

Marcação no lado do cliente tagging-on-the-client-side

O widget de formulário CQ.tagging.TagInputField é para inserir tags. Ele tem um menu pop-up para seleção entre tags existentes, inclui preenchimento automático e muitos outros recursos. Seu xtype é tags.

O coletor de lixo da tag the-tag-garbage-collector

O coletor de lixo da tag é um serviço em segundo plano que limpa as tags ocultas e não usadas. Tags ocultas e não usadas são as tags abaixo /content/cq:tags que tenham um cq:movedTo e não são usados em um nó de conteúdo - têm uma contagem de zero. Ao usar esse processo de exclusão lento, o nó de conteúdo (ou seja, o cq:tags ) não precisa ser atualizada como parte da operação de mover ou mesclar. As referências no cq:tags são atualizados automaticamente quando a variável cq:tags A propriedade do é atualizada, por exemplo, por meio da caixa de diálogo de propriedades da página.

O coletor de lixo da tag é executado por padrão uma vez por dia. Você pode configurá-lo em:

http://localhost:4502/system/console/configMgr/com.day.cq.tagging.impl.TagGarbageCollector

Pesquisa de tags e listagem de tags tag-search-and-tag-listing

A pesquisa de tags e a listagem de tags funcionam da seguinte maneira:

Tags em diferentes idiomas tags-in-different-languages

Conforme descrito na documentação para administração de tags, na seção Gerenciamento de tags em diferentes idiomas, uma tag titlepodem ser definidos em diferentes idiomas. Em seguida, uma propriedade que diferencia idiomas é adicionada ao nó da tag. Essa propriedade tem o formato jcr:title.<locale>, por exemplo, jcr:title.fr pela tradução francesa. A variável <locale> deve ser uma sequência de caracteres de localidade ISO em minúsculas e usar "_" em vez de "-", por exemplo: de_ch.

Quando a variável Animais é adicionada à guia Produtos página, o valor stockphotography:animals é adicionado à propriedade cq:tags do nó /content/geometrixx/en/products/jcr:content. A tradução é referenciada a partir do nó da tag.

A API do lado do servidor localizou titleMétodos relacionados ao:

No AEM, o idioma pode ser obtido no idioma da página ou no idioma do usuário:

A variável currentPage e slingRequest estão disponíveis em um JSP por meio do <cq:definedobjects> tag.

Para marcação, a localização depende do contexto como tag titlespode ser exibido no idioma da página, no idioma do usuário ou em qualquer outro idioma.

Adicionar um novo idioma à caixa de diálogo Editar tag adding-a-new-language-to-the-edit-tag-dialog

O procedimento a seguir descreve como adicionar um idioma (finlandês) à Editar tag diálogo:

O novo idioma (finlandês) agora está disponível na caixa de diálogo de tag das propriedades da página e no Editar tag caixa de diálogo ao editar uma tag no Marcação console.