Experience League

Experience Cloud

Document Cloud

Modelos de fragmento de conteúdo

CUIDADO

Algumas funcionalidades do Fragmento de conteúdo exigem a aplicação de AEM 6.4 Service Pack 2 (6.4.2.0).

CUIDADO

Agora, os modelos de fragmento de conteúdo são recomendados para criar todos os fragmentos.

Os modelos de fragmento de conteúdo são usados para todos os exemplos em We.Retail.

Os modelos são selecionados ao criar um fragmento de conteúdo. Eles fornecem ao novo fragmento a estrutura básica, os elementos e a variação. Os modelos usados para fragmentos de conteúdo estão sujeitos ao Gerenciador de configuração do Granite.

Os modelos predefinidos são mantidos em:

/libs/settings/dam/cfm/templates

Você pode criar modelos específicos do site para fragmentos de conteúdo em:

/apps/settings/dam/cfm/templates

O local para sobrepor modelos predefinidos ou fornecer modelos específicos do cliente e de todo o aplicativo que não se destinam a ser estendidos/alterados no tempo de execução.
/conf/global/settings/dam/cfm/templates

O local para modelos específicos do cliente em toda a instância que precisam ser alterados em tempo de execução.

A ordem de precedência é (em ordem decrescente) /conf, /apps, /libs.

CUIDADO

Você deve não alterar nada no caminho /libs.

Isso ocorre porque o conteúdo de /libs é substituído na próxima vez que você atualizar sua instância (e pode muito bem ser substituído quando você aplicar uma correção ou um pacote de recursos).

O método recomendado para configuração e outras alterações é:

Recrie o item necessário (isto é, como ele existe em /libs) em /apps
Faça quaisquer alterações em /apps

A estrutura básica de um modelo é mantida em:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

Com a estrutura específica:

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version 
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title 
            - defaultContent 
            - initialContentType 
            - name 
        ... + other element definitions
    + variations
        - jcr:primaryType 
        + <variation-name>
            - jcr:primaryType 
            - jcr:title 
            - jcr:description
            - name 
        ... + other variation definitions

Mais detalhes sobre os nós e suas propriedades são:

Modelo

Nome	Tipo	Valor
`<template-name>`	`nt:unstructured`	Esse nó é a raiz de cada modelo. É obrigatório e deve ter um nome exclusivo.
`jcr:title`	`String` required	O título do modelo (exibido no assistente Criar fragmento).
`jcr:description`	`String` opcional	Um texto que descreve a finalidade do modelo (exibido no assistente Criar fragmento).
`initialAssociatedContent`	`String[]` opcional	Uma matriz com caminhos para coleções que devem ser associados a um fragmento de conteúdo recém-criado por padrão.
`precreateElements`	`Boolean` required	`true`, se os subativos que representam os elementos (exceto o elemento principal) do fragmento de conteúdo devem ser criados quando o fragmento de conteúdo é criado; false se devem ser criados "dinamicamente". Observação: atualmente, esse parâmetro deve ser definido como `true`.
`version`	`Long` required	Versão da estrutura de conteúdo; atualmente suportado: Observação: atualmente, esse parâmetro deve ser definido como `2`.

Elementos

Nome Tipo Valor

Nome	Tipo	Valor
`elements`	`nt:unstructured` required	Nó que contém a definição dos elementos do fragmento de conteúdo. É obrigatório e precisa conter pelo menos um nó filho para o elemento Main, mas pode conter [1..n] nós secundários. Quando o modelo é usado, a subramificação de elementos é copiada para a subramificação do modelo do fragmento. O primeiro elemento (conforme exibido no CRXDE Lite) é automaticamente considerado como o elemento main; O nome do nó é irrelevante e o nó em si não tem um significado especial, além do fato de ser representado pelo ativo principal; os outros elementos são tratados como subativos.

elements

nt:unstructured

required

Nó que contém a definição dos elementos do fragmento de conteúdo. É obrigatório e precisa conter pelo menos um nó filho para o elemento Main, mas pode conter [1..n] nós secundários.

Quando o modelo é usado, a subramificação de elementos é copiada para a subramificação do modelo do fragmento.

O primeiro elemento (conforme exibido no CRXDE Lite) é automaticamente considerado como o elemento main; O nome do nó é irrelevante e o nó em si não tem um significado especial, além do fato de ser representado pelo ativo principal; os outros elementos são tratados como subativos.

Nome do elemento

Nome	Tipo	Valor
`<element-name>`	`nt:unstructured`	Esse nó define um elemento. É obrigatório e deve ter um nome exclusivo.
`jcr:title`	`String` required	O título do elemento (exibido no seletor de elementos do editor de fragmentos).
`defaultContent`	`String` opcional default: ""	Conteúdo inicial do elemento; usado somente se `precreateElements` = `true`
`initialContentType`	`String` opcional default: `text/html`	Tipo de conteúdo inicial do elemento; usado somente se `precreateElements` = `true`; atualmente suportado: `text/html` `text/plain` `text/x-markdown`
`name`	`String` required	O nome interno do elemento; deve ser exclusiva para o tipo de fragmento.

Variações

Nome Tipo Valor

Nome	Tipo	Valor
`variations`	`nt:unstructured` opcional	Esse nó opcional contém a definição das variações iniciais do fragmento de conteúdo.

variations

nt:unstructured

opcional

Esse nó opcional contém a definição das variações iniciais do fragmento de conteúdo.

Nome da variação

Nome Tipo Valor

Nome	Tipo	Valor
`<variation-name>`	`nt:unstructured` obrigatório se um nó de variação estiver presente	Define uma variação inicial. A variação é adicionada a todos os elementos do fragmento de conteúdo por padrão. A variação terá o mesmo conteúdo inicial que o respectivo elemento (consulte `defaultContent/ initialContentType`)
`jcr:title`	`String` required	O título da variação (exibido na guia Variação do editor de fragmentos (painel esquerdo)).
`jcr:desciption`	`String` opcional padrão: ""	Um texto que fornece uma descrição da variação (exibida na guia Variação do editor de fragmentos (painel esquerdo)).

<variation-name>

nt:unstructured

obrigatório se um nó de variação estiver presente

Define uma variação inicial.
A variação é adicionada a todos os elementos do fragmento de conteúdo por padrão.

A variação terá o mesmo conteúdo inicial que o respectivo elemento (consulte defaultContent/ initialContentType)

jcr:title

String

required

O título da variação (exibido na guia Variação do editor de fragmentos (painel esquerdo)).

jcr:desciption

String

opcional