Personalização e extensão de fragmentos de conteúdo customizing-and-extending-content-fragments

Criação e gerenciamento de fragmentos de conteúdo e Criação de página com fragmentos de conteúdo para obter mais informações sobre fragmentos de conteúdo.

Gerenciamento de ativos e Personalização e extensão de ativos para obter mais informações sobre ativos padrão.

Modelos de fragmentos do conteúdo:

• Usado para definir fragmentos de conteúdo que possuem conteúdo estruturado.
• Os modelos de fragmento de conteúdo definem a estrutura de um fragmento de conteúdo quando ele é criado.
• Um fragmento faz referência ao modelo; portanto, as alterações no modelo podem/afetarão qualquer fragmento dependente.
• Os modelos são incorporados aos tipos de dados.
• As funções para adicionar novas variações, etc., precisam atualizar o fragmento adequadamente.

Modelos de fragmentos de conteúdo:

• Usado para definir fragmentos de conteúdo simples.
• Os modelos definem a estrutura (básica, somente texto) de um fragmento de conteúdo quando ele é criado.
• O modelo é copiado para o fragmento ao ser criado; assim, novas alterações no modelo não serão refletidas nos fragmentos existentes.
• As funções para adicionar novas variações, etc., precisam atualizar o fragmento adequadamente.
• Modelos de fragmento de conteúdo funcionem de forma diferente da de outros mecanismos de modelização no ecossistema de AEM (por exemplo, modelos de página, etc.). Por conseguinte, devem ser consideradas separadamente.
• Quando baseado em um modelo, o tipo MIME do conteúdo é gerenciado no conteúdo real; isso significa que cada elemento e variação podem ter um tipo MIME diferente.

Todo o conteúdo é armazenado na variável jcr:content/data nó do ativo:

• Os dados do elemento são armazenados no subnó principal :

  jcr:content/data/master

• As variações são armazenadas em um subnó que leva o nome da variação:

  por exemplo jcr:content/data/myvariation

• Os dados de cada elemento são armazenados no respectivo subnó como uma propriedade com o nome do elemento:

  por exemplo, o conteúdo do elemento text é armazenado como propriedade text on jcr:content/data/master

Os metadados e o conteúdo associado são armazenados abaixo jcr:content/metadata

Exceto o título e a descrição, que não são considerados metadados tradicionais e armazenados em jcr:content

Todas as informações não relacionadas ao conteúdo de um fragmento (como título, descrição, metadados, estrutura) são gerenciadas exclusivamente no ativo principal.

O conteúdo do primeiro elemento de um fragmento é mapeado para a representação original do ativo principal.

• As variações (se houver) do primeiro elemento são mapeadas para outras representações do ativo principal.

Elementos adicionais (se existirem) são mapeados para subativos do ativo principal.

• O conteúdo principal desses elementos adicionais mapeia para a representação original do respectivo subativo.
• Outras variações (se aplicável) de quaisquer elementos adicionais são mapeadas para outras representações do respectivo subativo.

O componente usa o fragmentPath propriedade para fazer referência ao fragmento de conteúdo real. O fragmentPath Os bens sejam tratados da mesma forma que as propriedades similares de outros tipos de ativos; por exemplo, quando o fragmento de conteúdo é movido para outro local.

O componente permite selecionar a variação a ser exibida.

Além disso, um intervalo de parágrafos pode ser selecionado para restringir a saída; por exemplo, isso pode ser usado para saída de várias colunas.

O componente permite conteúdo intermediário:

• Aqui, o componente permite colocar outros ativos (imagens, etc.) entre os parágrafos do fragmento referenciado.

  • Para conteúdo intermediário, é necessário:

    • Estar ciente da possibilidade de referências instáveis; o conteúdo intermediário (adicionado ao criar uma página) não tem relacionamento fixo com o parágrafo ao lado do qual está posicionado, inserindo um novo parágrafo (no editor de fragmentos de conteúdo) antes que a posição do conteúdo intermediário possa perder a posição relativa
      • considere os parâmetros adicionais (como variação e filtros de parágrafo) para evitar falsos positivos nos resultados da pesquisa

Tipos de recursos

Uma lista de sling:resourceTypes pode ser fornecido para definir componentes que são usados para renderizar fragmentos de conteúdo e onde o processamento em segundo plano deve ser aplicado.

Propriedades de referência

Uma lista de propriedades pode ser configurada para especificar onde a referência ao fragmento é armazenada para o respectivo componente.

O nome da propriedade em que os elementos a serem renderizados são definidos deve ser element ou elementNames.

O nome da propriedade em que a variação a apresentar é definida deve ser variation ou variationName.

