Saiba o básico sobre a modelagem de conteúdo para headless com o AEM

A história até agora

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

  • 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

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ê?

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?

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.
OBSERVAÇÃO

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.

Criar a estrutura com Modelos de fragmento de conteúdo

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.

OBSERVAÇÃO

A funcionalidade dos fragmentos de conteúdo deve estar ativada no navegador de configuração para que você possa criar novos modelos.

DICA

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:

  1. 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.
  2. Os tipos de dados Referência de conteúdo e Referência de fragmento permitem criar relações com outro conteúdo no AEM.
  3. O tipo de dados Referência de fragmento permite que você atinja vários níveis de estrutura aninhando seus Fragmentos de conteúdo (de acordo com o tipo de modelo). Isso é essencial para a modelagem de conteúdo.

Por exemplo:

Modelagem de conteúdo com fragmentos de conteúdo

Tipos de dados

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
OBSERVAÇÃO

Mais detalhes estão disponíveis em Modelos de fragmento de conteúdo - Tipos de dados.

Referências e conteúdo aninhado

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
OBSERVAÇÃO

Você também pode criar referências ad hoc usando links dentro de blocos de texto.

Níveis de estrutura (fragmentos aninhados)

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.

OBSERVAÇÃO

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:

  • 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 elas são entendidas por você (o arquiteto), pelo autor do conteúdo e pelos aplicativos headless.

O que vem a seguir

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

Nesta página