Generazione rapporti

Per aiutarti a monitorare e analizzare lo stato dell’istanza, Adobe Experience Manager (AEM) fornisce una selezione di rapporti predefiniti che possono essere configurati per i tuoi requisiti individuali:

• Report componente
• Utilizzo disco
• Verifica stato
• Report attività pagina
• Report di contenuti generati dall'utente
• Report utente
• Report di istanze flusso di lavoro
• Report di workflow

È possibile accedere a tutti i rapporti da Strumenti console. Seleziona Rapporti nel riquadro di sinistra, fare doppio clic sul report richiesto nel riquadro di destra per aprirlo per la visualizzazione, la configurazione o entrambe.

È possibile creare nuove istanze di un rapporto anche dalla sezione Strumenti console. Seleziona Rapporti nel riquadro di sinistra, quindi Nuovo… dalla barra degli strumenti. Definisci un Titolo e Nome, seleziona il tipo di rapporto desiderato, quindi fai clic su Crea. La nuova istanza di report viene visualizzata nell’elenco. Fai doppio clic su questo per aprire, quindi trascina un componente dalla barra laterale in modo da creare la prima colonna e avviare la definizione del rapporto.

Nozioni di base sulla personalizzazione dei rapporti

Sono disponibili vari formati di rapporti. Tutti i rapporti seguenti utilizzano colonne che possono essere personalizzate come descritto nelle sezioni seguenti:

• Report componente
• Report attività pagina
• Report di contenuti generati dall'utente
• Report utente
• Report di istanze flusso di lavoro

Selezione e posizionamento delle colonne di dati

Le colonne possono essere aggiunte, riposizionate o rimosse da qualsiasi rapporto, sia standard che personalizzato.

Il Componenti Nella scheda della barra laterale (disponibile nella pagina del report) sono elencate tutte le categorie di dati che è possibile selezionare come colonne.

Per modificare la selezione dei dati:

• per aggiungere una colonna, trascina il componente richiesto dalla barra laterale e rilascialo nella posizione desiderata

  • un segno di spunta verde indica quando la posizione è valida e una coppia di frecce indica esattamente dove viene posizionata
  • un simbolo rosso "no-go" indica quando la posizione non è valida

• per spostare una colonna, fare clic sull'intestazione, tenere premuto e trascinare nella nuova posizione

• per rimuovere una colonna, fare clic sul titolo della colonna, tenere premuto e trascinare verso l'alto nell'area dell'intestazione del report (un simbolo meno rosso indica che la posizione non è valida). Rilasciare il pulsante del mouse e la finestra di dialogo Elimina componenti richiede la conferma dell'eliminazione effettiva della colonna.

Menu a discesa delle colonne

Ogni colonna del rapporto ha un menu a discesa. Questa opzione diventa visibile quando il cursore del mouse si sposta sulla cella del titolo della colonna.

Viene visualizzata una freccia all'estrema destra della cella del titolo (da non confondere con la freccia immediatamente a destra del testo del titolo che indica meccanismo di ordinamento corrente).

Le opzioni disponibili nel menu dipendono dalla configurazione della colonna (effettuata durante lo sviluppo del progetto), mentre le opzioni non valide vengono disattivate (disattivate).

Ordinamento dei dati

I dati possono essere ordinati in base a una colonna specifica:

• facendo clic sull'intestazione di colonna appropriata; l'ordinamento passa da crescente a decrescente e viene indicato da una freccia posta immediatamente accanto al testo del titolo
• utilizzare il menu a discesa della colonna per selezionare in modo specifico Ordinamento crescente o Ordine decrescente; anche in questo caso, viene indicata da una freccia accanto al testo del titolo

Grafico dei gruppi e dei dati correnti

Nelle colonne appropriate, puoi selezionare Raggruppa per questa colonna dal menu a discesa della colonna. Raggruppa i dati in base a ogni valore distinto all’interno di quella colonna. È possibile selezionare più colonne da raggruppare. L’opzione è disattivata (disattivata) quando i dati nella colonna non sono appropriati. In altre parole, ogni voce è distinta e univoca, quindi non è possibile formare gruppi. Ad esempio, la colonna ID utente del report utente.

Dopo aver raggruppato almeno una colonna, un grafico a torta Dati correnti viene generato, in base a questo raggruppamento. Se sono raggruppate più colonne, ciò viene indicato nel grafico.

Spostando il cursore sul grafico a torta viene visualizzato il valore aggregato per il segmento appropriato. Utilizza l’aggregato attualmente definito per la colonna, ad esempio conteggio, minimo, media, tra gli altri.

Filtri e aggregati

Nelle colonne appropriate, puoi anche configurare Impostazioni filtro e/o Aggregati dal menu a discesa della colonna.