Se a saída de vários elementos for suportada (usando elementNames para especificar vários elementos), o modo de exibição real é definido pela propriedade displayMode:

• Se o valor for singleText (e há apenas um elemento configurado), o elemento é renderizado como um texto com conteúdo intermediário, suporte para layout, etc. Esse é o padrão para fragmentos, onde apenas um único elemento é renderizado.
• Caso contrário, uma abordagem muito mais simples será usada (poderia ser chamada de "exibição de formulário"), onde nenhum conteúdo intermediário será suportado e o conteúdo do fragmento será renderizado "como está".

Se o fragmento for renderizado para displayMode == singleText (implicitamente ou explicitamente) as seguintes propriedades adicionais são reproduzidas:

• paragraphScope define se todos os parágrafos, ou apenas um intervalo de parágrafos, devem ser renderizados (valores: all vs. range)
• if paragraphScope == range em seguida, a propriedade paragraphRange define o intervalo de parágrafos a serem renderizados

Traduções

Os Fragmentos de conteúdo são totalmente integrados à variável Fluxo de trabalho de tradução AEM. A nível arquitetônico, isso significa:

• As traduções individuais de um fragmento de conteúdo são, na verdade, fragmentos separados; por exemplo:

  • Estão localizadas sob raízes linguísticas diferentes:

    /content/dam/<path>/en/<to>/<fragment>

    vs.

    /content/dam/<path>/de/<to>/<fragment>

  • mas compartilham exatamente o mesmo caminho relativo abaixo da raiz de idioma:

    /content/dam/<path>/en/<to>/<fragment>

    vs.

    /content/dam/<path>/de/<to>/<fragment>

• Além dos caminhos baseados em regras, não há mais conexão entre as diferentes versões linguísticas de um fragmento de conteúdo; eles são tratados como dois fragmentos separados, embora a interface do usuário forneça os meios de navegar entre as variantes de idioma.

Esquemas de metadados

• Fragmentos de conteúdo (re)usar o esquemas de metadados, que podem ser definidos com ativos padrão.

O CFM fornece seu próprio schema específico:

/libs/dam/content/schemaeditors/forms/contentfragment

isso pode ser estendido se necessário.

O respectivo formulário de esquema é integrado ao editor de fragmentos.

Modelo do fragmento

ModeloDeFragmento

Use FragmentTemplate.createFragment() para criar um novo fragmento.

Resource templateOrModelRsc = resourceResolver.getResource("...");
FragmentTemplate tpl = templateOrModelRsc.adaptTo(FragmentTemplate.class);
ContentFragment newFragment = tpl.createFragment(parentRsc, "A fragment name", "A fragment description.");

Essa interface representa:

• um modelo de fragmento de conteúdo ou de fragmento de conteúdo do qual criar um fragmento de conteúdo,
• e (após a criação) a informação estrutural desse fragmento

Essas informações podem incluir:

• Acessar dados básicos (título, descrição)

• Acesse modelos/modelos para os elementos do fragmento:

  • Listar modelos de elemento
  • Obter informações estruturais para um determinado elemento
  • Acessar o modelo de elemento (consulte ElementTemplate)

• Acessar modelos para as variações do fragmento:

  • Listar modelos de variação
  • Obter informações estruturais para uma determinada variação
  • Acesse o modelo de variação (consulte VariationTemplate)

• Obter conteúdo associado inicial

Interfaces que representam informações importantes:

• ElementTemplate

  • Obter dados básicos (nome, título)
  • Obter conteúdo do elemento inicial

• VariationTemplate

  • Obter dados básicos (nome, título, descrição)

Fragmento de conteúdo

FragmentoDeConteúdo

Essa interface permite que você trabalhe com um fragmento de conteúdo de forma abstrata.

A interface fornece os meios para:

• Gerenciar dados básicos (por exemplo, obter nome; get/set title/description)

• Acessar metadados

• Elementos de acesso:

  • Elementos de lista
  • Obter elementos por nome
  • Criar novos elementos (consulte Avisos)
  • Acessar dados do elemento (consulte ContentElement)

• Listar variações definidas para o fragmento

• Criar novas variações globalmente

• Gerenciar conteúdo associado:

  • Listar coleções
  • Adicionar coleções
  • Remover coleções

• Acessar o modelo ou o modelo do fragmento

As interfaces que representam os elementos principais de um fragmento são:

• Elemento de conteúdo

  ContentElement
  

  • Obter dados básicos (nome, título, descrição)

  • Obter/definir conteúdo

  • Variações de acesso de um elemento:

    • Listar variações
    • Obter variações por nome
    • Crie novas variações (consulte Avisos)
    • Remover variações (consulte Avisos)
    • Acesse os dados de variação (consulte ContentVariation)

  • Atalho para resolver variações (aplicando alguma lógica de fallback adicional específica da implementação se a variação especificada não estiver disponível para um elemento)

