Definição de Modelos de fragmentos de conteúdo

Última atualização: 5 de maio de 2025
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Iniciante
  • Desenvolvedor

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

Este é um tutorial em várias partes e presume-se que um ambiente de criação do AEM esteja disponível.

Objetivos

  • 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.

  1. Fazer logon no ambiente Author do AEM (ex. https://author-pYYYY-eXXXX.adobeaemcloud.com/)

  2. Na tela inicial do AEM, navegue até Ferramentas > Geral > Navegador de Configuração.

    Navegar até o Navegador de Configuração

  3. Clique em Criar, no canto superior direito

  4. 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

    Configuração do Meu Projeto

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.

  1. Na tela inicial do AEM, navegue até Ferramentas > Geral > Modelos de fragmentos de conteúdo.

    Navegar até os modelos de fragmento de conteúdo

  2. Navegue até a pasta Meu Projeto.

  3. Toque em Criar no canto superior direito para abrir o assistente Criar Modelo.

  4. 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.

  5. 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

    Campo de propriedade Nome Completo

    O Nome da Propriedade define o nome da propriedade que é persistida 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.

  6. 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

  7. 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.

  8. 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.

    Restringir a imagens

  9. 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

  10. 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

  11. O modelo final Pessoa deve ser semelhante ao seguinte:

    Modelo Final De Pessoa

  12. 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.

  1. Na pasta Meu Projeto, toque em Criar no canto superior direito para abrir o assistente Criar Modelo.

  2. 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.

  3. 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

  4. 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 shortName nos 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.

  5. 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

  6. 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.

  7. O modelo final Equipe deve ser semelhante ao seguinte:

    Modelo final da equipe

  8. Clique em Salvar para salvar as alterações.

  9. Agora você deve ter dois modelos para trabalhar:

    Dois Modelos