1. Help
2. Funzionalità principali
3. Logger
4. Usare i Logger degli eventi

Usare i Logger degli eventi

Introduzione

A seconda delle esigenze di progettazione è possibile scegliere se registrare con lo stesso logger un solo tipo di evento o più tipi di eventi. Di seguito sono descritti gli effetti dei due tipi di configurazione:

Configurazione	Effetti
Un logger per ogni tipo di evento di interesse	A ogni tipo di evento corrisponde una tabella dedicata nel database. Ogni colonna della tabella corrisponde a una proprietà d’interesse del tipo di evento, quindi in ogni riga, ovvero per ogni evento, vengono valorizzate le stesse colonne.
Un logger per più tipi di eventi di interesse	Le proprietà di tutti gli eventi vengono registrate in un’unica tabella del database. Le colonne della tabella sono relative a tutte le proprietà di interesse di tutti i tipi di eventi registrati, quindi in ogni riga (ovvero per ogni evento) vengono valorizzate solo le colonne relative al tipo di evento di riferimento.

Nota

nella libreria dei template è disponibile l’oggetto Logger degli eventi di audit, ovvero un Logger degli eventi di audit già configurato per registrare i tipi di evento UserSessionEvent, RecipeApplicationEvent e AuditConditionEventType.

I dati registrati dal Logger degli eventi possono essere esportati in formato CSV, o visualizzati nell’applicazione in una griglia dati (vedere Visualizzare in tabella i dati memorizzati).

Configurare un Logger degli eventi

1. In Progetto fare clic destro su Loggers, quindi fare clic su Nuovo > Logger degli eventi.

2. Selezionare gli eventi di interesse

3. Selezionare le proprietà di interesse degli eventi

4. (Opzionale) Per memorizzare nel database le traduzioni delle stringhe localizzate (dati di tipo LocalizedText, per esempio i messaggi degli eventi di allarme), inserire gli identificativi di localizzazione nella proprietà Localizzazioni (es. «en-US», vedere Localizzazione).

5. Nella proprietà Database selezionare il database in cui memorizzare le proprietà selezionate: nel database viene creata e configurata automaticamente una tabella per ogni tipo di evento, e in ogni tabella una colonna per ogni proprietà da memorizzare.

Selezionare gli eventi di interesse

1. Per selezionare un evento di interesse, nelle proprietà del Logger degli eventi fare clic su accanto a Configurazione d’evento: compare il set di proprietà di configurazione dell’evento.

2. Impostare i nodi/oggetti sorgenti dell’evento:

   Sorgente	Valore proprietà Sorgente dell’evento	Valore proprietà Ascolta sottoalbero
   qualsiasi oggetto del progetto	(nessun valore)	Vero
   un nodo/oggetto e da tutti i suoi oggetti figli	collegamento dinamico con il nodo/oggetto padre	Vero
   uno specifico oggetto del progetto	collegamento dinamico con lo specifico oggetto	Falso

3. Nella proprietà Tipo di evento selezionare il tipo di evento di interesse.

   Suggerimento

   per i tipi di eventi di audit è consigliato creare un logger dedicato.

4. Per registrare i soli eventi generati da interazioni dell’utente con l’applicazione, impostare Escludi sessioni non interattive su Vero.

5. Ripetere i passi procedenti per ogni tipo di evento di interesse.

Selezionare le proprietà di interesse degli eventi

1. In Progetto fare doppio clic sull’oggetto Logger degli eventi: nell’editor degli oggetti viene visualizzato l’elenco delle proprietà di tutti i tipi di eventi selezionati.

2. Selezionare le proprietà da registrare, poi fare clic su Applica: le proprietà compaiono in Campi d’evento da loggare.

Nota

quando si seleziona una proprietà da registrare, viene automaticamente impostato un collegamento dinamico con essa all’interno di Campi d’evento da loggare. Il collegamento dinamico punta a un attributo selezionato automaticamente da Q Studio. Se l’attributo non rappresenta il dato di interesse, selezionare un attributo diverso nella finestra del collegamento dinamico.

Visualizzare in tabella i dati memorizzati

1. Creare un oggetto Griglia dati e aprirlo nell’editor.

2. Trascinare l’oggetto Logger degli eventi desiderato dal pannello Progetto all’interno dell’oggetto Griglia dati nell’editor: l’oggetto Griglia dati viene automaticamente configurato per visualizzare i dati memorizzati nel database.

Nota

per visualizzare a runtime i dati aggiornati in tempo reale, configurare l’invocazione del metodo Aggiorna dell’oggetto Griglia dati. Tipicamente si associa questo metodo a un evento di un oggetto Pulsante.

Vedi anche

Concetti correlati

DataStore (database)

Logger degli eventi

Procedure correlate

Lavorare con i database

Esempi applicativi

Tutorial logger eventi localizzato

Configurare un logger per audit

Riferimenti

Logger degli eventi