Filtri

Impostazioni filtro consente di specificare i criteri per le voci da visualizzare. Gli operatori disponibili sono:

• contains
• equals

Per impostare un filtro:

1. Seleziona l’operatore desiderato dall’elenco a discesa.
2. Immettere il testo su cui applicare il filtro.
3. Fai clic su Applica.

Per disattivare il filtro:

1. Rimuovi il testo del filtro.
2. Fai clic su Applica.

Aggregati

Puoi anche selezionare un metodo di aggregazione (che può variare a seconda della colonna selezionata):

Proprietà colonna

Questa opzione è disponibile solo quando Colonna generica è stato utilizzato in Report utente.

Dati storici

Un grafico della variazione dei dati nel tempo può essere visto in Dati storici. Questo deriva da istantanee scattate a intervalli regolari.

Dati:

• Raccolto da, se disponibile, la prima colonna ordinata, altrimenti la prima colonna (non raggruppata)
• Raggruppato per la colonna appropriata

Il rapporto può essere generato:

1. Imposta Raggruppamento nella colonna richiesta.

2. Modifica la configurazione che consente di definire istantanee orarie o giornaliere.

3. Fine… la definizione per avviare la raccolta di snapshot.

   Il pulsante cursore rosso/verde in alto a sinistra indica quando vengono raccolte le istantanee.

Il grafico risultante è mostrato in basso a destra:

Quando inizia la raccolta dei dati, puoi selezionare:

• Periodo

  È possibile selezionare le date di inizio e di fine per la visualizzazione dei dati del rapporto.

• Intervallo

  Mese, Settimana, Giorno, Ora possono essere selezionati per la scala e l’aggregazione del rapporto.

  Ad esempio, se per febbraio 2011 sono disponibili snapshot giornaliere:

  • Se l'intervallo è impostato su Day, ogni istantanea viene visualizzata come un singolo valore nel grafico.
  • Se l'intervallo è impostato su Month, tutte le istantanee di febbraio vengono aggregate in un singolo valore (visualizzato come un singolo punto nel grafico).

Seleziona le tue esigenze, quindi fai clic su Vai per applicarli al report. Per aggiornare la visualizzazione dopo aver creato ulteriori snapshot, fare clic su Vai di nuovo.

Quando si raccolgono gli snapshot, è possibile:

• Utilizzare Fine… per reinizializzare la raccolta.

  Fine "congela" la struttura del report (ovvero le colonne assegnate al report e che sono raggruppate, ordinate, filtrate e così via) e inizia a creare snapshot.

• Apri Modifica finestra di dialogo per selezionare Nessuna istantanea di dati per terminare la raccolta fino a quando non è necessario.

  Modifica attiva o disattiva solo l'acquisizione di istantanee. Se l'acquisizione delle istantanee viene nuovamente attivata, viene utilizzato lo stato del report al termine dell'ultima esecuzione per l'acquisizione di ulteriori istantanee.

Limiti di visualizzazione

Il rapporto sui dati storici può anche cambiare leggermente nell’aspetto a causa dei limiti che possono essere impostati, in base al numero di risultati per il periodo selezionato.

Ogni linea orizzontale è nota come serie (e corrisponde a una voce nella legenda del grafico), ogni colonna verticale di punti rappresenta gli snapshot aggregati.

Per mantenere il grafico pulito per periodi di tempo più lunghi, è possibile impostare alcuni limiti. Per i rapporti standard:

• serie orizzontale: valore predefinito e massimo del sistema. 9

• snapshot aggregati verticali: il valore predefinito è 35 (per serie orizzontale)

Pertanto, quando i limiti (appropriati) vengono superati:

• i punti non vengono visualizzati
• la legenda del grafico dati cronologici potrebbe mostrare un numero di voci diverso da quello del grafico dati corrente

I rapporti personalizzati possono anche mostrare Totale per tutte le serie. Viene visualizzata come una serie (linea orizzontale e voce nella legenda).

Modifica (Report)

Il Modifica apre il pulsante Modifica Report Finestra di dialogo.

Questa è una posizione in cui il periodo per la raccolta degli snapshot per Dati storici è definito, ma è possibile definire anche diverse altre impostazioni:

• Titolo

  Puoi definire un titolo personalizzato.

• Descrizione

  Puoi definire una tua descrizione.

• Percorso directory principale (attivo solo per alcuni rapporti)

  Utilizzare questa opzione per limitare il report a una sezione (secondaria) dell’archivio.