• Variação de conteúdo

  ContentVariation
  

  • Obter dados básicos (nome, título, descrição)
  • Obter/definir conteúdo
  • Sincronização simples, com base nas informações da última modificação

Todas as três interfaces ( ContentFragment, ContentElement, ContentVariation) estender o Versionable interface, que adiciona recursos de controle de versão, necessários para fragmentos de conteúdo:

• Criar nova versão do elemento
• Versões de lista do elemento
• Obter o conteúdo de uma versão específica do elemento com versão

ContentFragment pode ser adaptado para:

• Resource - o recurso Sling subjacente; observe que a atualização do subjacente Resource diretamente, requer a reconstrução da variável ContentFragment objeto.
• Asset - DAM Asset abstração que representa o fragmento de conteúdo; observe que a atualização do Asset diretamente, requer a reconstrução da variável ContentFragment objeto.

ContentElement pode ser adaptado para:

• ElementTemplate - para aceder às informações estruturais do elemento.

FragmentTemplate pode ser adaptado para:

• Resource - o Resource Determinar o modelo referenciado ou o modelo original que foi copiado;

  • alterações efetuadas através da Resource não são refletidas automaticamente na variável FragmentTemplate.

Resource pode ser adaptado para:

• ContentFragment
• FragmentTemplate

A API é implementada para fornecer funcionalidade compatível com a interface do usuário do .

A API inteira foi projetada para not As alterações persistem automaticamente (a menos que observado de outra forma no JavaDoc da API). Portanto, sempre será necessário confirmar o resolvedor de recursos da respectiva solicitação (ou o resolvedor que você está realmente usando).

Tarefas que podem exigir esforço adicional:

• Criar/remover novos elementos não atualizará a estrutura de dados de fragmentos simples (com base em um modelo de fragmento).
• Criar novas variações de ContentElement não atualizará a estrutura de dados (mas os criará globalmente a partir de ContentFragment ).
• Remover variações existentes não atualizará a estrutura de dados.

filter.xml

O filter.xml O para gerenciamento de fragmentos de conteúdo é configurado de forma que não se sobreponha ao pacote de conteúdo principal do Assets.

Iniciar uma sessão

• Uma nova versão do fragmento de conteúdo é criada.
• O salvamento automático é iniciado.
• Os cookies estão definidos; eles definem o fragmento editado no momento e que há uma sessão de edição aberta.

Conclusão de uma sessão

• O salvamento automático é interrompido.

• Após confirmação:

  • As últimas informações modificadas são atualizadas.
  • Os cookies são removidos.

• Após a reversão:

  • A versão do fragmento de conteúdo criada quando a sessão de edição foi iniciada é restaurada.
  • Os cookies são removidos.

Edição

• Todas as alterações (salvamento automático incluído) são feitas no fragmento de conteúdo ativo, não em uma área separada e protegida.
• Portanto, essas alterações são refletidas imediatamente em AEM páginas que fazem referência ao respectivo fragmento de conteúdo

Inserir uma página

• Verifique se uma sessão de edição já está presente; verificando o respectivo cookie.

  • Se existir, verifique se a sessão de edição foi iniciada para o fragmento de conteúdo que está sendo editado no momento

    • Se o fragmento atual, restaure a sessão.
    • Caso contrário, tente cancelar a edição do fragmento de conteúdo editado anteriormente e remover os cookies (nenhuma sessão de edição presente posteriormente).

  • Se não houver uma sessão de edição, aguarde a primeira alteração feita pelo usuário (veja abaixo).

• Verifique se o fragmento de conteúdo já está referenciado em uma página e, nesse caso, exiba as informações apropriadas.

Alteração de conteúdo

• Sempre que o usuário altera o conteúdo e não há uma sessão de edição presente, uma nova sessão de edição é criada (consulte Iniciar uma sessão).

Sair de uma página

• Se uma sessão de edição estiver presente e as alterações não forem persistentes, uma caixa de diálogo de confirmação modal será exibida para notificar o usuário de conteúdo potencialmente perdido e permitir que ele permaneça na página.

Nó: <conf-root>/settings/dam/cfm/jcr:content

Nome da Propriedade: autoSaveInterval

Tipo: Long

Padrão: 600 (10 minutos); isso é definido em /libs/settings/dam/cfm/jcr:content

Nó: /conf/global/settings/dam/cfm/jcr:content

Nome da Propriedade: autoSaveInterval

Tipo: Long

Valor: 300 (5 minutos equivale a 300 segundos)