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 implementação da 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 marcas inseridas como valores na propriedade de matriz da cadeia de caracteres cq:tags não sejam duplicadas, ele remove TagIDs que apontam para marcas não existentes e atualiza TagIDs para marcas movidas ou mescladas. O TagManager usa um ouvinte de observação JCR que reverte quaisquer alterações incorretas. As classes principais estão no pacote com.day.cq.tagging:

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 chamar getTagManager(Session):

@Reference
JcrTagManagerFactory jcrTagManagerFactory;

TagManager tagManager = jcrTagManagerFactory.getTagManager(session);

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

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

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

Um Tag pode ser recuperado por meio de TagManager, resolvendo uma marca 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 para JCR Nodes, você pode usar diretamente o mecanismo adaptTo do Sling se 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 marcas porque as marcas 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 serve para inserir marcas. 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. Marcas ocultas e não usadas são marcas abaixo de /content/cq:tags que têm uma propriedade cq:movedTo e não são usadas em um nó de conteúdo - elas têm uma contagem igual a zero. Ao usar esse processo de exclusão lento, o nó de conteúdo (ou seja, a propriedade cq:tags) não precisa ser atualizado como parte da operação de movimentação ou mesclagem. As referências na propriedade cq:tags são atualizadas automaticamente quando a propriedade cq:tags é 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 title pode ser definida 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 para a tradução em francês. O <locale> deve ser uma cadeia de caracteres de localidade ISO em minúsculas e usar "_" em vez de "-", por exemplo: de_ch.

Quando a marca Animais é adicionada à página Produtos, 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 métodos relacionados a title:

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

O currentPage e o slingRequest estão disponíveis em um JSP por meio da marca <cq:definedObjects>.

Para marcação, a localização depende do contexto, pois a marca titles pode ser exibida 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) à caixa de diálogo Editar tag:

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