Saiba mais sobre como usar referências em Fragmentos de conteúdo author-headless-references

A história até agora story-so-far

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 objective

O que são referências what-are-references

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).

Referências de conteúdo content-references

As Referências de conteúdo fazem exatamente isso - elas permitem fazer referência a qualquer outro conteúdo. Isso abre um navegador que permite selecionar o item de conteúdo.

Referências de ativo/mídia assets-media-references

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

Referências de fragmento fragment-references

Novamente, as Referências de fragmento fazem exatamente isso - elas permitem fazer 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:

Parece muito simples, mas uma empresa tem um CEO e funcionários…e todos são definidos como uma Pessoa.

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

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 author-nested-fragment

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 (mais provavelmente) selecionar o ícone de pasta para abrir um navegador que permita navegar e selecionar o fragmento necessário.

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

Como navegar pelos fragmentos aninhados navigate-nested-fragment

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.

Referências ad hoc adhoc-references

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

O que vem a seguir whats-next

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 additional-resources