Modelos de fragmentos do conteúdo

Os Modelos de fragmento de conteúdo definem a estrutura do conteúdo para seus fragmentos de conteúdo.

Para usar os Modelos de fragmento de conteúdo, faça o seguinte:

  1. Ativar a funcionalidade do Modelo de fragmento de conteúdo para sua instância
  2. Crie e configure seus Modelos de fragmento de conteúdo
  3. Ative seus Modelos de fragmento de conteúdo para uso ao criar Fragmentos de conteúdo para uso ao criar Fragmentos de conteúdo
  4. Permita seus Modelos de fragmento de conteúdo nas pastas de Ativos necessárias, configurando Políticas.

Criação de um modelo de fragmento de conteúdo

  1. Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.

  2. Navegue até a pasta apropriada para sua configuração.

  3. Use Criar para abrir o assistente.

    CUIDADO

    Se o uso de modelos de fragmento de conteúdo não tiver sido ativado, a opção Criar não estará disponível.

  4. Especifique o título do modelo. Você também pode adicionar Tags, uma Descrição e selecionar Ativar modelo para ativar o modelo, se necessário.

    título e descrição

  5. Use Create para salvar o modelo vazio. Uma mensagem indicará o sucesso da ação. Você pode selecionar Abrir para editar imediatamente o modelo ou Concluído para retornar ao console.

Definição do modelo de fragmento de conteúdo

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 de modelo, você pode adicionar instâncias dos tipos de dados e configurá-las para criar os campos necessários:

CUIDADO

Editar um modelo de fragmento de conteúdo existente pode afetar fragmentos dependentes.

  1. Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.

  2. Navegue até a pasta que contém o modelo de fragmento do conteúdo.

  3. Abra o modelo necessário para Editar; use a ação rápida ou selecione o modelo e a ação na barra de ferramentas.

    Depois de abrir o editor de modelo, é mostrado:

    • esquerda: campos já definidos
    • direito: Tipos de dados disponíveis para criar campos (e Propriedades para uso depois que os campos forem criados)
    OBSERVAÇÃO

    Quando um campo é Obrigatório, o Rótulo indicado no painel à esquerda é marcado com um asterisco (*).

    propriedades

  4. Para adicionar um campo

    • Arraste um tipo de dados necessário para o local necessário para um campo:

      tipo de dados para campo

    • Depois que um campo for adicionado ao modelo, o painel direito mostrará as Propriedades que podem ser definidas para esse tipo de dados específico. Aqui você pode definir o que é necessário para esse campo.

      • Muitas propriedades são autoexplicativas, para obter detalhes adicionais, consulte Propriedades.
      • Digitar um Rótulo de campo preencherá automaticamente o Nome da propriedade - se estiver vazio, e poderá ser atualizado manualmente posteriormente.

      Por exemplo:

      propriedades do campo

  5. Como remover um campo

    Selecione o campo desejado e clique/toque no ícone lixeira. Você receberá uma solicitação para confirmar a ação.

    remover

  6. Adicione todos os campos obrigatórios e defina as propriedades relacionadas, conforme necessário. Por exemplo:

    save

  7. Selecione Salvar para persistir na definição.

Tipos de dados

Uma seleção de tipos de dados está disponível para definir seu modelo:

  • Texto em linha única
    • Adicione um ou mais campos de uma única linha de texto; o comprimento máximo pode ser definido
  • Texto multilinha
    • Uma área de texto que pode ser Rich Text, Plain Text ou Markdown
  • Número
    • Adicionar um ou mais campos numéricos
  • Booleano
    • Adicionar uma caixa de seleção booleana
  • Data e hora
    • Adicionar uma data e/ou hora
  • Enumeração
    • Adicionar um conjunto de caixas de seleção, botões de opção ou campos suspensos
  • Tags
    • Permite que os autores de fragmentos acessem e selecionem áreas de tags
  • Referência de conteúdo
  • Referência do fragmento
    • Refere 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 fragmentos:
      • Edite o fragmento referenciado diretamente.
      • Criar um novo fragmento de conteúdo, com base no modelo apropriado
  • Objeto JSON
    • Permite que o autor do fragmento de conteúdo insira a sintaxe JSON nos elementos correspondentes de um fragmento.
      • Para permitir que AEM armazene JSON direto que você tenha copiado/colado de outro serviço.
      • O JSON será transmitido e sairá como JSON no GraphQL.
      • Inclui o realce da sintaxe JSON, o preenchimento automático e o realce de erros no editor de fragmentos de conteúdo.

