Gerenciamento de dados de taxonomia managing-taxonomy-data

Saiba como gerenciar dados de taxonomia para usar tags com seu AEM com sites Edge Delivery Services.

Introdução introduction

A marcação é um recurso importante que ajuda a organizar e gerenciar suas páginas. O Console de Marcação no AEM permite criar uma taxonomia avançada de marcas para organizar suas páginas.

Essas tags são úteis não apenas para você e seus autores na organização do conteúdo, mas também podem ser úteis para seus leitores. As tags e sua taxonomia podem ser usadas em componentes na página para ajudar seus leitores a navegar pelo conteúdo.

O Universal Editor funciona somente com as IDs das suas tags. Ao criar uma página de taxonomia para o seu conteúdo, você expõe as descrições dessas tags em todos os idiomas para o Universal Editor para que ele possa usar essas informações ao renderizar o conteúdo.

Criar uma página de taxonomia creating

Uma taxonomia é criada como qualquer outra página no AEM.

A página de taxonomia é criada. Na caixa de diálogo Êxito, toque ou clique na caixa de diálogo Concluído para descartar a mensagem ou Abrir para editar a página no Editor de Páginas.

Anote o nome de página resultante da página de taxonomia para usar nas etapas a seguir.

Editar uma página de taxonomia editing

Você começa a editar uma página de taxonomia como qualquer outra página no AEM.

A página exibida no Editor de páginas é somente leitura porque o conteúdo da taxonomia é gerado automaticamente a partir das tags e dos namespaces selecionados. Eles atuam como uma espécie de filtro para gerar automaticamente o conteúdo da taxonomia. Portanto, não há motivo para editar diretamente a página no editor.

O AEM atualiza automaticamente o conteúdo da página de taxonomia ao atualizar as tags e os namespaces subjacentes. No entanto, você deve republicar a taxonomia após qualquer alteração para disponibilizar essas alterações aos usuários.

Atualizar paths.json para publicação de taxonomia paths-json

Assim como no gerenciamento e publicação de dados tabulares para o seu site Edge Delivery Services, é necessário atualizar o arquivo paths.json do seu projeto para permitir a publicação dos dados de taxonomia.

Esse processo só precisa ser feito uma vez por página de taxonomia. Depois de concluído, você pode publicar sua taxonomia.

Publicar uma taxonomia publishing

Uma taxonomia não estará disponível para o Editor universal ou seus usuários até que seja publicada.

As páginas de taxonomia são publicadas como qualquer outra página por usando os ícones Quick Publish ou Gerenciar Publicação da barra de ferramentas.

Você deve republicar sua página de taxonomia sempre que:

Se você criar uma nova página de taxonomia, primeiro adicione um mapeamento a ela para o arquivo paths.json do seu projeto.

Acesso às Informações de Taxonomia accessing

Depois que a taxonomia é publicada, suas informações podem ser aproveitadas pelo Editor universal e tornadas visíveis para os usuários.

Você pode acessar a taxonomia como dados JSON no seguinte endereço.

https://<branch>--<repository>--<owner>.hlx.page/<taxonomy-json-name>.json

Use o <taxonomy-json-name> que você definiu ao mapear sua taxonomia para o arquivo paths.json em seu projeto. Os dados de taxonomia são retornados como dados JSON, como no exemplo a seguir.

{
  "total": 3,
  "offset": 0,
  "limit": 3,
  "data": [
    {
      "tag": "default:",
      "title": "Standard Tags"
    },
    {
      "tag": "do-not-translate",
      "title": "Do Not Translate"
    },
    {
      "tag": "translate",
      "title": "Translate"
    }
  ],
  ":type": "sheet"
}

Esses dados JSON serão atualizados automaticamente à medida que você atualizar a taxonomia e publicá-la novamente. Seu aplicativo pode acessar programaticamente essas informações para seus usuários.

Se você mantiver marcas em vários idiomas, poderá acessar esses idiomas transmitindo o código de idioma ISO2 como o valor de um parâmetro sheet=.