• Elaborazione rapporto

  • aggiorna i dati automaticamente

    I dati del rapporto vengono aggiornati ogni volta che si aggiorna la definizione del rapporto.

  • aggiorna i dati manualmente

    Questa opzione può essere utilizzata per evitare ritardi causati da operazioni di aggiornamento automatico quando il volume di dati è elevato.

    Selezionando questa opzione, i dati del rapporto devono essere aggiornati manualmente quando viene modificato un qualsiasi aspetto della configurazione del rapporto. Significa anche che quando modifichi un aspetto della configurazione, la tabella del rapporto risulta vuota.

    Quando selezionato, il Carica dati viene visualizzato (accanto a Modifica sulla relazione). Carica dati carica i dati e aggiorna i dati del rapporto visualizzati.

• Snapshot
  È possibile definire la frequenza delle istantanee, giornaliera, oraria o non.

Carica dati

Il Carica dati è visibile solo quando aggiorna dati manualmente è stato selezionato da Modifica.

Clic Carica dati ricarica i dati e aggiorna il rapporto visualizzato.

Selezionando di aggiornare manualmente i dati si ottiene quanto segue:

1. Quando modifichi la configurazione del rapporto, la tabella dei dati del rapporto risulta vuota.

   Ad esempio, se modifichi il meccanismo di ordinamento di una colonna, i dati non vengono visualizzati.

2. Se si desidera visualizzare nuovamente i dati del report, è necessario fare clic su Carica dati per ricaricare i dati.

Fine (rapporto)

Quando Fine la relazione:

• Definizione del rapporto a partire da quel momento viene utilizzato per creare le istantanee. In seguito, è possibile continuare a lavorare su una definizione di report perché è separata dalle istantanee.
• Eventuali snapshot esistenti vengono rimossi.
• Vengono raccolti nuovi snapshot per Dati storici.

Questa finestra di dialogo consente di definire o aggiornare il titolo e la descrizione del report risultante.

Tipi di rapporti

Report componente

Il rapporto sui componenti fornisce informazioni sull’utilizzo dei componenti da parte del sito web.

Colonne di informazioni informazioni su:

• Autore
• Percorso componente
• Tipo componente
• Ultima modifica
• Pagina

Ciò significa che è possibile visualizzare quanto segue:

• Quali componenti vengono utilizzati e dove vengono utilizzati.

  Utile, ad esempio, durante il test.

• Come vengono distribuite le istanze di un componente specifico.

  Questo può essere interessante se pagine specifiche (ovvero, "pagine pesanti") riscontrano problemi di prestazioni.

• Identificare le parti del sito con modifiche frequenti/meno frequenti.

• Scopri come il contenuto della pagina si sviluppa nel tempo.

Tutti i componenti sono inclusi, standard per prodotto e specifici per progetto. Utilizzo di Modifica l'utente può anche impostare una Percorso directory principale che definisce il punto d’inizio del rapporto: tutti i componenti sotto tale radice vengono considerati per il rapporto.

Utilizzo disco

Il report sull'utilizzo del disco mostra informazioni sui dati archiviati nel repository.

Il report inizia nella directory principale ( / ) dell’archivio facendo clic su un ramo specifico che è possibile espandere all’interno dell’archivio (il percorso corrente si riflette nel titolo del report).

Verifica stato

Questo rapporto analizza il registro di richieste corrente:

<cq-installation-dir>/crx-quickstart/logs/request.log

Per aiutarti a identificare le richieste più costose in un dato periodo.

Per generare il rapporto, puoi specificare quanto segue:

• Periodo (ore)

  Il numero di ore (passate) da analizzare.

  Predefiniti: 24

• max. Risultati

  Numero massimo di righe di output.

  Predefiniti: 50

• max Richieste

  Numero massimo di richieste da analizzare.

  Predefinito: -1 (tutti)

• Indirizzo e-mail

  Invia i risultati a un indirizzo e-mail.

  Facoltativo; predefinito: vuoto

• Esegui ogni giorno alle (hh: mm)

  Specificare un orario per l'esecuzione automatica giornaliera del report.

  Facoltativo; predefinito: vuoto

Report attività pagina

Il rapporto di attività della pagina elenca le pagine e le relative azioni.

Colonne di informazioni informazioni su:

• Pagina
• stimato
• Tipo
• User

Ciò consente di monitorare:

• Modifiche più recenti.
• Autori che lavorano su pagine specifiche.
• Pagine che non sono state modificate di recente, quindi potrebbe essere necessario intervenire.
• Pagine modificate più/meno frequentemente.
• Utenti più/meno attivi.

Il rapporto attività pagina prende tutte le sue informazioni dal registro di audit. Per impostazione predefinita, il percorso della directory principale è configurato per il registro di controllo in /var/audit/com.day.cq.wcm.core.page.

Report di contenuti generati dall'utente

Questo rapporto fornisce informazioni sui contenuti generati dagli utenti, che si tratti di commenti, valutazioni o forum.

Colonne di informazioni il:

• Data
• Indirizzo IP
• Pagina
• Referrer
• Tipo
• Identificatore utente

Consente di:

• Scopri quali pagine ricevono il maggior numero di commenti.
• Ottieni una panoramica di tutti i commenti lasciati da specifici visitatori del sito, forse correlati ai problemi.
• Valuta se i nuovi contenuti provocano commenti monitorando quando vengono aggiunti commenti su una pagina.

Report utente

Questo rapporto fornisce informazioni su tutti gli utenti che hanno registrato un account e/o un profilo, che può includere sia autori all’interno della tua organizzazione che visitatori esterni.

Colonne di informazioni (se disponibile) informazioni su:

• Età
• Paese
• Dominio
• E-mail
• Cognome
• Genere
• Generico
• Nome assegnato
• Info
• Interesse
• Lingua
• Hashcode NTLM
• ID utente

Consente di:

• Scopri la distribuzione demografica degli utenti.
• Generare rapporti sui campi personalizzati aggiunti ai profili.

Colonna generica

Il Generico è disponibile nel Report utente, in modo da poter accedere a informazioni personalizzate, in genere profili utentead esempio, Colore preferito come descritto in Aggiunta di campi alla definizione del profilo.

La finestra di dialogo Colonna generica (Generic column) viene aperta quando eseguite una delle seguenti operazioni:

• Trascina il componente generico dalla barra laterale al rapporto.
• Selezionare le Proprietà colonna per una colonna generica esistente.

Dalla sezione Definizioni scheda che puoi definire:

• Titolo

  Titolo personalizzato per la colonna generica.

• Proprietà

  Il nome della proprietà come memorizzato nell’archivio, in genere all’interno del profilo dell’utente.

• Percorso

  Di solito la proprietà viene ricavata da profile.

• Tipo

  Seleziona il tipo di campo da String, Number, Integer, Date.

• Aggregato predefinito

  Definisce l’aggregato utilizzato per impostazione predefinita se la colonna è separata in un rapporto con almeno una colonna raggruppata. Seleziona l’aggregato richiesto da Count, Minimum, Average, Maximum, Sum.

  Ad esempio: Conteggio per un String campo indica che il numero di String vengono visualizzati i valori per la colonna nello stato aggregato.

In Esteso , puoi anche definire gli aggregati e i filtri disponibili:

Report di istanze flusso di lavoro

Questo offre una panoramica concisa, fornendo informazioni sulle singole istanze dei flussi di lavoro, sia in esecuzione che completati.

Colonne di informazioni informazioni su:

• Completato
• Durata
• Iniziatore
• Modello
• Payload
• Avviato
• Stato

Ciò significa che è possibile:

• Monitora la durata media dei flussi di lavoro; se ciò accade regolarmente, può evidenziare i problemi con il flusso di lavoro.

Report di workflow

Vengono fornite statistiche chiave sui flussi di lavoro in esecuzione nell’istanza.

Utilizzo dei rapporti in un ambiente di pubblicazione

Dopo aver configurato i rapporti in base a esigenze specifiche, puoi attivarli per trasferire la configurazione nell’ambiente di pubblicazione.

Il report appropriato è quindi accessibile in

/etc/reports

Ad esempio, il rapporto User-Generated Content (Contenuto generato dall’utente) si trova in:

http://localhost:4503/etc/reports/ugcreport.html

Questo ora genera rapporti sui dati raccolti dall’ambiente di pubblicazione.

Poiché nell’ambiente di pubblicazione non è consentita alcuna configurazione di report, il Modifica e Fine non sono disponibili. Tuttavia, puoi selezionare Periodo e Interval per Dati storici segnala se gli snapshot vengono raccolti.

Autorizzazioni necessarie per l’esecuzione dei rapporti

Le autorizzazioni necessarie dipendono dall’azione:

• I dati del rapporto vengono raccolti utilizzando i privilegi dell’utente corrente.
• I dati storici vengono raccolti utilizzando i privilegi dell’utente che ha completato il rapporto.

In un’installazione standard dell’AEM sono preimpostate le seguenti autorizzazioni per i rapporti:

• Report utente

  user administrators - lettura e scrittura

• Report attività pagina

  contributors - lettura e scrittura

• Report componente

  contributors - lettura e scrittura

• Report di contenuti generati dall'utente

  contributors - lettura e scrittura

• Report di istanze flusso di lavoro

  workflow-users - lettura e scrittura

Tutti i membri del administrators dispongono dei diritti necessari per creare rapporti.