Propriedades

Muitas propriedades são autoexplicativas, para certas propriedades, mais detalhes são os seguintes:

  • Renderizar
    comoAs várias opções para realizar/renderizar o campo em um fragmento. Geralmente, isso permite definir se o autor verá uma única instância do campo ou poderá criar várias instâncias.

  • Rótulo
    do campoInserir um
    O Rótulo de campo gerará automaticamente um Nome de propriedade, que pode ser atualizado manualmente se necessário.

  • A validação
    ValidationBasic está disponível por mecanismos como a propriedade ​Requirements. Alguns tipos de dados têm campos de validação de adição. Consulte Validação para obter mais detalhes.

  • No tipo de dados Texto de várias linhas, é possível definir o Tipo padrão como:

    • Texto formatado
    • Markdown
    • Texto sem formatação

    Se não for especificado, o valor padrão Rich Text será usado para esse campo.

    Alterar o Tipo padrão em um modelo de fragmento de conteúdo só terá efeito em um fragmento de conteúdo existente relacionado depois que esse fragmento for aberto no editor e salvo.

  • O
    UniqueContent (para o campo específico) deve ser exclusivo em todos os fragmentos de conteúdo criados a partir do modelo atual.

    Isso é usado para garantir que os autores de conteúdo não possam repetir o conteúdo já adicionado em outro fragmento do mesmo modelo.

    Por exemplo, um campo Texto de linha única chamado Country no Modelo de fragmento de conteúdo não pode ter o valor Japan em dois Fragmentos de conteúdo dependentes. Um aviso será emitido quando a segunda instância for tentada.

    OBSERVAÇÃO

    A exclusividade é garantida por raiz linguística.

    OBSERVAÇÃO

    As variações podem ter o mesmo valor exclusivo que as variações do mesmo fragmento, mas não o mesmo valor que o usado em qualquer variação de outros fragmentos.


  • TraduzívelMarcar a caixa de seleção "Traduzível" em um campo no editor de modelo CF

    • Verifique se o nome da propriedade do campo foi adicionado na configuração de conversão, context /content/dam/<tenant>, se ainda não estiver presente.
    • Para GraphQL: defina uma propriedade <translatable> no campo Fragmento de conteúdo como yes, para permitir o filtro de query GraphQL para saída JSON com apenas conteúdo traduzível.
  • Consulte Referência do fragmento (Fragmentos aninhados) para obter mais detalhes sobre esse tipo de dados específico e suas propriedades.

Validação

Vários tipos de dados agora incluem a possibilidade de definir requisitos de validação para quando o conteúdo é inserido no fragmento resultante:

  • Texto em linha única
    • Compare com um regex predefinido.
  • Número
    • Verifique valores específicos.
  • Referência de conteúdo
    • Teste tipos específicos de conteúdo.
    • Somente ativos com tamanho de arquivo especificado ou menor podem ser referenciados.
    • Somente as imagens em um intervalo predefinido de largura e/ou altura (em pixels) podem ser referenciadas.
  • Referência do fragmento
    • Teste um modelo de fragmento de conteúdo específico.

Usando referências para formar Conteúdo aninhado

