Saiba mais sobre como usar referências em Fragmentos de conteúdo

A história até agora

No início da Jornada do autor de conteúdo headless do AEM, a Introdução abordou os conceitos básicos e a terminologia relevante para a criação de conteúdo headless.

Você aprendeu os fundamentos da criação de CMS headless, com uma introdução à autoria com AEMaaCS e, em particular, à autoria de Fragmentos de conteúdo.

Este artigo se baseia nesses itens para que você entenda como usar referências para criar seu próprio conteúdo para seu projeto headless do AEM.

Objetivo

  • Público-alvo: avançado

  • Objetivo: introduzir o uso de referências para a Criação de CMS headless. Que tipos de referências estão disponíveis e quais são seus objetivos:

    • Referências do conteúdo
    • Referências de ativo/mídia
    • Referências de fragmento
    • Referências ad hoc de dentro de um bloco de texto

O que são referências

As referências são simplesmente um mecanismo para conectar seus recursos, seja outro conteúdo, ativos (como em imagens) ou outros fragmentos. Embora muito parecidas, há algumas diferenças.

Algumas referências têm tipos de dados dedicados (por exemplo, Referências de conteúdo e Referências de fragmento), enquanto outras são simplesmente adicionadas como referência em um bloco de texto (referências de ativos e referências ad hoc).

Fragmentos de conteúdo: referências

Referências de conteúdo

As Referências de conteúdo fazem exatamente isso: permitem que você faça referência a qualquer outro conteúdo. Isso abrirá um navegador que permite selecionar o item de conteúdo.

Referências de ativo/mídia

Os ativos (por exemplo, imagens ou mídia) podem ser referenciados em um bloco de texto usando a opção Inserir ativo. Isso abrirá um navegador que permite selecionar o ativo.

Fragmentos de conteúdo: inserir ativo

Referências de fragmento

Novamente, as Referências de fragmento fazem exatamente isso, permitem que você faça referência a outro fragmento. Por ser relevante, precisa de um pouco mais de explicação.

Por exemplo, você pode ter os seguintes modelos de fragmento de conteúdo definidos:

  • Cidade
  • Empresa
  • Pessoa
  • Prêmios

Parece muito simples, porém é claro que uma empresa conta com um CEO, mas também com funcionários…e todos são definidos como uma Pessoa.

E uma pessoa pode ter um prêmio (ou talvez dois).

  • Minha empresa - Empresa
    • CEO - Pessoa
    • Funcionário(s) - Pessoa
      • Prêmios pessoais - Prêmio

E isso é só para começar. Dependendo da complexidade, um prêmio pode ser específico da empresa ou uma empresa pode ter seu escritório principal em uma cidade específica.

A representação dessas inter-relações pode ser alcançada com as Referências de fragmento, já que são entendidas por você (o autor) e pelos aplicativos headless.

Como autor, você não é responsável por definir esses relacionamentos (isso é feito pelo Arquiteto de conteúdo ao criar o Modelo de fragmento de conteúdo), mas precisa saber como reconhecer e editar as referências.

Como criar fragmentos aninhados

A criação de referências de fragmento é bastante direta (embora o campo geralmente não seja rotulado como Referência de fragmento). Você pode digitar a referência diretamente ou (provavelmente) selecionar o ícone de pasta para abrir um navegador que permite navegar e selecionar o fragmento necessário.

Fragmentos de conteúdo: referências

A definição do Modelo de fragmento de conteúdo controla:

  • se você pode optar por adicionar várias referências
  • os tipos de modelo de Fragmentos de conteúdo que você pode selecionar; o Modelo de fragmento de conteúdo define os modelos de fragmento permitidos para a referência, de modo que o AEM apresenta apenas fragmentos com base nesses modelos.

Com a utilização da guia Árvore da estrutura do Editor de fragmento de conteúdo, é possível navegar pelos fragmentos referenciados pelo fragmento e, em seguida, por meio de quaisquer referências que eles possam conter. Selecionar uma referência abre esse fragmento para edição.

OBSERVAÇÃO

Com a utilização da navegação estrutural no painel principal, é possível navegar de volta ao ponto inicial.

Árvore de estrutura do fragmento de conteúdo

Referências ad hoc

Referências ad hoc podem ser adicionadas como um link simples dentro de um bloco de texto:

Fragmentos de conteúdo: referências ad hoc

O que vem a seguir

Agora que você aprendeu sobre referências e estrutura nos Fragmentos de conteúdo, a próxima etapa é Saber mais sobre metadados e marcação. Isso apresentará e discutirá como você pode definir metadados e tags para os Fragmentos de conteúdo.

Recursos adicionais

Nesta página