Definição de Modelos de fragmentos de conteúdo content-fragment-models
Neste capítulo, saiba como modelar conteúdo e criar um esquema com Modelos de fragmentos de conteúdo. Você aprende sobre os diferentes tipos de dados que podem ser usados para definir um esquema como parte do modelo.
Criamos dois modelos simples, Equipe e Pessoa. O modelo de dados da Equipe tem nome, nome curto e descrição e faz referência ao modelo de dados Pessoa, que tem nome completo, biodetalhes, imagem de perfil e lista de ocupações.
Você também é bem-vindo para criar seu próprio modelo seguindo as etapas básicas e ajustar as respectivas etapas, como consultas do GraphQL e código do aplicativo React, ou simplesmente seguir as etapas descritas nestes capítulos.
Pré-requisitos prerequisites
Este é um tutorial em várias partes e presume-se que um ambiente de autor de AEM esteja disponível.
Objetivos objectives
- Crie um modelo de fragmento de conteúdo.
- Identifique os tipos de dados disponíveis e as opções de validação para criar modelos.
- Entenda como o Modelo de fragmento de conteúdo define ambos o esquema de dados e o modelo de criação de um Fragmento de conteúdo.
Criar uma configuração de projeto
Uma configuração de projeto contém todos os modelos de Fragmento de conteúdo associados a um projeto específico e fornece um meio de organizar modelos. Pelo menos um projeto deve ser criado antes de criar o Modelo de fragmento de conteúdo.
-
Fazer logon no ambiente AEM Author (ex.
https://author-pYYYY-eXXXX.adobeaemcloud.com/) -
Na tela inicial do AEM, navegue até Ferramentas > Geral > Navegador de Configuração.
-
Clique em Criar, no canto superior direito
-
Na caixa de diálogo resultante, digite:
- Título*: Meu Projeto
- Nome*: meu-projeto (prefira usar todas as letras minúsculas usando hifens para separar palavras. Essa string influencia o endpoint exclusivo do GraphQL no qual os aplicativos clientes executam solicitações.)
- Verificar Modelos de fragmentos do conteúdo
- Verificar Consultas Persistentes do GraphQL
Criar modelos de fragmentos de conteúdo
Em seguida, crie dois modelos para uma Equipe e uma Pessoa.
Criar o modelo de pessoa
Crie um modelo para uma Pessoa, que é o modelo de dados que representa uma pessoa que faz parte de uma equipe.
-
Na tela inicial do AEM, navegue até Ferramentas > Geral > Modelos de fragmentos de conteúdo.
-
Navegue até a pasta Meu Projeto.
-
Toque em Criar no canto superior direito para abrir o assistente Criar Modelo.
-
No campo Título do Modelo, digite Pessoa e toque em Criar. Na caixa de diálogo resultante, toque em Abrir para criar o modelo.
-
Arraste e solte um elemento Texto de linha única no painel principal. Insira as seguintes propriedades na guia Propriedades:
- Rótulo do campo: Nome completo
- Nome da Propriedade:
fullName - Verificar Obrigatório
O Nome da Propriedade define o nome da propriedade que é persistente no AEM. O Nome da Propriedade também define o nome chave dessa propriedade como parte do esquema de dados. Esta chave é usada quando os dados do Fragmento de conteúdo são expostos por meio de APIs do GraphQL.
-
Toque na guia Tipos de dados e arraste e solte um campo Texto de várias linhas abaixo do campo Nome completo. Insira as seguintes propriedades:
- Rótulo do Campo: Biografia
- Nome da Propriedade:
biographyText - Tipo Padrão: Rich Text
-
Clique na guia Tipos de Dados e arraste e solte um campo Referência de Conteúdo. Insira as seguintes propriedades:
- Rótulo do Campo: Imagem do Perfil
- Nome da Propriedade:
profilePicture - Caminho raiz:
/content/dam
Ao configurar o Caminho raiz, você pode clicar no ícone de pasta para exibir uma modal e selecionar o caminho. Restringe quais pastas os autores podem usar para preencher o caminho.
/content/damé a raiz na qual todas as AEM Assets (imagens, vídeos, outros fragmentos de conteúdo) são armazenadas. -
Adicione uma validação à Referência da Imagem para que somente os tipos de conteúdo de Imagens possam ser usados para preencher o campo.
-
Clique na guia Tipos de Dados e arraste e solte um tipo de dados Enumeração abaixo do campo Referência de Imagem. Insira as seguintes propriedades:
- Renderizar como: Caixas de seleção
- Rótulo do campo: Ocupação
- Nome da Propriedade:
occupation
-
Adicione várias Opções usando o botão Adicionar uma opção. Use o mesmo valor para Rótulo de Opção e Valor de Opção:
Artista, Influenciador, Fotógrafo, Viajante, Escritor, YouTuber
-
O modelo final Pessoa deve ser semelhante ao seguinte:
-
Clique em Salvar para salvar as alterações.
Criar o modelo de equipe
Crie um modelo para uma Equipe, que é o modelo de dados para uma equipe de pessoas. O modelo Equipe faz referência ao modelo Pessoa para representar os membros da equipe.
-
Na pasta Meu Projeto, toque em Criar no canto superior direito para abrir o assistente Criar Modelo.
-
No campo Título do Modelo, insira Equipe e toque em Criar.
Toque em Abrir na caixa de diálogo resultante para abrir o modelo recém-criado.
-
Arraste e solte um elemento Texto de linha única no painel principal. Insira as seguintes propriedades na guia Propriedades:
- Rótulo do campo: Título
- Nome da Propriedade:
title - Verificar Obrigatório
-
Toque na guia Tipos de dados e arraste e solte um elemento de Texto de linha única no painel principal. Insira as seguintes propriedades na guia Propriedades:
- Rótulo do Campo: Nome Curto
- Nome da Propriedade:
shortName - Verificar Obrigatório
- Verificar Exclusivo
- Em, Tipo de validação > escolha Personalizado
- Em, Regex de Validação Personalizada > insira
^[a-z0-9\-_]{5,40}$- isso garante que somente valores alfanuméricos em minúsculas e traços de 5 a 40 caracteres possam ser inseridos.
A propriedade
shortNamenos fornece uma maneira de consultar uma equipe individual com base em um caminho encurtado. A configuração Exclusivo garante que o valor seja sempre exclusivo por Fragmento de conteúdo deste modelo. -
Toque na guia Tipos de Dados e arraste e solte um campo Texto de várias linhas abaixo do campo Nome Curto. Insira as seguintes propriedades:
- Rótulo do Campo: Descrição
- Nome da Propriedade:
description - Tipo Padrão: Rich Text
-
Clique na guia Tipos de dados e arraste e solte um campo Referência de fragmento. Insira as seguintes propriedades:
- Renderizar como: Vários Campos
- Rótulo do Campo: Membros da Equipe
- Nome da Propriedade:
teamMembers - Modelos de fragmento de conteúdo permitidos: use o ícone de pasta para selecionar o modelo Pessoa.
-
O modelo final Equipe deve ser semelhante ao seguinte:
-
Clique em Salvar para salvar as alterações.
-
Agora você deve ter dois modelos para trabalhar:
Modelos de fragmento de conteúdo e configuração de projetos do Publish
Após a revisão e verificação, publique os Project Configuration e Content Fragment Model
-
Na tela inicial do AEM, navegue até Ferramentas > Geral > Navegador de Configuração.
-
Toque na caixa de seleção ao lado de Meu projeto e toque em Publish
-
Na tela inicial do AEM, navegue até Ferramentas > Geral > Modelos de fragmentos de conteúdo.
-
Navegue até a pasta Meu Projeto.
-
Toque nos modelos Pessoa e Equipe e toque em Publish
Parabéns. congratulations
Parabéns, você acabou de criar seus primeiros modelos de fragmento de conteúdo!
Próximas etapas next-steps
No próximo capítulo, Criação de modelos de fragmento de conteúdo, você cria e edita um novo fragmento de conteúdo com base em um modelo de fragmento de conteúdo. Você também aprenderá a criar variações de Fragmentos de conteúdo.