Andaime

Por vezes, é necessário criar um grande conjunto de páginas que compartilham a mesma estrutura, mas têm conteúdo diferente. Na interface padrão do AEM, é necessário criar cada página, arrastar os componentes apropriados para a página e preencher cada um deles individualmente.

Com o scaffolding, é possível criar um formulário (um scaffold) com os campos que refletem a estrutura desejada para suas páginas e usar este formulário para criar facilmente as páginas com base nesta estrutura.

Como o scaffolding funciona

Os scaffolds são armazenados no console de Ferramentas do administrador do site.

• Abra o console de Ferramentas e clique em Scaffolding da página padrão.

• Em seguida, clique em geometrixx.

• Em geometrixx, você encontrará uma página de scaffold chamada News. Clique duas vezes para abrir essa página.

O suporte consiste em um formulário com um campo para cada parte do conteúdo que compõe a página a ser criada e quatro parâmetros importantes que são acessados por meio de Propriedades da página da página do suporte.

As propriedades de scaffolding de página são:

• Texto do título: esse é o nome da própria página de scaffolding. Neste exemplo, é chamado de “News”.

• Descrição: isso aparecerá abaixo do título na página de scaffolding.

• Modelo de destino: este é o modelo que o scaffold usará ao criar uma nova página. Neste exemplo, temos um modelo de Página de conteúdo Geometrrixx.

• Caminho de destino: este é o caminho da página principal abaixo, a partir da qual este scaffold criará novas páginas. Neste exemplo, o caminho é /content/geometrixx/en/news.

O corpo do scaffold é o formulário. Quando um usuário desejar criar uma página usando o scaffold, ele preenche o formulário e clica em Criar, na parte inferior. No exemplo News acima, o formulário apresenta os seguintes campos:

• Título: esse é o nome da página a ser criada. Este campo está sempre presente em cada scaffold.

• Texto: este campo corresponde a um Componente de texto na página resultante.

• Imagem: Esse campo corresponde a um Componente de imagem na página resultante.

• Imagem/avançado: Título: o título da imagem.

• Imagem/avançado: Texto alternativo: o texto alternativo da imagem.

• Imagem/Avançado: Descrição: A descrição da imagem.

• Imagem/avançado: Tamanho: o tamanho da imagem.

• Tags/palavras-chave: metadados a serem atribuídos a esta página. Este campo está sempre presente em cada scaffold.

Criação de um scaffold

Para criar um novo suporte, vá para o console Ferramentas, Andaime de página padrão e crie uma nova página. Um único tipo de modelo de página estará disponível, o Modelo de Andaime.

Vá para as Propriedades da página​da nova página e defina o Texto do título, a Descrição , o Modelo do Público alvo e o Caminho do Público alvo, conforme descrito acima.

*Em seguida, é necessário definir a estrutura da página que este scaffold criará. Para fazer isso, vá para o modo de design na página do suporte. Um link será exibido, permitindo editar o scaffold no editor de caixas de diálogo.

Usando o editor de diálogo, você especifica as propriedades que serão criadas sempre que uma nova página for criada usando esse suporte.

A definição da caixa de diálogo para um scaffold funciona de maneira semelhante à de um componente (consulte Componentes). No entanto, algumas diferenças importantes se aplicam:

• As definições da caixa de diálogo de componentes são renderizadas como caixas de diálogo normais (conforme mostrado no painel central do editor de caixas de diálogo, por exemplo), enquanto que as definições da caixa de diálogo de scaffold, embora apareçam como caixas de diálogo normais no editor, são renderizadas na página de scaffold como um formulário de scaffold (conforme mostrado no scaffold News acima).
• As caixas de diálogo de componente fornecem campos apenas para os valores necessários para definir o conteúdo de um componente específico. Uma caixa de diálogo de scaffold deve fornecer campos para cada propriedade em todos os parágrafos da página a ser criada.
• No caso de caixas de diálogo de componentes, o componente usado para renderizar o conteúdo especificado está implícito e, portanto, a propriedade sling:resourceType do parágrafo é preenchida automaticamente quando o parágrafo é criado. Com um scaffold, todas as informações que definem o conteúdo e o componente atribuído para um determinado parágrafo deve ser fornecidas pela própria caixa de diálogo. Nas caixas de diálogo de scaffold, essas informações devem ser fornecidas usando campos Ocultos para enviá-las o momento de criação da página.

É útil consultar o exemplo da caixa de diálogo de scaffold News no editor de caixas de diálogo para ver como isso funciona. Entre no modo de design na página de scaffold e clique no link do editor de caixas de diálogo.

Agora, clique no campo de diálogo Diálogo > Painel de guias > Texto > Texto, desta forma:

A lista de propriedades para esse campo será exibida no lado direito do editor de caixa de diálogo, da seguinte forma:

Observe a propriedade de nome desse campo. Ela tem o valor

./jcr:content/par/text/text

Esse é o nome da propriedade na qual o conteúdo deste campo será gravado quando o scaffold for usado para criar uma página. A propriedade é exibida como um caminho relativo do nó que representa a página a ser criada. Especifica o texto da propriedade, abaixo do texto do nó, que está abaixo do par de nós secundário do nó jcr:content, localizado abaixo do nó da página.

Isso define o local de armazenamento de conteúdo para o texto que será inserido neste campo. No entanto, também é necessário especificar duas ou mais características para esse conteúdo:

• O fato de que a sequência de caracteres que está sendo armazenada aqui deve ser interpretada como rich text, e
• qual componente deve ser usado para renderizar o conteúdo na página resultante.

Observe que, em uma caixa de diálogo de componentes normal, não seria necessário especificar essas informações porque estão implícitas no fato de que a caixa de diálogo já está vinculada a um componente específico.

Para especificar essas duas informações, use campos ocultos. Clique no primeiro campo oculto Caixa de diálogo > Painel de guias > Texto > Oculto, desta forma:

As propriedades desse campo oculto são as seguintes:

A propriedade nome desse campo oculto é

./jcr:content/par/text/textIsRich

Esta é uma propriedade booleana usada para interpretar a string de texto armazenada em ./jcr:content/par/text/text.

Como sabemos que o texto deve ser interpretado como rich text, especificamos a propriedade value (valor) do campo como true.

O segundo campo oculto pode ser visualizado ao clicá-lo da seguinte maneira:

As propriedades desse campo oculto são as seguintes:

A propriedade nome desse campo oculto é

./jcr:content/par/text/sling:resourceType

e o valor fixo especificado para essa propriedade é

foundation/components/textimage

``Isso especifica que o componente a ser usado para renderizar o conteúdo de texto deste parágrafo é o componente de Imagem de texto. Usando com o booliano isRichText especificado no outro campo oculto, o componente pode renderizar a string de texto real armazenada em ./jcr:content/par/text/text da maneira desejada.

Scaffolding com Herança MSM

Na interface clássica, o scaffolding é totalmente integrado com herança MSM (quando aplicável).

Quando você abre uma página no modo Scaffolding (usando o ícone na parte inferior do sidekick), todos os componentes sujeitos à herança serão indicados por:

• um símbolo de cadeado (para a maioria dos componentes; por exemplo, Texto e Título)
• uma máscara com o texto Clique para cancelar a herança (para componentes de Imagem)

Eles mostram que o componente não pode ser editado - até que a herança seja cancelada.

Clicar no símbolo de cadeado ou no ícone de imagem permite interromper a herança:

• o símbolo será alterado para um cadeado aberto.
• uma vez que desbloqueado, será possível editar o conteúdo.

Depois de desbloquear, é possível restaurar a herança, clicando no símbolo de cadeado desbloqueado (essa ação descartará todas as alterações feitas).