Dashboard

Con AEM è possibile gestire numerosi contenuti di tipo diverso (ad esempio pagine e contenuti). AEM Dashboard offre un metodo facile e personalizzabile per definire le pagine in cui sono visualizzati dati consolidati.

NOTA

I dashboard di AEM vengono creati a livello di utente e ogni utente può quindi accedere solo al proprio dashboard.

Tuttavia, Modelli per dashboard può essere utilizzato per condividere la configurazione comune e il layout del dashboard.

chlimage_1-22

Amministrazione dei dashboard

Creazione di un dashboard

Per creare un nuovo dashboard, effettuate le seguenti operazioni:

  1. Nella sezione Strumenti, fate clic su Console di configurazione.
  2. Nella struttura, fare doppio clic su Dashboard.
  3. Fate clic su Dashboard.
  4. Digitate il Titolo (ad esempio Mio dashboard) e Nome.
  5. Fai clic su Crea.

Clonazione di un dashboard

Può essere utile disporre di più dashboard per vedere rapidamente le informazioni sui contenuti sotto forma diversa. Per facilitare la creazione di nuovi dashboard, AEM consente di clonare, o duplicare, un dashboard esistente. Per clonare un dashboard, effettuate le seguenti operazioni:

  1. Nella sezione Strumenti, fate clic su Console di configurazione.

  2. Nella struttura ad albero, fate clic su Dashboard.

  3. Fate clic sul dashboard da clonare.

  4. Fate clic su Clona.

  5. Digitate il Nome del nuovo dashboard.

Rimozione di un dashboard

  1. Nella sezione Strumenti, fate clic su Console di configurazione.

  2. Nella struttura ad albero, fate clic su Dashboard.

  3. Fate clic sul dashboard da eliminare.

  4. Fate clic su Rimuovi.

  5. Fai clic su per confermare.

Componenti per dashboard

Panoramica

I componenti del dashboard non sono altro che normali Componenti AEM. Questa sezione descrive i componenti per report forniti con AEM.

Componenti per report per analisi Web

AEM viene fornito con un set di componenti che eseguono il rendering di più metriche del SiteCatalyst dati. Tali componenti sono elencati nella barra laterale sotto la sezione Dashboard.

Ciascun componente per report dispone di almeno tre schede:

  • Base: contiene la configurazione principale.

  • Report: contiene la configurazione specifica di ciascun report.

  • Stile: contiene la configurazione di stile, come dimensione del grafico e margini.

I componenti per report vengono inizializzati con una configurazione predefinita che consente di impostare rapidamente il dashboard.

Configurazione di base

La scheda Base permette di accedere alle seguenti voci di configurazione:

Titolo Titolo visualizzato sul dashboard.

Tipo di richiesta Modalità di richiesta dei dati.

Configurazione del SiteCatalyst (opzionale) Configurazione da utilizzare per la connessione al SiteCatalyst. Se non viene fornita, viene considerata la configurazione sulla pagina Dashboard (tramite le proprietà pagina).

ID suite di rapporti (facoltativo) La suite di rapporti di SiteCatalyst che desideri utilizzare per generare il grafico.

Configurazione del report

Per visualizzare le statistiche Web, occorre definire l’intervallo di date che interessano. La scheda Report contiene due campi con cui definire tale intervallo.

NOTA

Se si imposta un intervallo di date ampio, il dashboard potrebbe risultare lento.

Data Da Data assoluta o relativa a partire dalla quale i dati vengono recuperati.

Data a Data assoluta o relativa alla quale vengono recuperati i dati.

Per ciascun componente vengono inoltre definite specifiche impostazioni.

Report tempo eccessivo

chlimage_1-26

Granularità della data Unità di tempo dell’asse X (ad esempio giorno, ora).

Metriche Elenco degli eventi da visualizzare.

Elementi Elenco di elementi che suddividono i dati delle metriche nel grafico.

Report elenco classifica

chlimage_1-27

Elementi L’elemento che suddivide i dati delle metriche nel grafico.

Metriche L’evento da visualizzare.

