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 é criado com base em um objeto JSON que pode ser estendido pela 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

O ListInfoProvider a interface define dois métodos:

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

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

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

O exemplo de implementação abaixo:

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

• Adiciona um starredCount , que é global para a lista e contém o número de itens da lista.

Para criar o serviço OSGI:

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

O novo serviço está em execução.

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 de 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 para a variável /content/geometrixx , a seguinte solicitação é enviada ao servidor de 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 de administração de sites para exibir a nova propriedade de todas as páginas do Geometrixx ao sobrepor /libs/wcm/core/content/siteadmin. Proceda do seguinte modo:

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. Copie o nó /libs/wcm/core/content/siteadmin e cole-o abaixo /apps/wcm/core/content.

3. Copie 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 da grade ativa para todos os sites geometrixx.

   • Definir storeProxySuffix para .pages.json

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

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

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

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

   • dataIndex: starred do tipo String

   • header: 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 isso 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 de administração de sites e navegue até o site do Geometrixx:
   https://localhost:4502/siteadmin#/content/geometrixx.

8. A nova coluna chamada Started estiver disponível, exibindo informações personalizadas da seguinte maneira:

Pacote de exemplo

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

Recursos do Business.Adobe.com

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