Personalização do console Sites (interface clássica)

Adicionar uma coluna personalizada ao console Sites (siteadmin)

O console Administração de sites pode ser estendido para exibir colunas personalizadas. O console é construído com base em um objeto JSON que pode ser estendido por meio da criação de um serviço OSGI que implementa o ListInfoProvider interface. Esse serviço modifica o objeto JSON enviado ao cliente para criar o console.

Este tutorial passo a passo explica como exibir uma nova coluna no console Administração de sites implementando o ListInfoProvider interface. Ele consiste nas seguintes etapas:

1. Criação do serviço OSGI e implantar o pacote que o contém no servidor AEM.
2. (opcional) Teste do novo serviço emitindo uma chamada JSON para solicitar o objeto JSON usado para criar o console.
3. Exibição da nova coluna estendendo a estrutura dos nós do console no repositório.

Criação do serviço OSGI

A variável ListInfoProvider A interface do define dois métodos:

• updateListGlobalInfo, para atualizar as propriedades globais da lista,
• updateListItemInfo, para atualizar um único item da lista.

Os argumentos para ambos os métodos são:

• request, o objeto de solicitação HTTP do Sling associado,
• info, o objeto JSON a ser atualizado, que é, respectivamente, a lista global ou o item de lista atual,
• resource, um recurso do Sling.

O exemplo de implementação abaixo:

• Adiciona um estrelado para cada item, que é true se o nome da página começar com um e, e false caso contrário.

• Adiciona um starsCount propriedade, que é global para a lista e contém o número de itens de lista com estrelas.

Para criar o serviço OSGI:

1. No CRXDE Lite, criar um pacote.
2. Adicione o código de amostra abaixo.
3. Crie o pacote.

O novo serviço está em funcionamento.

package com.test;

import com.day.cq.commons.ListInfoProvider;
import com.day.cq.i18n.I18n;
import com.day.cq.wcm.api.Page;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;

@Component(metatype = false)
@Service(value = ListInfoProvider.class)
public class StarredListInfoProvider implements ListInfoProvider {

    private int count = 0;

    public void updateListGlobalInfo(SlingHttpServletRequest request, JSONObject info, Resource resource) throws JSONException {
        info.put("starredCount", count);
        count = 0; // reset for next execution
    }

    public void updateListItemInfo(SlingHttpServletRequest request, JSONObject info, Resource resource) throws JSONException {
        Page page = resource.adaptTo(Page.class);
        if (page != null) {
            // Consider starred if page name starts with 'e'
            boolean starred = page.getName().startsWith("e");
            if (starred) {
                count++;
            }
            I18n i18n = new I18n(request);
            info.put("starred", starred ? i18n.get("Yes") : i18n.get("No"));
        }
    }

}

Testando o novo serviço

Ao abrir o console Administração de sites e navegar pelo site, o navegador emite uma chamada ajax para obter o objeto JSON usado para criar o console. Por exemplo, quando você navega até a variável /content/geometrixx , a seguinte solicitação é enviada ao servidor AEM para criar o console:

https://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin

Para garantir que o novo serviço esteja em execução após a implantação do pacote que o contém:

1. Aponte seu navegador para o seguinte URL:
   https://localhost:4502/content/geometrixx.pages.json?start=0&limit=30&predicate=siteadmin

2. A resposta deve exibir as novas propriedades da seguinte maneira:

Exibição da Nova Coluna

A última etapa consiste em adaptar a estrutura dos nós do console Administração de sites para exibir a nova propriedade para todas as páginas do Geometrixx ao sobrepor /libs/wcm/core/content/siteadmin. Proceda da seguinte forma:

1. No CRXDE Lite, crie a estrutura dos nós /apps/wcm/core/content com nós do tipo sling:Folder para refletir a estrutura /libs/wcm/core/content.

2. Copiar o nó /libs/wcm/core/content/siteadmin e cole-o abaixo /apps/wcm/core/content.

3. Copiar o nó /apps/wcm/core/content/siteadmin/grid/assets para /apps/wcm/core/content/siteadmin/grid/geometrixx e altera suas propriedades:

   • Remover pageText

   • Definir pathRegex para /content/geometrixx(/.*)?
     Isso tornará a configuração de grade ativa para todos os sites geometrixx.

   • Definir storeProxySuffix para .pages.json

   • Edite o storeReaderFields propriedade com vários valores e adicione a variável starred valor.

   • Para ativar a funcionalidade MSM, adicione os seguintes parâmetros MSM à propriedade multi-String storeReaderFields:

     • msm:isSource
     • msm:isInBlueprint
     • msm:isLiveCopy

4. Adicionar um starred nó (do tipo nt:não estruturado) abaixo /apps/wcm/core/content/siteadmin/grid/geometrixx/columns com as seguintes propriedades:

   • dataIndex: starred do tipo String

   • cabeçalho: Starred do tipo String

   • xtype: gridcolumn do tipo String

5. (opcional) Solte as colunas que você não deseja exibir em /apps/wcm/core/content/siteadmin/grid/geometrixx/columns

6. /siteadmin é um caminho personalizado que, como padrão, aponta para /libs/wcm/core/content/siteadmin.
   Para redirecionar para sua versão do siteadmin em /apps/wcm/core/content/siteadmin definir a propriedade sling:vanityOrder para ter um valor maior que o definido em /libs/wcm/core/content/siteadmin. O valor padrão é 300, portanto, qualquer valor maior é adequado.

7. Vá para o console Administração de sites e navegue até o site do Geometrixx:
   https://localhost:4502/siteadmin#/content/geometrixx.

8. A nova coluna chamada Starred O está disponível, exibindo informações personalizadas da seguinte maneira:

Pacote de exemplo

O resultado deste tutorial está disponível no Personalização do Console de administração de sites pacote no Compartilhamento de pacotes.

Recursos do Business.Adobe.com

Ecommerce Integrations Content Insights Targeted Content Customer Communications Content Intelligence Mobile Forms