Como modelar seu conteúdo model-your-content
Nesta parte da jornada do desenvolvedor do AEM Headless, você pode aprender a modelar sua estrutura de conteúdo. Em seguida, observe que a estrutura do Adobe Experience Manager (AEM) usando modelos de fragmentos de conteúdo e fragmentos de conteúdo deve ser reutilizada em canais.
A história até agora story-so-far
No início, Saiba mais sobre o desenvolvimento headless CMS abordou a entrega de conteúdo headless e por que ela deve ser usada. Então Introdução ao AEM Headless descreveu o AEM Headless no contexto de seu próprio projeto.
No documento anterior da jornada do AEM Headless, Caminho para a sua primeira experiência utilizando o AEM Headless, você aprendeu as etapas necessárias para implementar seu primeiro projeto. Depois de lê-lo, você deve:
- Entender considerações importantes de planejamento para criar seu conteúdo
- Entender as etapas para implementar o método headless dependendo dos requisitos do seu nível de integração.
- Organizar as ferramentas e configurações necessárias do AEM.
- Conhecer as práticas recomendadas para simplificar a sua jornada headless, manter a eficiência na geração de conteúdo e garantir que o conteúdo seja entregue rapidamente.
Este artigo se baseia nesses fundamentos para que você entenda como preparar seu próprio projeto do AEM Headless.
Objetivo objective
-
Público-alvo: iniciante
-
Objetivo: aprender a modelar sua estrutura de conteúdo e estabelecer essa estrutura usando modelos de fragmentos de conteúdo e fragmentos de conteúdo do AEM:
- Conheça conceitos e terminologias relacionados à modelagem de dados/conteúdo.
- Saiba por que a modelagem de conteúdo é necessária para a entrega de conteúdo headless.
- Saiba como estabelecer essa estrutura utilizando modelos de fragmentos de conteúdo do AEM (e criar conteúdo com fragmentos de conteúdo).
- Saiba como modelar seu conteúdo através de princípios com amostras básicas.
Modelagem de conteúdo content-modeling
O mundo é grande e complexo.
Talvez, mas talvez não. Certamente é um mundo extremamente complicado lá fora. A modelagem de dados é usada para definir uma representação simplificada de uma subseção muito (muito) pequena, usando as informações específicas necessárias para uma determinada finalidade.
Por exemplo:
Existem muitas escolas, mas todas têm muitas coisas em comum:
- Um local
- Um diretor
- Muitos professores
- Muitos membros não docentes
- Muitos alunos
- Muitos ex-professores
- Muitos ex-alunos
- Muitas salas de aula
- Uma grande quantidade de livros
- Uma grande quantidade de equipamentos
- Muitas atividades extracurriculares
- e assim por diante…
Mesmo em um exemplo tão pequeno, a lista pode parecer infinita. Mas se você simplesmente quiser que seu aplicativo execute uma tarefa simples, é possível limitar as informações ao essencial.
Por exemplo, para realizar a publicidade de eventos especiais para todas as escolas da área, as seguintes informações são necessárias:
- Nome da escola
- Local da escola
- Diretor
- Tipo de evento
- Data do evento
- Professor organizador do evento
Conceitos concepts
O que você deseja descrever é conhecido como Entidades - basicamente as "coisas" sobre as quais você deseja armazenar informações.
As informações que você deseja armazenar sobre eles são os Atributos (propriedades), como Nome e Qualificações dos professores.
Há várias Relações entre as entidades. Por exemplo, geralmente uma escola tem apenas um diretor e muitos professores (e geralmente o diretor também é professor).
O processo de análise e definição dessas informações, junto com as relações entre elas, é chamado de Modelagem de conteúdo.
Básico basics
Geralmente, você pode começar elaborando um Esquema Conceitual que descreve as entidades e seus relacionamentos. Geralmente, é um esquema de alto nível (conceitual).
Depois que isso estiver estável, você pode traduzir os modelos em um Esquema lógico que descreve as entidades, juntamente com os atributos, e as relações. Nesse nível, examine as definições cuidadosamente para eliminar a duplicação e otimizar o design.
Por exemplo, você precisa de entidades separadas para Head Teacher e Teacher ou simplesmente um atributo adicional no modelo Teacher?
Garantia da integridade de dados data-integrity
A integridade de dados é necessária para garantir a precisão e a consistência do conteúdo em todo o ciclo de vida. Isso inclui garantir que os autores de conteúdo possam entender facilmente o que armazenar, para que os itens a seguir sejam fundamentais:
- uma estrutura clara
- uma estrutura o mais concisa possível (sem sacrificar a precisão)
- validação de campos individuais
- quando apropriado, restringir o conteúdo de campos específicos ao que é relevante
Eliminação da redundância de dados data-redundancy
A redundância de dados ocorre quando as mesmas informações são armazenadas duas vezes na estrutura de conteúdo. Isso deve ser evitado, pois pode gerar confusão na criação do conteúdo e erros na consulta; sem falar no mau uso do espaço de armazenamento.
Otimização e desempenho optimization-and-performance
Ao otimizar sua estrutura, você pode melhorar o desempenho, tanto para criação de conteúdo quanto para consultas.
Tudo é um ato de equilíbrio, mas a criação de uma estrutura muito complexa ou com muitos níveis, pode:
-
Ser confusa para os autores que geram o conteúdo.
-
Afetar bastante o desempenho se a consulta tiver que acessar vários Fragmentos de conteúdo aninhados (referenciados) para recuperar o conteúdo necessário.
Modelagem de conteúdo para AEM headless content-modeling-for-aem-headless
A Modelagem de dados é um conjunto de técnicas estabelecidas, 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 é mais fácil do que receber conteúdo de forma livre, que deve ser analisado para determinar o que 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 do GraphQL do AEM permite realizar consultas (complexas) nos fragmentos de conteúdo, com cada consulta 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 fragmento 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:
- Os 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.
- Crie um fragmento de conteúdo, com base no modelo apropriado.
Criar Modelos de fragmentos do conteúdo creating-content-fragment-models
No início, você deve ativar os Modelos de fragmentos de conteúdo no site. Essa ativação é feita no Navegador de configuração; em Ferramentas > Geral > Navegador de configuração. Você pode optar por configurar a entrada global ou criar uma configuração. Por exemplo:
Em seguida, os Modelos de fragmentos de conteúdo podem ser criados e a estrutura definida. Isso pode ser feito em Ferramentas > Assets > Modelos de fragmento de conteúdo. Por exemplo:
Uso do modelo para criar conteúdo com Fragmentos de conteúdo use-content-to-author-content
Fragmentos de conteúdo são sempre baseados em um Modelo de fragmento de conteúdo. O modelo fornece a estrutura, o fragmento retém o conteúdo.
Seleção do modelo apropriado select-model
A primeira etapa para realmente criar o conteúdo é criar um Fragmento de conteúdo. Isso é feito usando Criar > Fragmento de conteúdo na pasta necessária em Assets > Arquivos. O assistente orienta você pelas etapas.
Um Fragmento de conteúdo é baseado em um Modelo de fragmento de conteúdo específico, que pode ser selecionado como a primeira etapa do processo de criação.
Criação e edição de conteúdo estruturado create-edit-structured-content
Depois que o fragmento for criado, você poderá abri-lo no Editor de fragmento de conteúdo. Aqui você pode fazer o seguinte:
- Edite o conteúdo no modo normal ou de tela cheia.
- Formate o conteúdo como Texto completo, Texto sem formatação ou Markdown.
- Crie e gerencie variações de seu conteúdo.
- Associar conteúdo.
- Editar os metadados.
- Mostrar a estrutura da árvore.
- Visualizar a representação JSON.
Criação de fragmentos de conteúdo creating-content-fragments
Após selecionar o modelo apropriado, um fragmento de conteúdo é aberto para edição no editor de fragmento de conteúdo:
Introdução a alguns exemplos getting-started-examples
Para ver uma estrutura básica de amostra, consulte Amostra da estrutura do fragmento de conteúdo.
O que vem a seguir whats-next
Agora que você aprendeu a modelar a estrutura e criar um conteúdo que é dependente dela, a próxima etapa é Aprender a usar consultas GraphQL para acessar e recuperar conteúdo dos fragmentos de conteúdo. Ele apresenta e discute o GraphQL e, em seguida, examina alguns exemplos de consultas para ver como as coisas funcionam na prática.
Recursos adicionais additional-resources
-
Trabalhando com fragmentos de conteúdo - A página de introdução dos fragmentos de conteúdo.
- Fragmentos de Conteúdo no Navegador de Configuração - Habilitar a funcionalidade de Fragmento de Conteúdo no Navegador de Configuração.
- Modelos de fragmentos de conteúdo - Criação e edição de Modelos de fragmentos de conteúdo.
- Gerenciamento de fragmentos de conteúdo - Criação e criação de fragmentos de conteúdo; esta página leva você a outras seções detalhadas.
-
Esquemas de GraphQL do AEM - Como o GraphQL realiza modelos.
-
Introdução ao AEM Headless - Uma pequena série de tutoriais em vídeo que fornece uma visão geral da utilização de recursos headless do AEM, incluindo a modelagem de conteúdo e o GraphQL.
- Noções básicas sobre a modelagem do GraphQL - Saiba como definir e usar fragmentos de conteúdo no Adobe Experience Manager (AEM) para usar com o GraphQL.