Saiba o básico sobre a modelagem de conteúdo para headless com o AEM content-modeling-headless-basics
A história até agora story-so-far
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.
Objetivo objective
- Público-alvo: iniciante
- Objetivo: apresentar os conceitos de modelagem de conteúdo de um CMS headless.
Modelagem de conteúdo com modelos de fragmento de conteúdo architect-content-fragment-models
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?
Por quê? why
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.
Introdução a como? how
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 é:
- realizada pela definição do Modelo de fragmento de conteúdo,
- usada como base dos Fragmentos de conteúdo usados para a geração de conteúdo.
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.
Criar a estrutura com Modelos de fragmento de conteúdo create-structure-content-fragment-models
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.
Dentro de um modelo:
- Tipos de dados permitem definir os atributos individuais.
Por exemplo, defina o campo com o nome de um professor como Texto e seus anos de serviço como Número. - Os tipos de dados Referência de conteúdo e Referência de fragmento permitem criar relações com outro conteúdo no AEM.
- O tipo de dados Referência de fragmento permite que você realize vários níveis de estrutura aninhando os Fragmentos de conteúdo (de acordo com o tipo de modelo). Isso é essencial para a modelagem de conteúdo.
Por exemplo:
Tipos de dados data-types
O AEM fornece os seguintes tipos de dados para você modelar o conteúdo:
- Texto em linha única
- Texto multilinha
- Número
- Booleano
- Data e hora
- Lista discriminada
- Tags
- Referência de conteúdo
- Referência de fragmento
- Objeto JSON
Referências e conteúdo aninhado references-nested-content
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:- Editem o fragmento referenciado diretamente.
- Criem um novo fragmento de conteúdo, com base no modelo apropriado
Níveis de estrutura (fragmentos aninhados) levels-of-structure-nested-fragments
Para a 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.
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:
- Cidade
- Empresa
- Pessoa
- Prêmios
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).
-
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 elas são entendidas por você (o arquiteto), pelo autor do conteúdo e pelos aplicativos headless.
O que vem a seguir whats-next
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.
Recursos adicionais additional-resources
-
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.