====== Audit - Manuale utente ======

===== Introduzione =====

Audit è un **modulo** di DocWay che ha l’obiettivo di registrare tutte le **azioni** svolte su **DocWay** (e **ACL**) da parte degli **operatori** registrandole in un apposito **archivio mongoDB**, autonomo dall’archivio DocWay (a ACL), in modo da garantire l’**integrità** e l’**indipendenza** dei **dati registrati**.

Infatti i **dati registrati** nel modulo di Audit (messi a disposizione per la consultazione) garantiscono l'**inalterabilità** e la **non modificabilità** delle **informazioni** stesse e la **sicurezza** contro manomissioni da parte di terzi.

**N.B**: La sigla **ACL** sta per //**Access Control List**//.

==== Destinatari manuale ====

I **destinatari** del manuale sono il **personale interno** Avepa, in particolar modo gli **amministratori** dell’applicativo **DocWay**.
==== Organizzazione manuale ====

Il manuale è organizzato sulla base delle **funzionalità** del **sistema**. Le singole funzionalità vengono descritte nello specifico, tramite le **interfacce applicative**, in modo da essere una guida puntuale per l’**utente** nella comprensione dell’**utilizzo** dell’**applicativo**.
==== Struttura manuale ====

Il manuale è stato strutturato in modo tale da seguire logicamente il **flusso** di **navigazione** dell’**applicativo** descrivendo le singole **funzionalità** messe a disposizione.
===== Accesso alla console =====

E' possibile effettuare l'**accesso** alla **console** di **Audit** tramite **menu** superiore di **DocWay**, cliccando su ''ALTRE FUNZIONI'' e poi su ''Console di Audit'' :


{{:utenti:audit:accesso_console_audit_da_docway.png|Accesso Console Audit da DocWay}}

L’**accesso** è **riservato** ai soli **utenti abilitati**. L’abilitazione viene assegnata tramite uno specifico **diritto** ''Accesso'' alla console di Audit applicativo, **attivabile** nel **profilo** dell’**utente** nella **sezione** ''Diritti speciali'' dell’**archivio ACL**:

{{:utenti:audit:diritti_speciali_archivio_acl.png|Diritti speciali archivio ACL}}

===== Home Page =====

La **Home Page** dell’applicativo si presenta suddivisa in due **sezioni**:

1. La **sezione** più **piccola**, posizionata a sinistra della pagina, contiene una serie di **filtri** che è possibile applicare per effettuare **ricerche mirate** sui **record** dell’**audit**:

{{:utenti:audit:sezione_filtri_audit_console.png|Sezione Filtri Audit Console}}

2. La **sezione** più **grande**, quella centrale, contiene la **lista** dei **record** di **Audit** e consente all’utente di accedere al **dettaglio** del singolo **record**:

{{:utenti:audit:sezione_lista_record_audit_console.png|Sezione Lista Record Audit Console}}

Al momento dell’accesso la **sezione centrale** viene valorizzata con la **lista** di tutti i **record** di **Audit** presenti, presentati in **ordine cronologico inverso** (dal più recente).

===== Esportazione CSV record =====

In alto nella lista dei record, a fianco del numero dei risultati trovati, tramite apposito pulsante di download, è possibile scaricare il file .CSV dei record:

{{:utenti:audit:esportazione_csv_record.png|Esportazione CSV record}}

===== Visualizzazione record =====

La sezione centrale, come detto in precedenza, contiene la **lista** dei **record** di **Audit**:

{{:utenti:audit:dati_identificativi_lista_record.png|Dati identificativi lista record}}

La lista è organizzata secondo una **tabella** contenente i seguenti **dati identificativi**:

  * ''AZIONE'' : **Tipo** di **azione** effettuata dall’**utente**;
  * ''ARCHIVIO'' : Indicazione dell’**archivio eXtraWay** su cui è stata effettuata l’**azione**; può assumere come **valori** ''xdocwaydoc'' se l’azione è stata effettuata sull’**archivio documentale** (modulo DocWay) o **ACL** se l’azione è stata effettuata sull’**archivio** delle **anagrafiche** (modulo ACL);
  * ''TIPO RECORD'' : Tipologia del **record eXtraWay** su cui è stata effettuata l’**azione**; per l’**archivio ACL** può assumere i seguenti **valori**: ''persona_interna - persona_esterna - struttura_interna - struttura_esterna - ruolo - gruppo - comune - aoo - casellaPostaElettronica'' ; per l’**archivio xdocwaydoc** può assumere i **valori** ''doc'' o ''fascicolo - raccoglitore'' ;
  * ''ID RECORD'' : **Identificativo univoco** del **record eXtraWay** su cui è stata effettuata l’**azione**;
  * ''UTENTE'' : **Username** dell’**utente** che ha effettuato l’**azione**;
  * ''DATA'' : **Timestamp** (data e ora) in cui è stata eseguita l’**azione**.