Fragmentos de conteúdo podem formar conteúdo aninhado, usando um dos seguintes tipos de dados:

  • Referência de conteúdo

    • Fornece uma referência simples a outro conteúdo; de qualquer tipo.
    • Pode ser configurado para uma ou várias referências (no fragmento resultante).
  • Referência de fragmento (fragmentos aninhados)

OBSERVAÇÃO

AEM tem uma proteção de recorrência para:

  • Referências de conteúdo
    Isso impede que o usuário adicione uma referência ao fragmento atual. Isso pode levar a uma caixa de diálogo vazia do seletor de Referência de fragmento.
  • Referências de fragmento no GraphQL
    Se você criar um query profundo que retorna vários Fragmentos de conteúdo referenciados entre si, ele retornará null na primeira ocorrência.

Referência de conteúdo

A Referência de conteúdo permite renderizar o conteúdo de outra fonte; por exemplo, imagem ou fragmento de conteúdo.

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

  • O Caminho raiz para qualquer conteúdo referenciado.
  • Os tipos de conteúdo que podem ser referenciados.
  • Limitações para tamanhos de arquivo.
  • Restrições de imagem. Referência de conteúdo

Referência do fragmento (fragmentos aninhados)

A Referência do fragmento faz referência a um ou mais fragmentos de conteúdo. Esse recurso de especial interesse ao recuperar conteúdo para uso no aplicativo, pois permite recuperar dados estruturados com várias camadas.

Por exemplo:

  • Um modelo que define detalhes para um funcionário; eles incluem:
    • Uma referência ao modelo que define o empregador (empresa)
type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
OBSERVAÇÃO

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

  • Renderizar como:

    • vários campos - o autor do fragmento pode criar várias referências, individuais

    • referência de fragmento - permite que o autor do fragmento selecione uma única referência para um fragmento

  • Modelo
    TipoVários modelos podem ser selecionados. Ao criar o Fragmento de conteúdo, qualquer fragmento referenciado deve ter sido criado usando esses modelos.

  • Caminho
    raizEspecifica um caminho raiz para qualquer fragmento referenciado.

  • Permitir criação de fragmentos

    Isso permitirá que o autor do fragmento crie um novo fragmento com base no modelo apropriado.

    • fragmentreferencecomposite - permite que o autor do fragmento crie um composto, selecionando vários fragmentos

    Referência do fragmento

OBSERVAÇÃO

Existe um mecanismo de proteção contra recorrências. Ela proíbe que o usuário selecione o Fragmento de conteúdo atual na Referência do fragmento. Isso pode levar a uma caixa de diálogo vazia do seletor de Referência de fragmento.
Também há uma proteção de recorrência para Referências de fragmento no GraphQL. Se você criar um query profundo em dois Fragmentos de conteúdo que fazem referência uns aos outros, ele retornará um valor nulo.

Ativar ou desativar um modelo de fragmento de conteúdo

Para ter total controle sobre o uso dos Modelos de fragmento de conteúdo, eles têm um status que pode ser definido.

Habilitar um modelo de fragmento de conteúdo

Depois que um modelo é criado, ele precisa ser habilitado para que:

  • Está disponível para seleção ao criar um novo Fragmento de conteúdo.
  • Pode ser referenciado em um Modelo de fragmento de conteúdo.
  • Está disponível para GraphQL; então o schema é gerado.

Para habilitar um Modelo sinalizado como:

  • Rascunho : mew (nunca ativado).
  • Desativado : foi especificamente desativado.

Use a opção Ativar de:

  • A barra de ferramentas superior, quando o Modelo necessário for selecionado.
  • A Ação rápida correspondente (passe o mouse sobre o Modelo necessário).

Ativar um rascunho ou modelo desativado

Desabilitando um Modelo de Fragmento de Conteúdo