No. degli elementi principali Numero di elementi visualizzati dal rapporto.

Report classifica

chlimage_1-28

Metriche L’evento da visualizzare.

Elementi L’elemento che suddivide i dati delle metriche nel grafico.

Report sezione del sito principale

Questo componente visualizza un grafico che illustra la sezione più visitata del sito Web in base alla seguente configurazione.

chlimage_1-29

No. degli elementi principali Numero di sezioni visualizzate dal report.

Report con tendenze

chlimage_1-30

Granularità della data Unità di tempo dell’asse X (ad esempio giorno, ora).

Metriche L’evento da visualizzare.

Elementi L’elemento che suddivide i dati delle metriche nel grafico.

Estensione del dashboard

Panoramica

I dashboard sono normali pagine (cq:Page) e possono quindi essere assemblati con qualsiasi componente.

Esiste un gruppo di componenti predefinito Dashboard contenente i componenti di reporting di analytics che sono abilitati sul modello per impostazione predefinita.

Creazione di un modello di dashboard

Con un modello si definisce il contenuto predefinito di un nuovo dashboard. È possibile disporre di più modelli, con cui creare diversi tipi di dashboard.

I modelli di dashboard vengono creati come altri modelli di pagina, ma sono memorizzati in /libs/cq/dashboards/templates/. Consulta la sezione Creazione del modello di pagina di contenuto sezione .

NOTA

I modelli di dashboard possono essere condivisi tra più utenti.

Sviluppo di un componente dashboard

Lo sviluppo di un componente dashboard consiste nella creazione di un normale componente AEM. In questa sezione viene descritto un esempio di componente per visualizzare i primi 10 utenti collaboratori.

chlimage_1-31

I componenti per autori principali vengono memorizzati nell’archivio all’indirizzo /apps/geometrixx-outdoors/components/reporting ed è composto da :

  1. un file jsp che legge i dati jcr e definisce il segnaposto html;

  2. una libreria lato client contenente un file js che raccoglie e ordina i dati, quindi compila il segnaposto html.

chlimage_1-32

Il seguente file Javascript è definito nel geout.reporting.topauthors Libreria client come figlio del componente stesso.

La QueryBuilder viene utilizzato per eseguire query sul repository da leggere cq:AuditEvent nodi. Il risultato della query genera un oggetto JSON dal quale vengono estratti i contributi degli autori.

top_authors.js

$.ajax({
  url: "/bin/querybuilder.json",
  cache: false,
  data: {
       "orderby": "cq:time",
       "orderby.sort": "desc",
       "p.hits": "full",
       "p.limit": 100,
       "path": "/var/audit/com.day.cq.wcm.core.page/",
       "type": "cq:AuditEvent"
   },
  dataType: "json"
}).done(function( res ) {
    var authors = {};
    // from JSON to Object
    for(var r in res.hits) {
        var userId = res.hits[r].userId;
        if(userId == undefined) {
            continue;
        }
        var auth = authors[userId] || {userId : userId};
        auth.contrib = (auth.contrib || 0) +1;

        authors[userId] = auth;
    }

    // order by contribution
    var orderedByContrib = [];
    for(var a in authors) {
        orderedByContrib.push(authors[a]);
    }
    orderedByContrib.sort(function(a,b){return b.contrib - a.contrib});

    // produce the list
    for (var i=0, tot=orderedByContrib.length; i < tot; i++) {
        var current = orderedByContrib[i];
        $("<div> #" + (i + 1) +" "+ current.userId + " (" + current.contrib +" contrib.)</div>").appendTo("#authors-list");

    }
});

La JSP include entrambi global.jsp e clientlib.

top_authors.jsp

<%@page session="false" contentType="text/html; charset=utf-8" %><%
%><%
%><%@include file="/libs/foundation/global.jsp" %><%
%>
<ui:includeClientLib categories="geout.reporting.topauthors" />
<%
String reportletTitle = properties.get("title", "Top Authors");
%>
<html>
     <h3><%=xssAPI.encodeForHTML(reportletTitle) %></h3>
     <div id="authors-list"></div>
</html>

In questa pagina