No início da jornada do arquiteto de conteúdo headless do AEM, a Introdução abordou os conceitos básicos e as terminologias relevantes para a modelagem de conteúdo para headless.
Este artigo se baseia nesses conceitos para que você entenda como modelar o conteúdo do seu projeto headless do AEM.
A modelagem de conteúdo (dados) é um conjunto de técnicas estabelecidas e frequentemente usadas ao desenvolver bancos de dados de relacionamento. Então, o que a modelagem de conteúdo significa para o AEM Headless?
Para garantir que seu aplicativo possa solicitar e receber o conteúdo necessário do AEM de forma consistente e eficiente, esse conteúdo deve ser estruturado.
Isso significa que o aplicativo sabe antecipadamente a forma de resposta e, portanto, como processá-la. Isso é muito mais fácil do que receber conteúdo de forma livre, que deve ser analisado para determinar o que ele contém e, portanto, como pode ser usado.
O AEM usa Fragmentos de conteúdo para fornecer as estruturas necessárias para a entrega headless do conteúdo aos seus aplicativos.
A estrutura do modelo de conteúdo é:
Os modelos de fragmento de conteúdo também são usados como a base dos esquemas GraphQL do AEM, os quais são usados para recuperar seu conteúdo. Falaremos mais sobre isso na jornada do desenvolvedor.
As solicitações de conteúdo são feitas usando a API GraphQL do AEM, uma implementação personalizada da API GraphQL padrão. A API GraphQL do AEM permite que os aplicativos realizem consultas (complexas) em seus fragmentos de conteúdo, sendo que cada consulta está de acordo com um tipo de modelo específico.
O conteúdo retornado pode ser usado pelos seus aplicativos.
Os Modelos de fragmentos de conteúdo fornecem vários mecanismos que permitem definir a estrutura do conteúdo.
Um Modelo de fragmento de conteúdo descreve uma entidade.
A funcionalidade dos fragmentos de conteúdo deve estar ativada no navegador de configuração para que você possa criar novos modelos.
O modelo deve ser nomeado para que o autor de conteúdo saiba qual modelo selecionar ao criar um Fragmento de conteúdo.
Dentro de um modelo:
Por exemplo:
O AEM fornece os seguintes tipos de dados para você modelar o conteúdo:
Mais detalhes estão disponíveis em Modelos de fragmento de conteúdo - Tipos de dados.
Dois tipos de dados fornecem referências ao conteúdo fora de um fragmento específico:
Referência de conteúdo
Isso fornece uma referência simples a outro conteúdo de qualquer tipo.
Por exemplo, você pode fazer referência a uma imagem em um local especifico.
Referência de fragmento
Isso fornece referências a outros Fragmentos de conteúdo.
Esse tipo de referência é usado para criar conteúdo aninhado, introduzindo as relações necessárias para modelar o conteúdo.
O tipo de dados pode ser configurado para permitir que os autores de fragmento:
Você também pode criar referências ad hoc usando links dentro de blocos de texto.
Na modelagem de conteúdo, o tipo de dados Referência de fragmento permite criar vários níveis de estrutura e relações.
Com essa referência, você pode conectar vários modelos de fragmentos de conteúdo para representar as inter-relações. Isso permite que o aplicativo headless siga as conexões e acesse o conteúdo conforme necessário.
Isso deve ser usado com cautela e a prática recomendada pode ser definida como aninhar o necessário, mas o mínimo possível.
As referências de fragmento fazem exatamente isso: permitem que você faça referência a outro fragmento.
Por exemplo, você pode ter os seguintes modelos de fragmento de conteúdo definidos:
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).
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 elas são entendidas por você (o arquiteto), pelo autor do conteúdo e pelos aplicativos headless.
Agora que você aprendeu o básico, o próximo passo é Saber mais sobre como criar Modelos de fragmento de conteúdo no AEM. Essa seção introduzirá e discutirá as várias referências disponíveis e como criar níveis de estrutura com as Referências de fragmento, uma parte essencial da modelagem headless.
Manuseio básico - esta página se baseia principalmente no console Sites, mas muitos/a maioria dos recursos também são relevantes para a criação de Fragmentos de conteúdo no console Ativos.