Um modelo também pode ser desativado para que:

  • O modelo não está mais disponível como base para a criação de novos Fragmentos de conteúdo.
  • No entanto:
    • O schema GraphQL continua sendo gerado e ainda pode ser consultado (para evitar o impacto da API JSON).
    • Todos os Fragmentos de conteúdo baseados no modelo ainda podem ser consultados e retornados do ponto de extremidade GraphQL.
  • O modelo não pode mais ser referenciado, mas as referências existentes são mantidas intocadas e ainda podem ser consultadas e retornadas do ponto final GraphQL.

Para desativar um Modelo sinalizado como Ativado, use a opção Desativar de:

  • A barra de ferramentas superior, quando o Modelo necessário for selecionado.
  • A Ação rápida correspondente (passe o mouse sobre o Modelo necessário).

Desativar um modelo ativado

Permitir modelos de fragmento de conteúdo na pasta Ativos

Para implementar o gerenciamento de conteúdo, você pode configurar Policies na pasta Assets para controlar quais modelos de fragmento de conteúdo são permitidos para a criação de fragmentos nessa pasta.

OBSERVAÇÃO

O mecanismo é semelhante a permitir modelos de página para uma página, e seus filhos, em propriedades avançadas de uma página.

Para configurar Policies para Modelos de fragmento de conteúdo permitidos:

  1. Navegue e abra Propriedades para a pasta Ativos necessária.

  2. Abra a guia Policies, onde você pode configurar:

    • Herdado de<folder>

      As políticas são automaticamente herdadas ao criar novas pastas secundárias; a política pode ser reconfigurada (e a herança quebrada) se as subpastas precisarem permitir modelos diferentes da pasta pai.

    • Modelos de fragmento de conteúdo permitidos por caminho

      Vários modelos podem ser permitidos.

    • Modelos de fragmento de conteúdo permitidos por tag

      Vários modelos podem ser permitidos.
      Política do modelo de fragmento de conteúdo

  3. ​Salve as alterações.

Os Modelos de fragmento de conteúdo permitidos para uma pasta são resolvidos da seguinte forma:

  • As Políticas para Modelos de fragmento de conteúdo permitidos.
  • Se estiver vazio, tente determinar a política usando as regras de herança.
  • Se a cadeia de herança não fornecer um resultado, verifique a configuração Cloud Services dessa pasta (também primeiro diretamente e depois por herança).
  • Se nenhuma das opções acima apresentar resultados, não haverá modelos permitidos para essa pasta.

Excluindo um modelo de fragmento de conteúdo

CUIDADO

A exclusão de um modelo de fragmento de conteúdo pode afetar fragmentos dependentes.

Para excluir um modelo de fragmento de conteúdo:

  1. Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.

  2. Navegue até a pasta que contém o modelo de fragmento do conteúdo.

  3. Selecione seu modelo, seguido por Excluir na barra de ferramentas.

    OBSERVAÇÃO

    Se o modelo for referenciado, um aviso será dado. Agir adequadamente.

Publicar um modelo de fragmento de conteúdo

Os modelos de fragmento de conteúdo precisam ser publicados quando/antes que qualquer fragmento de conteúdo dependente seja publicado.

Para publicar um modelo de fragmento de conteúdo:

  1. Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.

  2. Navegue até a pasta que contém o modelo de fragmento do conteúdo.

  3. Selecione seu modelo, seguido por Publicar na barra de ferramentas.
    O status publicado será indicado no console.

    OBSERVAÇÃO

    Se você publicar um fragmento de conteúdo para o qual o modelo ainda não foi publicado, uma lista de seleção indicará isso e o modelo será publicado com o fragmento.

Cancelamento de publicação de um modelo de fragmento de conteúdo

Os modelos de fragmento de conteúdo podem ser despublicados se não forem referenciados por nenhum fragmento.

Para cancelar a publicação de um modelo de fragmento de conteúdo:

  1. Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.

  2. Navegue até a pasta que contém o modelo de fragmento do conteúdo.

  3. Selecione seu modelo, seguido por Cancelar a publicação na barra de ferramentas.
    O status publicado será indicado no console.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free