Andaime scaffolding
Às vezes, pode ser necessário criar um grande conjunto de páginas que compartilham estrutura, mas têm conteúdo diferente. Por meio da interface padrão do Adobe Experience Manager (AEM), seria necessário criar cada página, arrastar os componentes apropriados para a página e preencher cada um deles individualmente.
Com o andaime, você pode criar um formulário (um andaime) com campos que refletem a estrutura desejada para as páginas e, em seguida, usar este formulário para criar facilmente páginas com base nessa estrutura.
Como funciona o andaime how-scaffolding-works
Os scaffolds são armazenados no console Ferramentas do administrador do site.
- Abra o console Ferramentas e clique em Andaime de Página Padrão.
- Em, clique em Geometrixx.
- Em Geometrixx, você encontrará uma página de andaime chamada Notícias. Clique duas vezes para abrir esta página.
O scaffold consiste em um formulário com um campo para cada parte do conteúdo que irá compor a página a ser criada e quatro parâmetros importantes que são acessados através das Propriedades da Página da página do scaffold.
As propriedades da página de andaime são:
- Texto do Título: este é o nome desta própria página de andaime. Neste exemplo, ele é chamado de "Notícias".
- Descrição: aparece abaixo do título na página de andaimes.
- Modelo de Destino: este é o modelo que este scaffolding usará ao criar uma página. Neste exemplo, é um modelo de Página de Conteúdo do Geometrixx.
- Caminho de Destino: este é o caminho da página pai abaixo da qual este scaffolding criará páginas. Neste exemplo, o caminho é /content/geometrixx/en/news.
O corpo do andaime é a forma. Quando um usuário deseja criar uma página usando o scaffolding, ele preenche o formulário e clica em Criar, na parte inferior. No exemplo Notícias acima, o formulário tem os seguintes campos:
- Título: este é o nome da página a ser criada. Este campo está sempre presente em todos os andaimes.
- Texto: este campo corresponde a um componente de Texto na página resultante.
- Imagem: este 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 Alt: O texto alternativo da imagem.
- Imagem/Avançado: Descrição: a descrição da imagem.
- Imagem/Avançado: Tamanho: O tamanho da imagem.
- Marcas/Palavras-chave: os metadados serão atribuídos a esta página. Este campo está sempre presente em todos os andaimes.
Criação de um scaffold creating-a-scaffold
Para criar um scaffolding, vá para o console Ferramentas, depois Scaffolding de página padrão e crie uma página. Um tipo de modelo de página única está disponível, o Modelo de andaime.
Vá para as Propriedades da Página da nova página e defina o Texto do Título, Descrição, Modelo de Destino e Caminho de Destino, conforme descrito acima.
Em seguida, é necessário definir a estrutura da página que esse scaffolding criará. Para fazer isso, entre no modo de design na página de andaime. Um link é exibido, permitindo que você edite o scaffolding no editor de diálogo.
Usando o editor de caixa de diálogo, especifique as propriedades que serão criadas sempre que uma nova página for criada usando esse scaffolding.
A definição da caixa de diálogo de um scaffold funciona de forma semelhante à de um componente (consulte Componentes). No entanto, algumas diferenças importantes se aplicam:
- As definições de caixa de diálogo de componente são renderizadas como caixas de diálogo normais (conforme mostrado no painel do meio do editor de caixa de diálogo, por exemplo), enquanto as definições de caixa de diálogo de scaffold, embora apareçam como caixas de diálogo normais no editor de caixa de diálogo, são renderizadas na página de scaffold como um formulário de scaffold (conforme mostrado no scaffold Notícias acima).
- As caixas de diálogo do componente fornecem campos apenas para os valores necessários para definir o conteúdo de um único componente específico. Uma caixa de diálogo de scaffold deve fornecer campos para cada propriedade em cada parágrafo da página que será criada.
- Se houver caixas de diálogo de componente, o componente usado para renderizar o conteúdo especificado será implícito e, portanto, a propriedade
sling:resourceTypedo parágrafo será preenchida automaticamente quando o parágrafo for criado. Com um scaffolding, todas as informações que definem o conteúdo e o componente atribuído para um determinado parágrafo devem ser fornecidas pela própria caixa de diálogo. Nas caixas de diálogo de scaffold, essas informações devem ser fornecidas usando os campos Ocultos para enviar essas informações na criação da página.
Uma olhada na caixa de diálogo de scaffold Notícias do exemplo no editor de caixa de diálogo ajuda a explicar como isso funciona. Vá para o modo de design na página do andaime e clique no link do editor de diálogo.
Agora, clique no campo de diálogo Caixa de diálogo > Painel de guias > Texto > Texto, desta forma:
A lista de propriedades desse campo aparece no lado direito do editor da caixa de diálogo, desta forma:
Observe a propriedade de nome desse campo. Tem o valor
./jcr:content/par/text/text
Esse é o nome da propriedade na qual o conteúdo desse campo será escrito quando o scaffold for usado para criar uma página. A propriedade é declarada como um caminho relativo do nó que representa a página que será criada. Especifica o texto da propriedade, abaixo do texto do nó, que está abaixo do par do nó, que é ele mesmo filho do nó jcr:content abaixo do nó da página.
Isso define o local do armazenamento de conteúdo para o texto que será inserido nesse campo. No entanto, também precisamos especificar mais duas características para esse conteúdo:
- O fato de que a cadeia de caracteres que está sendo armazenada aqui deve ser interpretada como rich text e
- qual componente deve ser usado para renderizar esse conteúdo para a página resultante.
Em uma caixa de diálogo de componente normal, não seria necessário especificar essas informações, pois 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 Diálogo > Painel de Guias > Texto > Oculto, desta forma:
As propriedades desse campo oculto são as seguintes:
A propriedade de nome deste campo oculto é
./jcr:content/par/text/textIsRich
Esta é uma propriedade booleana usada para interpretar a cadeia de texto armazenada em ./jcr:content/par/text/text.
Como sabemos que o texto deve ser interpretado como um rich text, vamos especificar a propriedade value desse campo como true.
O segundo campo oculto pode ser visto clicando-o da seguinte maneira:
As propriedades desse campo oculto são as seguintes:
A propriedade de nome deste campo oculto é
./jcr:content/par/text/sling:resourceType
E o valor fixo especificado para essa propriedade é
foundation/components/textimage
Especifica que o componente a ser usado para renderizar o conteúdo de texto deste parágrafo é o componente Imagem de texto. Usando com o booleano isRichText especificado em outro campo oculto, o componente pode renderizar a cadeia de texto real armazenada em ./jcr:content/par/text/text da maneira desejada.
Andaime com herança do MSM scaffolding-with-msm-inheritance
Na interface clássica, o scaffolding é totalmente integrado à herança do MSM (quando aplicável).
Ao abrir uma página no modo Andaime (usando o ícone na parte inferior do sidekick), todos os componentes sujeitos a herança serão indicados por:
- um símbolo de bloqueio (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 bloqueio ou no ícone de imagem permite interromper a herança:
- o símbolo muda para um cadeado aberto.
- depois de desbloqueado, é possível editar o conteúdo.
Depois de desbloquear, você pode restaurar a herança clicando no símbolo de cadeado desbloqueado; isso perderá todas as edições que você fez.