L’**elenco** completo delle **azioni** registrate per le **applicazioni DocWay** e **ACL**, e quindi dei **valori** che può assumere il **campo** ''AZIONE'' , è il seguente:

  * **DocWay**: //Accesso all'applicazione, annullamento documento, annotazione, acquisizione immagini, apertura fascicolo, assegnazione CC, assegnazione CDS, assegnazione diritto di intervento, assegnazione operatore incaricato, assegnazione operatore minuta, cestino, chiusura fascicolo, creazione documento/fascicolo/raccoglitore, incaricato tenuta fascicolo, inserimento/rimozione doc in/da fascicolo, modifica classificazione, da bozza a protocollo, rigetto al protocollista, assegnazione UOR-RPA, assegnazione UOR-RPA minuta, rimozione assegnazione CC, rimozione assegnazione CDS, rimozione diritto di intervento CC, rimozione operatore incaricato, rimozione operatore incaricato minuta, ripristino documento da cestino, scarto dei ruoli, segnatura, trasferimento di fascicoli, trasformazione doc in repertorio, qualsiasi modifica su documento/fascicolo/raccoglitore, visualizzazione documento (per visualizzazione del documento si intende qualsiasi apertura del documento da parte di qualsiasi operatore, anche se non esplicitamente incluso negli assegnatari del documento), controllo di gestione e reportistica, registro giornaliero di protocollo, stampa protocolli, stampa repertori;//
  * **ACL**: //Accesso all'applicazione, inserimento/modifica/rimozione di strutture interne, inserimento/modifica/rimozione di persone interne, inserimento/modifica/rimozione di profili, inserimento/modifica/rimozione di gruppi, inserimento/modifica/rimozione di ruoli, inserimento/modifica/rimozione di caselle di posta, modifica diritti speciali, modifica diritti di amministrazione.//
===== Dettaglio record =====

Per accedere al **dettaglio** del singolo **record** di **Audit** è necessario cliccare sulla **riga** del record che si vuole approfondire:

{{:utenti:audit:selezione_record_da_lista.png|Selezione record da lista}}

La **pagina** di **visualizzazione** del **record** di Audit riporta le **informazioni** suddivise in tre **sezioni**:

**1. INFORMAZIONI SULL'AZIONE**:

  * **Operazioni effettuate**: Contiene le **indicazioni** sull’**operazione** effettuata;
  * **Data**: Contiene le **informazioni** sulla **data** e **ora** in cui è stata effettuata l’**operazione**.  

**2. INFORMAZIONI SULL' UTENTE**:
 
  * **Username**: Contiene l’indicazione dell’**utente** che ha effettuato l’**operazione**;
  * **Codice utente**: Contiene la **matricola** dell’**utente** che ha effettuato l’**operazione**;
  * **Indirizzo IP**: Contiene l’**indirizzo IP** del PC da cui è arrivata la richiesta dell’**operazione**.

**3. INFORMAZIONI SUL RECORD**:

  * **Archivio**: Contiene l’indicazione dell’**archivio eXtraWay** su cui è stata effettuata l’**operazione**.

{{:utenti:audit:dettaglio_record_informazioni.png|Dettaglio record informazioni}}

In alto a destra della pagina sono presenti i **pulsanti** per navigare la **lista** dei **record** di **Audit**:

{{:utenti:audit:pulsanti_navigazione_lista_record.png|Pulsanti navigazione lista record Audit}}

  * Il **pulsante** a **sinistra** permette di caricare il **record precedente**;
  * Il **pulsante centrale** permette di tornare alla **lista** dei **record**;
  * Il **pulsante** a **destra** permette di caricare il **record successivo**.

===== Ricerca record =====

