Configurare un logger per audit¶
Premessa
Questo tutorial illustra i passi principali per configurare un logger degli eventi per fare audit rispetto ai cambiamenti di valore degli attributi dei nodi d’interesse. Registra quindi le occorrenze dell’evento AuditWriteUpdateEventType generate all’interno del nodo Model.
I dati raccolti sull’evento sono i seguenti:
Sorgente dell’evento, ovvero il nodo del progetto su cui si ascoltano gli eventi.
Informazioni di identificazione dell’utente che ha generato l’evento.
Data e ora dell’evento.
Dati di cambiamento del valore dell’attributo (prima/dopo la modifica).
Scarica il progetto di esempio da qui. In questo esempio, oltre al logger AttributeChangeLogger oggetto del tutorial, sono presenti diversi logger che registrano ognuno un solo evento di audit.
Per un esempio di logger che registra più tipi di eventi di audit, scarica il progetto di esempio da qui.
Passi
Aggiungere un logger degli eventi
In Progetto fare clic destro su Loggers, poi scegliere Nuovo, quindi fare clic su Logger degli eventi: compare EventLogger1, nel progetto di esempio rinominato AttributeChangeLogger.
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.
Configurare la sorgente dell’evento e il tipo di evento da ascoltare
Fare clic su
accanto a Configurazione d’evento: compare il set di proprietà per la configurazione dell’evento.Accanto a Sorgente dell’evento fare clic su
e selezionare il nodo di progetto d’interesse. Nell’esempio, la sorgente dell’evento è il nodo Model.Impostare la proprietà Ascolta sottoalbero su Vero: il logger registra anche gli eventi d’interesse generati nei nodi figli della cartella Model.
Accanto a Tipo di evento fare clic su
e selezionare AuditWriteUpdateEventType.Impostare Escludi sessioni non interattive su Vero.
In Progetto fare doppio clic sull’oggetto Logger degli eventi: nell’editor degli oggetti viene visualizzato l’elenco delle proprietà del tipo di evento selezionato.
Selezionare le proprietà d’interesse dell’evento
Fare doppio clic sul logger degli eventi: nell’editor compare la lista completa delle proprietà del tipo di evento AuditWriteUpdateEventType.
Selezionare le proprietà seguenti.
Proprietà
Descrizione
SourceName
BrowseName del nodo
SourceNode
Percorso del nodo
Time
Timestamp dell’azione svolta dall’utente
ClientUserId
ID dell’utente di sessione
AttributeId
Nome dell’attributo modificato
NewValue
Nuovo valore dell’attributo
OldValue
Vecchio valore dell’attributo
Fare clic su Applica per confermare le proprietà da registrare: le proprietà compaiono in Campi d’evento da loggare. Nel database si creano automaticamente colonne corrispondenti alle proprietà selezionate.
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.
Configurare una proprietà personalizzata per l’evento
Oltre alle proprietà native dell’evento d’interesse, è possibile aggiungere proprietà personalizzate.
Nel progetto d’esempio è stata aggiunta la proprietà personalizzata ValueChange, ovvero una stringa localizzabile che mostra i valori OldValue e NewValue dell’attributo che ha subito un cambiamento.
Per aggiungere una proprietà da registrare, fare clic su
accanto a Campi d’evento da loggare: compare la nuova proprietà, rinominata ValueChange nel progetto di esempio.Per usare i valori OldValue e NewValue nella proprietà è necessario configurare un collegamento dinamico avanzato usando un convertitore di tipo Formattatore di stringhe. Fare riferimento al progetto di esempio per la configurazione. Per dettagli sul convertitore fare riferimento a Formattatore di stringhe.