DocumentaçãoAEMGuia do usuário

[AEM Sites]{class="badge positive" title="Aplicável ao AEM Sites)."}

Definição de Modelos de fragmentos de conteúdo defining-content-fragment-models

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

Criado para:

  • User
  • Developer

Os modelos de fragmento de conteúdo no Adobe Experience Manager (AEM) as a Cloud Service definem a estrutura do conteúdo dos seus fragmentos de conteúdo. Esses fragmentos podem ser usados para criação de página ou como base para o conteúdo headless.

Esta página aborda como definir o modelo de fragmento de conteúdo usando o editor dedicado. Consulte Gerenciamento de modelos de fragmento de conteúdo para obter mais tarefas e opções disponíveis após a criação dos fragmentos, incluindo ações disponíveis no Console de Fragmentos de conteúdo, permissão do modelo na sua pasta e publicação do seu modelo.

NOTE
Esteja ciente das Práticas recomendadas ao trabalhar com os modelos de fragmento de conteúdo e fragmentos de conteúdo.
CAUTION
Se você estiver consultando vários fragmentos referenciados, não é recomendável que os vários modelos de fragmento tenham nomes de campo com o mesmo nome, mas tipos diferentes.
Para obter mais detalhes, consulte a API do AEM GraphQL para uso com Fragmentos de conteúdo - Limitações
NOTE
Se criar um modelo com esse novo editor, você sempre deve usar esse editor para esse modelo.
Se você abrir o modelo com o editor de modelo original, verá a mensagem:
  • "Este modelo tem um esquema de interface do usuário personalizado configurado. A ordem dos campos exibidos nesta interface pode não corresponder ao esquema da interface do usuário. Para exibir os campos alinhados ao esquema da interface do usuário, é necessário alternar para o novo Editor de fragmento de conteúdo."

Definição do Modelo de fragmento de conteúdo defining-your-content-fragment-model

O modelo de fragmento de conteúdo define efetivamente a estrutura dos fragmentos de conteúdo resultantes usando uma seleção de Tipos de dados. Usando o editor do modelo, é possível adicionar instâncias dos tipos de dados e configurá-las para criar os campos necessários:

CAUTION
A edição de um modelo que já é usado pelos Fragmentos de conteúdo existentes pode afetar esses fragmentos dependentes.

  1. No Console de fragmentos de conteúdo, selecione o painel para Modelos de fragmentos de conteúdo e navegue até a pasta que contém seu modelo de fragmento de conteúdo.

    note
    NOTE
    Você também pode abrir um modelo diretamente após criá-lo.

  2. Abra o modelo necessário para Editar; use um dos links de ação rápida ou selecione o modelo e depois a ação na barra de ferramentas.

    Propriedades

    Uma vez aberto, o editor de modelo mostra:

    • início:

      • Ícone da Página inicial
      • opção para alternar entre o original e o novo editor
      • Cancelar
      • Salvar

    • à esquerda: Tipos de dados disponíveis para criar campos

    • meio: campos já definidos junto com a opção Adicionar

    • à direita: usando os ícones na extremidade direita, você pode selecionar entre:

      • Propriedades: defina e exiba propriedades para o campo selecionado
      • Detalhes do modelo: mostrar o status Habilitado, Título do Modelo, Marcas, Descrição e Visualizar URL

  3. Para adicionar um campo

    • Ou:

      • Arraste um tipo de dados do painel esquerdo para o local necessário para um campo no painel central.
      • Selecione o ícone + por um Tipo de Dados para adicioná-lo à parte inferior da lista de campos.
      • Selecione Adicionar no painel do meio e o tipo de dados necessário na lista suspensa resultante para adicionar um campo à parte inferior da lista.
      note
      NOTE
      Os campos de espaço reservado para tabulação devem sempre aparecer acima dos campos existentes.

    • É possível reposicionar um campo usando a formação de pontos à esquerda da caixa de campo:

      Mover campo

    • Depois que um campo é adicionado ao modelo (e é selecionado), o painel direito mostra as Propriedades que podem ser definidas para esse tipo de dados específico. Aqui é possível definir o que é necessário para a
      campo.

      • Muitas propriedades são autoexplicativas. Para obter mais detalhes, consulte Propriedades (Tipos de Dados).

      • Digitar um Rótulo de Campo preenche automaticamente o Nome da Propriedade, se estiver vazio, e pode ser atualizado manualmente posteriormente.

        note caution
        CAUTION
        Ao atualizar manualmente a propriedade Nome da Propriedade para um tipo de dados, os nomes devem conter somente A-Z, a-z, 0-9 e um sublinhado "_" como caractere especial.
        Se os modelos criados em versões anteriores do AEM contiverem caracteres ilegais, remova ou atualize esses caracteres.

      Por exemplo:

      Propriedades do campo

      note
      NOTE
      Quando um campo é definido como Obrigatório, o Rótulo indicado no painel do meio é marcado com um asterisco (*).

  4. Para remover um campo

    Selecione o ícone da lixeira do campo apropriado no painel do meio.

    Remover

  5. Adicione todos os campos obrigatórios e defina as propriedades relacionadas, conforme necessário.

  6. Selecione Salvar para salvar a definição.

Tipos de dados data-types

