Os modelos de fragmento de conteúdo no AEM definem a estrutura do conteúdo para o seu fragmentos de conteúdo, como base do seu conteúdo headless.
Para usar modelos de fragmento de conteúdo, você pode:
Navegue até Ferramentas, Assets, em seguida, abrir Modelos de fragmentos do conteúdo.
Navegue até a pasta apropriada ao seu configuração.
Use Criar para abrir o assistente.
Se o uso de modelos de fragmento de conteúdo não foi habilitado, a opção Criar não estará disponível.
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.
Use Criar para salvar o modelo vazio. Uma mensagem indicará o sucesso da ação. Você poderá selecionar Abrir para editar imediatamente o modelo, ou Concluído para retornar ao console.
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:
A edição de um modelo de fragmento de conteúdo existente pode afetar fragmentos dependentes.
Navegue até Ferramentas, Assets, em seguida, abrir Modelos de fragmentos do conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Abra o modelo necessário para Edição; use a ação rápida ou selecione o modelo e depois a ação na barra de ferramentas.
Uma vez aberto, o editor de modelo mostra:
Quando um campo é Obrigatório, o Rótulo indicado no painel à esquerda é marcado com um asterisco (*).
Para adicionar um campo
Arraste um tipo de dados necessário para o local exigido de um campo:
Depois que um campo é adicionado ao modelo, o painel direito mostrará as Propriedades que podem ser definidas para esse tipo de dados específico. Aqui é possível definir o que é necessário para esse campo.
Muitas propriedades são autoexplicativas. Para obter mais detalhes, consulte Propriedades.
Digitar um Rótulo de campo preencherá automaticamente o Nome da propriedade se estiver vazio, e pode ser atualizado manualmente posteriormente.
Ao atualizar manualmente a propriedade Nome da propriedade de um tipo de dados, observe que os nomes devem conter somente caracteres latinos (A-Z, a-z), dígitos numéricos (0-9) e o underline (“_”) como caractere especial.
Se os modelos criados em versões anteriores do AEM contiverem caracteres ilegais, remova ou atualize esses caracteres.
Por exemplo:
Para remover um campo
Selecione o campo desejado e clique/toque no ícone da lixeira. Você receberá uma solicitação para confirmar a ação.
Adicione todos os campos obrigatórios e defina as propriedades relacionadas, conforme necessário. Por exemplo:
Selecione Salvar para salvar a definição.
Uma variedade de tipos de dados está disponível para a definição do seu modelo:
Permite a introdução de guias para uso ao editar o conteúdo do fragmento de conteúdo.
Isso será mostrado como um divisor no editor de modelo, separando seções da lista de tipos de dados de conteúdo. Cada instância representa o início de uma nova guia.
No editor de fragmentos, cada instância será exibida como uma guia.
Esse tipo de dados é usado apenas para formatação e é ignorado pelo esquema GraphQL do AEM.
Muitas propriedades são autoexplicativas. Para certas propriedades, os detalhes adicionais são os seguintes:
Nome da Propriedade
Ao atualizar manualmente essa propriedade para um tipo de dados, observe que os nomes devem conter somente caracteres latinos (A-Z, a-z), dígitos numéricos (0-9) e o underline (“_”) como caractere especial.
Se os modelos criados em versões anteriores do AEM contiverem caracteres ilegais, remova ou atualize esses caracteres.
Renderizar como
As 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 se poderá criar várias instâncias.
Rótulo de campo
Inserir um
rótulo de campo gerará automaticamente um nome de propriedade, que pode ser atualizado manualmente se necessário.
Validação
A validação básica está disponível por meio de mecanismos como a propriedade Obrigatório. 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 multilinha, é possível definir o Tipo padrão como:
Se não for especificado, o valor padrão Rich Text é 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.
Exclusivo
O conteúdo (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 de 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 na tentativa da segunda instância.
A exclusividade é assegurada por raiz de idioma.
As variações podem ter o mesmo valor exclusivo como variações do mesmo fragmento, mas não o mesmo valor usado em qualquer variação de outros fragmentos.
Consulte Referência de conteúdo para obter mais detalhes sobre esse tipo de dados específico e suas propriedades.
Consulte Referência de fragmento (fragmentos aninhados) para obter mais detalhes sobre esse tipo de dados específico e suas propriedades.
Vários tipos de dados agora incluem a possibilidade de definir requisitos de validação para quando o conteúdo é inserido no fragmento resultante:
Os fragmentos de conteúdo podem formar conteúdo aninhado, usando um dos seguintes tipos de dados:
Referência de fragmento (fragmentos aninhados)
Faz referência a outros fragmentos, dependendo dos modelos especificados.
Permite incluir/recuperar dados estruturados.
Este método é especialmente interessante quando utilizado em conjunto com a Entrega de conteúdo headless usando fragmentos de conteúdo com GraphQL.
O AEM tem proteção de recorrência para:
Referências do conteúdo
Isso impede que o usuário adicione uma referência ao fragmento atual. Isso pode resultar em uma caixa de diálogo vazia do seletor de referência de fragmento.
Referências de fragmento no GraphQL
Se você criar uma consulta profunda que retorna vários fragmentos de conteúdo referenciados uns pelos outros, ele retornará um valor nulo na primeira ocorrência.
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, é possível especificar:
A referência do fragmento faz 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:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Isso é especialmente interessante em conjunto com a 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 criar o fragmento de conteúdo, qualquer fragmento referenciado deve ter sido criado usando esses modelos.
Caminho raiz
Especifica 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.
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. Isso pode resultar em 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 em 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.
Para ter controle total sobre o uso dos modelos de fragmento de conteúdo, eles têm um status que pode ser definido.
Depois que um modelo é criado, ele precisa ser ativado para:
Para ativar um modelo que esteja sinalizado como:
Você usa a opção Ativar a partir:
Um modelo também pode ser desativado para que:
Para desativar um Modelo que esteja sinalizado como Ativado, você usa a opção Desativar:
Para implementar a governança de conteúdo, você pode configurar Políticas na pasta de ativos para controlar quais modelos de fragmento de conteúdo são permitidos na criação de fragmentos dessa pasta.
O mecanismo é semelhante ao de permitir modelos de página para uma página e suas derivadas nas suas propriedades avançadas.
Para configurar as políticas para modelos de fragmento de conteúdo permitidos:
Navegue e abra as Propriedades da pasta de ativos necessária.
Abra a guia Políticas, onde é possível configurar:
Herdado de<folder>
As políticas são automaticamente herdadas ao criar novas pastas derivadas; a política pode ser reconfigurada (e a herança quebrada) se as subpastas precisarem permitir modelos diferentes da pasta principal.
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.
Salve quaisquer alterações.
Os modelos de fragmento de conteúdo permitidos para uma pasta são resolvidos da seguinte maneira:
A exclusão de um modelo de fragmento de conteúdo pode afetar fragmentos dependentes.
Para excluir um modelo de fragmento de conteúdo:
Navegue até Ferramentas, Assets, em seguida, abrir Modelos de fragmentos do conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Selecione seu modelo e, em seguida, Excluir na barra de ferramentas.
Se o modelo for referenciado, um aviso será exibido. Tome as medidas apropriadas.
Os modelos de fragmento de conteúdo precisam ser publicados quando/antes de qualquer fragmento de conteúdo dependente ser publicado.
Para publicar um modelo de fragmento de conteúdo:
Navegue até Ferramentas, Assets, em seguida, abrir Modelos de fragmentos do conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Selecione seu modelo e, em seguida, Publicar na barra de ferramentas.
O status publicado será exibido no console.
Se você publicar um fragmento de conteúdo cujo modelo ainda não foi publicado, uma lista de seleção indicará isso e o modelo será publicado junto com o fragmento.
Os modelos de fragmento de conteúdo podem ter sua publicação desfeita se não forem referenciados por nenhum fragmento.
Para desfazer a publicação de um modelo de fragmento de conteúdo:
Navegue até Ferramentas, Assets, em seguida, abrir Modelos de fragmentos do conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Selecione seu modelo e, em seguida, Desfazer publicação na barra de ferramentas.
O status publicado será exibido no console.
É possível editar as Propriedades de um modelo do fragmento de conteúdo: