Logger degli eventi

BrowseName: EventLogger
SuperType: Oggetto (BaseObjectType)
Percorso nella TypeView: Tipi > Loggers > Logger degli eventi

Registra le proprietà di uno o più tipi di evento d’interesse generati da uno specifico nodo e/o dai suoi nodi figli o da qualsiasi nodo del progetto e li memorizza in un database.

Applicazioni

Usato tipicamente per registrare e visualizzare lo storico di eventi di interesse, per esempio le attivazioni degli allarmi.

Configurare l’oggetto

Configurare un Logger degli eventi

  1. Selezionare gli eventi di interesse

  2. Selezionare le proprietà degli eventi da registrare e memorizzare

  3. (Opzionale) Per memorizzare nel database le traduzioni delle stringhe localizzare (dati di tipo LocalizedText), inserire gli identificativi di localizzazione nella proprietà Localizzazioni (vedere Localizzazione).

  4. 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 image07565D13 accanto a Configurazione d’evento: compare il set di proprietà di configurazione dell’evento.

  1. 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

  1. 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.

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

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

Selezionare le proprietà degli eventi da registrare e memorizzare

  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.

Proprietà

Nome

BrowseName

DataType

Descrizione

Abilitato

Enabled

Boolean

Abilita/disabilita la registrazione degli eventi.

Localizzazioni

Locales

String

Localizzazioni di interesse per memorizzare nel database le traduzioni di dati di tipo LocalizedText, tipicamente le descrizioni degli eventi. A ogni localizzazione corrisponde una colonna aggiuntiva nel database per ogni proprietà localizzata. Se vuota, le localizzazioni sono quelle previste dal progetto (proprietà Localizzazioni del nodo radice del progetto).

Database

Store

NodeId

Database in cui memorizzare i dati degli eventi.

Configurazioni d'evento

EventConfigurations

Collezione di EventConfiguration

Collezione di oggetti Configurazione d’evento. Se vuota, registra gli eventi generati da qualsiasi nodo del progetto.

Percorsi a campi d'evento

EventFieldPaths

Collezione di EventFieldPath

Argomenti d'evento

EventArguments

Campi d'evento da loggare

EventFieldsToLog

Collezione di EventFieldToLog

Proprietà da registrare dei diversi eventi di interesse

Vedi anche

Concetti correlati

Logger degli eventi

Procedure correlate

Usare i Logger degli eventi