Os Modelos de fragmento de conteúdo no AEM definem a estrutura do conteúdo dos fragmentos de conteúdo, servindo como base do conteúdo sem cabeçalho.
Para usar os Modelos de fragmento do conteúdo, você pode:
Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.
Navegue até a pasta apropriada para sua configuração.
Use Criar para abrir o assistente.
Se o uso de modelos de fragmento de conteúdo não tiver sido ativado, a opção Criar não estará disponível.
Especifique o título do modelo. Você também pode adicionar Tags, um Descrição, e selecionar Ativar modelo para ativar o modelo, se necessário.
Use Create 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 de modelo, você pode 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, Ativos e abra Modelos de fragmento de conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Abra o modelo necessário para Editar; 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 necessário para 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 detalhes adicionais, consulte Propriedades.
A digitação de um Rótulo do campo preencherá automaticamente o Nome da propriedade - se estiver vazio, e poderá ser atualizado manualmente posteriormente.
Ao atualizar manualmente a propriedade Nome da propriedade para um tipo de dados, observe que os nomes devem conter somente caracteres latinos, dígitos numéricos e sublinhado "_" 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 Save para manter a definição.
Uma seleção de tipos de dados está disponível para definir 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 aparecerá como uma guia.
Esse tipo de dados é usado apenas para formatação e é ignorado pelo esquema GraphQL 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 must contêm somente caracteres latinos, dígitos numéricos e sublinhado "_" como caractere especial.
Se os modelos criados em versões anteriores do AEM contiverem caracteres ilegais, remova ou atualize esses caracteres.
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 do 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 Required . 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:
Se não especificado, o valor padrão Rich Text é usado para este 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.
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.
A exclusividade é assegurada por raiz de idioma.
As variações podem ter o mesmo valor exclusivo que as variações do mesmo fragmento, mas não o mesmo valor que é 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 do 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 específicos especificados.
Permite incluir/recuperar dados estruturados.
Esse método é de especial interesse em conjunto com Entrega de conteúdo sem cabeçalho usando Fragmentos de conteúdo com GraphQL.
AEM tem proteção de recorrência para:
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:
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:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Isso é de especial interesse em conjunto com Entrega de conteúdo sem cabeçalho usando Fragmentos de conteúdo com GraphQL.
Além das propriedades padrão, você pode definir:
Renderizar como:
multicampo - 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 a 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.
Está em vigor um mecanismo de proteção contra as recorrências. Ela proíbe que o usuário selecione o Fragmento de conteúdo atual na Referência de 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 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 que ele:
Para ativar um Modelo que esteja sinalizado como:
Use a opção Ativar de:
Um modelo também pode ser desativado para que:
Para desativar um Modelo que esteja sinalizado como Ativado, use a opção Desativar de:
Para implementar a governança 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 Fragmento nessa pasta.
O mecanismo é semelhante a permitir modelos de página para uma página e seus filhos, nas propriedades avançadas de uma página.
Para configurar as Políticas para Modelos permitidos de Fragmento de Conteúdo:
Navegue e abra Propriedades para a pasta Ativos necessária.
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.
Salve as 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, Ativos e abra Modelos de fragmento de conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Selecione o modelo, seguido por Delete na barra de ferramentas.
Se o modelo for referenciado, um aviso será dado. Agir adequadamente.
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, Ativos e abra Modelos de fragmento de conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Selecione o modelo, seguido por Publish na barra de ferramentas.
O status publicado será indicado no console.
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.
Os modelos de fragmento de conteúdo podem ter a publicação cancelada se não estiverem referenciados por nenhum fragmento.
Para cancelar a publicação de um modelo de fragmento de conteúdo:
Navegue até Ferramentas, Ativos e abra Modelos de fragmento de conteúdo.
Navegue até a pasta que contém o modelo de fragmento de conteúdo.
Selecione o modelo, seguido por Cancelar publicação na barra de ferramentas.
O status publicado será indicado no console.
Você pode editar as Propriedades de um Modelo de fragmento de conteúdo: