DocumentazioneAEM 6.4Guida allo sviluppo

Personalizzazione della console Siti web (interfaccia classica) customizing-the-websites-console-classic-ui

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Aggiunta di una colonna personalizzata alla console Siti web (siteadmin) adding-a-custom-column-to-the-websites-siteadmin-console

È possibile estendere la console Amministrazione siti Web per visualizzare colonne personalizzate. La console è basata su un oggetto JSON che può essere esteso creando un servizio OSGI che implementa ListInfoProvider interfaccia. Tale servizio modifica l’oggetto JSON inviato al client per creare la console.

Questa esercitazione passo-passo spiega come visualizzare una nuova colonna nella console di amministrazione dei siti web implementando l’ ListInfoProvider interfaccia. Si compone dei seguenti passaggi:

  1. Creazione del servizio OSGI e distribuendo il bundle che lo contiene al server AEM.
  2. (facoltativo) Verifica del nuovo servizio effettuando una chiamata JSON per richiedere l’oggetto JSON utilizzato per creare la console.
  3. Visualizzazione della nuova colonna estendendo la struttura dei nodi della console nell’archivio.
NOTE
Questa esercitazione può essere utilizzata anche per estendere le seguenti console di amministrazione:
  • la console Risorse digitali
  • la console Community

Creazione del servizio OSGI creating-the-osgi-service

La ListInfoProvider l'interfaccia definisce due metodi:

  • updateListGlobalInfo, per aggiornare le proprietà globali dell’elenco,
  • updateListItemInfo, per aggiornare una singola voce dell’elenco.

Gli argomenti di entrambi i metodi sono:

  • request, l’oggetto di richiesta Sling HTTP associato,
  • info, l’oggetto JSON da aggiornare, che è rispettivamente l’elenco globale o la voce dell’elenco corrente,
  • resource, una risorsa Sling.

Di seguito è riportato un esempio di implementazione:

  • Aggiunge un stellato proprietà per ogni elemento, ovvero true se il nome della pagina inizia con un e e false altrimenti.

  • Aggiunge un starredCount , che è globale per l'elenco e contiene il numero di elementi dell'elenco di destinazione.

Per creare il servizio OSGI:

  1. In CRXDE Lite, creare un bundle.
  2. Aggiungi il codice di esempio seguente.
  3. Crea il bundle.

Il nuovo servizio è in esecuzione.

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"));
        }
    }

}
CAUTION
  • L’implementazione deve decidere, in base alla richiesta e/o alla risorsa fornita, se aggiungere o meno le informazioni all’oggetto JSON.
  • Se ListInfoProvider l'implementazione definisce una proprietà già esistente nell'oggetto di risposta; il relativo valore verrà sovrascritto da quello fornito.
    È possibile utilizzare classificazione del servizio per gestire l’ordine di esecuzione di più ListInfoProvider implementazioni.

Verifica del nuovo servizio testing-the-new-service

Quando apri la console di amministrazione dei siti web e sfoglia il sito, il browser esegue una chiamata AJAX per ottenere l’oggetto JSON utilizzato per creare la console. Ad esempio, quando sfoglia il /content/geometrixx , viene inviata la seguente richiesta al server AEM per creare la console:

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

Per assicurarti che il nuovo servizio sia in esecuzione dopo aver implementato il bundle che lo contiene:

  1. Posiziona il browser nel seguente URL:

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

  2. La risposta deve visualizzare le nuove proprietà come segue:

screen_shot_2012-02-13at163046

Visualizzazione della nuova colonna displaying-the-new-column

L’ultimo passaggio consiste nell’adattare la struttura dei nodi della console di amministrazione dei siti web per visualizzare la nuova proprietà per tutte le pagine di Geometrixx sovrapponendo /libs/wcm/core/content/siteadmin. Procedere come segue:

  1. In CRXDE Lite, creare la struttura dei nodi /apps/wcm/core/content con nodi di tipo sling:Folder per riflettere la struttura /libs/wcm/core/content.

  2. Copia il nodo /libs/wcm/core/content/siteadmin e incollalo sotto /apps/wcm/core/content.

  3. Copia il nodo /apps/wcm/core/content/siteadmin/grid/assets a /apps/wcm/core/content/siteadmin/grid/geometrixx e ne modifica le proprietà:

    • Rimuovi pageText

    • Imposta pathRegex a /content/geometrixx(/.*)?

      In questo modo la configurazione della griglia sarà attiva per tutti i siti web geometrixx.

    • Imposta storeProxySuffix a .pages.json

    • Modifica le storeReaderFields multivalore e aggiungi la proprietà starred valore.

    • Per attivare la funzionalità MSM, aggiungi i seguenti parametri MSM alla proprietà multi-String storeReaderFields:

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

  4. Aggiungi un starred nodo (di tipo nt:unstructured) di seguito /apps/wcm/core/content/siteadmin/grid/geometrixx/columns con le seguenti proprietà:

    • dataIndex: starred di tipo String
    • header: Starred di tipo String
    • xtype: gridcolumn di tipo String

  5. (facoltativo) Rilascia le colonne a cui non desideri visualizzare /apps/wcm/core/content/siteadmin/grid/geometrixx/columns

  6. /siteadmin è un percorso personalizzato che, come impostazione predefinita, punta a /libs/wcm/core/content/siteadmin.

    Per reindirizzare questo alla tua versione di siteadmin su /apps/wcm/core/content/siteadmin definire la proprietà sling:vanityOrder per avere un valore maggiore di quello definito in /libs/wcm/core/content/siteadmin. Il valore predefinito è 300, quindi qualsiasi valore superiore è adatto.

  7. Passate alla console di amministrazione dei siti web e passate al sito Geometrixx:

    http://localhost:4502/siteadmin#/content/geometrixx.

  8. La nuova colonna denominata Stellato è disponibile, mostrando informazioni personalizzate come segue:

screen_shot_2012-02-14at104602

CAUTION
Se più configurazioni della griglia corrispondono al percorso richiesto definito dalla pathRegex , il primo verrà utilizzato e non il più specifico, il che significa che l'ordine delle configurazioni è importante.

Pacchetto di esempio sample-package

Il risultato di questa esercitazione è disponibile nella sezione Personalizzazione della console di amministrazione dei siti web su Package Share.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e