Uma variedade de tipos de dados está disponível para a definição do seu modelo:

  • Texto em linha única

    • Adicionar um campo para uma única linha de texto; o comprimento máximo pode ser definido
    • O campo pode ser configurado para permitir que os autores de fragmento criem novas instâncias do campo

  • Texto multilinha

    • Uma área de texto que pode ser Rich Text, Texto sem formatação ou Markdown
    • O campo pode ser configurado para permitir que os autores de fragmento criem novas instâncias do campo
    note
    NOTE
    Se a área de texto é Rich Text, Texto sem formatação ou Markdown, é definida no modelo pela propriedade Tipo padrão.
    Este formato não pode ser alterado do editor de Fragmento de Conteúdo, mas somente do Modelo.

  • Número

    • Adicionar um campo numérico
    • O campo pode ser configurado para permitir que os autores de fragmento criem novas instâncias do campo

  • Booleano

    • Adicionar uma caixa de seleção booleana

  • Data e hora

    • Adicionar um campo de data e/ou hora

  • Enumeração

    • Adicionar um conjunto de caixas de seleção, botões de opção ou campos suspensos
      • É possível especificar as opções disponíveis para o autor do fragmento

  • Tags

    • Permite que os autores de fragmentos acessem e selecionem áreas de tags

  • Referência do fragmento

    • Faz referência a outros fragmentos de conteúdo; pode ser usado para criar conteúdo aninhado

    • O tipo de dados pode ser configurado para permitir que os autores de fragmento:

      • Editem o fragmento referenciado diretamente.
      • Crie um novo Fragmento de conteúdo, com base no modelo apropriado
      • Criar novas instâncias do campo

    • A referência especifica o caminho para o recurso referenciado; por exemplo /content/dam/path/to/resource

    note
    NOTE
    O AEM tem proteção de recorrência para:

    • Referências de conteúdo> Isso impede que o usuário adicione uma referência ao fragmento atual e pode resultar em uma caixa de diálogo vazia do seletor de Referências de fragmento.

    • Referências de fragmento no GraphQL> Se você criar uma consulta profunda que retorna vários Fragmentos de conteúdo referenciados entre si, ela retornará um valor nulo na primeira ocorrência.
    note caution
    CAUTION
    Se você estiver consultando vários fragmentos referenciados, não é recomendável que os vários modelos de fragmento tenham nomes de campo com o mesmo nome, mas tipos diferentes.
    Para obter mais detalhes, consulte a API do AEM GraphQL para uso com Fragmentos de conteúdo - Limitações

    Referência de conteúdo content-reference

    O tipo de dados Referência de Conteúdo permite renderizar o conteúdo de outra fonte; por exemplo, imagem, página ou Fragmento de Experiência.

    Além das propriedades padrão, é possível especificar:

    • O Caminho Raiz, que especifica ou representa onde armazenar qualquer conteúdo referenciado

      note
      NOTE
      Isso é obrigatório se você quiser fazer upload diretamente e fazer referência a imagens nesse campo ao usar o editor de fragmentos de conteúdo.
      Consulte Referenciar imagens para obter mais detalhes.

    • Os tipos de conteúdo que podem ser referenciados

      note
      NOTE
      Eles devem incluir Imagem se você quiser carregar e fazer referência diretamente a imagens nesse campo ao usar o editor de Fragmento de conteúdo.
      Consulte Referenciar imagens para obter mais detalhes.

    • Limitações para tamanhos de arquivo

    • Se uma imagem for referenciada:

      • Mostrar miniatura
      • Restrições de altura e largura da imagem

    Referência de conteúdo

    Referência de fragmento (fragmentos aninhados) fragment-reference-nested-fragments

    O tipo de dados Referência de fragmento pode fazer referência a um ou mais Fragmentos de conteúdo. Esse recurso é especialmente interessante ao recuperar conteúdo para uso no aplicativo, pois permite recuperar dados estruturados com várias camadas.

    Por exemplo:

    • Um modelo que define os detalhes de um funcionário, incluindo:
      • Uma referência ao modelo que define o empregador (empresa)
    code language-xml 
    type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
    note
    NOTE
    As Referências de fragmento são de especial interesse para Entrega de conteúdo headless usando fragmentos de conteúdo com o GraphQL.

    Além das propriedades padrão, você pode definir:

    • Renderizar como:

      • multifield — o autor do fragmento pode criar várias referências individuais

      • fragmentreference — permite que o autor do fragmento selecione uma única referência a um fragmento

    • Tipo de modelo
      Vários modelos podem ser selecionados. Ao adicionar referências a um fragmento de conteúdo, todos os fragmentos referenciados devem ter sido criados usando esses modelos.

    • Caminho raiz
      Especifica ou representa um caminho raiz para qualquer fragmento referenciado.

    • Permitir criação de fragmentos

      Isso permite que o autor do fragmento crie um fragmento com base no modelo apropriado.

      • fragmentreferencecomposite — permite que o autor do fragmento crie uma composição ao selecionar vários fragmentos

      Referência do fragmento

    note
    NOTE
    Um mecanismo de proteção contra recorrências está em vigor. Ele proíbe que o usuário selecione o fragmento de conteúdo atual na referência do fragmento e pode levar a uma caixa de diálogo vazia do seletor de referência de fragmento.
    Também há proteção de recorrência para referências de fragmento no GraphQL. Se você criar uma consulta profunda em dois Fragmentos de conteúdo que fazem referência um ao outro, ela retornará um valor nulo.
recommendation-more-help
experience-manager-cloud-service-help-main-toc