Le **operazioni** di **ricerca** consentono di filtrare la **lista** dei **record** di **Audit** visibili sulla sezione centrale in base a specifici **criteri** impostabili nella **sezione** ''Filtri'' . I **filtri** impostabili sono i seguenti:

  * ''Archivio'' : Consente di filtrare i **record** in base all’**archivio eXtraWay** di riferimento; lo scenario standard prevede gli **archivi** ''ACL'' (modulo ACL) e ''xdocwaydoc'' (modulo DOCWAY). Potrebbero esserci scenari in cui sono presenti altri **archivi eXtraWay** (cosiddetti **periferici**) che fanno riferimento a **AOO differenti**: \\ {{:utenti:audit:selezione_archivio_per_ricerca.png|Selezione archivio per ricerca}} 
  * ''Tipologia di record'' : Questo **filtro** si attiva una volta selezionato un **archivio** e contiene l’elenco delle **tipologie** di **record** a cui si riferiscono i record di Audit. Ad esempio, nel caso venisse selezionato l’**archivio** ''xdocwaydoc'' , il filtro presenta le **tipologie** ''doc'' , ''fascicolo'' (ed eventualmente raccoglitore): \\ {{:utenti:audit:selezione_tipologia_record_per_ricerca.png|Selezione tipologia record per ricerca}}
  * ''ID Record'' : Consente di filtrare i **risultati** sulla base di uno specifico **identificativo**; per ''ID Record'' si intende il codice identificativo univoco che identifica un **record** in un **archivio eXtraWay** (nrecord); tale identificativo viene visualizzato nella **sezione** ''Informazioni di servizio'' presente in ogni **record** visualizzato nell’applicativo **DocWay/ACL**. Pertanto questo filtro consente di individuare tutti i **record** di **Audit** ascrivibili ad uno specifico **record** di **DocWay** o di **ACL**;
  * ''Azione'' : Il **filtro** si attiva una volta selezionato un **archivio**; consente di filtrare la lista dei **risultati** in base al tipo di **azione** registrata nel record di Audit. E’ possibile selezionare una o più **azioni** in base a cui filtrare i risultati: \\ {{:utenti:audit:selezione_azione_per_ricerca.png|Selezione azione per ricerca}}
  * ''Username'' : Consente di filtrare i **risultati** dei **record** di **Audit** in base allo **username** che ha effettuato l’**operazione**; lo username equivale al **login** dell’**utente** registrato in **ACL**;
  * ''Data inizio e ora inizio'' : Consente di filtrare i **risultati** dei **record** di **Audit** impostando un **timestamp** (data e ora) di inizio a partire dal quale verranno visualizzati i **risultati**. Il **filtro** sull’**orario** si attiva solo se è stata selezionata una **data**;
  * ''Data fine e ora fine'' : Consente di filtrare i **risultati** dei **record** di **Audit** impostando un **timestamp** (data e ora) di fine fino a cui verranno visualizzati i **risultati**. Il **filtro** sull’**orario** si attiva solo se è stata selezionata una **data**.

I **valori** contenuti nei **filtri** ''Archivio'' , ''Tipologia di record'' e ''Azione'' sono ottenuti dinamicamente dall’**analisi** dei **dati** dell’**Audit**; pertanto se non fosse presente un **valore** che ci si aspetta, significa che tra i record di audit non ce n’è nessuno con quel valore. 

Infine per applicare il/i **filtro**/i impostato/i è necessario utilizzare il **pulsante** ''Cerca'' posizionato in fondo alla sezione:

{{:utenti:audit:pulsante_cerca_record.png|Pulsante Cerca record}}

A questo punto verranno mostrati i risultati trovati con i filtri di ricerca inseriti e selezionando, ad esempio, il primo risultato trovato:

{{:utenti:audit:risultati_trovati_e_selezione_record.png|Risultati trovati e selezione record}}

potremmo accedere al suo dettaglio informazioni:

{{:utenti:audit:dettaglio_informazioni_record_ricerca_filtri.png|Dettaglio informazioni record ricerca filtri}}

in cui potremmo visualizzare, in particolare:

  * **Informazioni sull'azione**: Con ''Operazione effettuate'' (in questo caso "ACQUISIZIONE_IMMAGINI") e ''Data'' ;
  * **Informazioni sull'utente**: Con ''Username'' e ''Codice utente'' ;
  * **Informazioni sul record**: Con ''Archivio'' (in questo caso "xdocwaydoc"), ''Tipologia di record'' (in questo caso "doc") e ''Id record'';
  * **Inserimento**: Con ''Campo'' e ''Valore inserito'' .
===== Logout utente e cambio lingua =====

Nella **Home Page** della **Console** di **Audit**, in alto a destra, è possibile effettuare il **logout** dall'applicativo oppure cambiare la **lingua**:

{{:utenti:audit:logout_utente_e_cambio_lingua.png|Logout utente e cambio lingua}}