====== DocWay4 - Audit e Log ======

L'applicativo DocWay mette a dispozione due differenti livelli di tracciatura delle operazioni:

  * **Audit trail**: la piattaforma documentale DocWay ---in quanto ERMS MoReq2 compliant--- è dotata di un sistema di audit interno che registra le operazioni principali compiute dagli utenti sui documenti (o meglio record elettronici), sui fascicoli e sui raccoglitori del sistema utilizzando le funzionalità messe a disposizione dell'applicativo. 
  * **Log**: l'applicativo DocWay scrive sostanzialmente due file: ''docway4.log'' e ''docway4-service.log'',

===== Audit =====

Le informazioni che registra il sistema di Audit sono memorizzate come un frammento xml che va a far parte dei metadati del record stesso. ExtraWay Server garantisce l'inalterabilità e la non modificabilità di tali informazioni e ne garantisce la sicurezza contro manomissioni da parte di terzi. Queste informazioni, assieme a quelle registrate da eXtraWay stesso concorrono alle caratteristiche di autenticità e integrità dei record elettronici gestiti dalla piattaforma.\\
Le informazioni di audit di DocWay sono disponibili direttamente dall'applicativo nella sezione **INFORMAZIONI DI SERVIZIO**.\\
Nella seguente tabella sono riportate tutte le operazioni che vengono tracciate. Le colonne riportano:
  * **name()**: nome dell'elemento xml relativo all'operazione; 
  * **descrizione**: indica le descrizione del tipo di operazione (non contenuta nell'xml, ma utile ai fini di lettura della tabella);
  * **TS (@data, @ora)**: gli attributi data e ora costituiscono il timestamp dell'operazione;
  * **operatore (@oper, @cod_oper, @uff_oper, @cod_uff_oper)**: nome e codici di operatore e ufficio di appartenenza (identificano chi ha effettuato l'operazione);
  * **operatore lite (@operatore, @cod_operatore)**: alternativa alla colonna sopra identifica ufficio e operatore di chi ha effettuato l'operazione (rispetto alla modalità sopra non viene registrato il codice dell'ufficio);
  * **assegnatario (@nome_persona, @nome_uff, @cod_persona, @cod_uff)**: questi attributi identificano persona e ufficio (con relativi codici) del beneficiario dell'operazione. Sono utilizzati per le operazoni relative alle assegnazioni di documenti;
  * **visto (@visto_da, @data_visto, @ora_visto)**: questi attributi memorizzano le informazioni di visto relativamente ad una assegnazione;
  * **scarto (@data_scarto, @ora_scarto, @scartato_da)**: questi attributi memorizzano le informazioni di scarto relativamente ad una assegnazione in copia conoscenza;
  * **text()**: questa colonna riporta le informazioni sull'eventuale nodo testo relativo all'elemento xml dell'operazione (se valorizzato indica con quale criterio).

^ name()                       ^ descrizione                                                                                                                                                                        ^ TS                       ^ operatore                ^ operatore lite           ^ assegnatario             ^ visto                    ^ scarto                   ^ text()                                                                                          ^
| acquisizione_immagini        |  funzionalità specifica per l'acquisizione di immagini (anche differita) tramite apposito pulsante                                                                                 |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| annullamento                 |  annullamento di un un documento                                                                                                                                                   |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  motivazione dell'annullamento                                                                  |
| apertura                     |  apertura di un fascicolo                                                                                                                                                          |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| assegnazione_cc              |  assegnazione in Copia Conoscenza                                                                                                                                                  |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>                                                                           |
| assegnazione_cds             |  assegnazione in Conferenza Di Servizi                                                                                                                                             |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| assegnazione_intervento      |  assegnazione del diritto di intervento a un CC                                                                                                                                    |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| assegnazione_op              |  assegnazione a Operatore Incaricato                                                                                                                                               |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| assegnazione_opm             |  assegnazione a Operatore Incaricato Minuta                                                                                                                                        |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| cestino                      |  cancellazione logica di un documento tramite Cestino                                                                                                                              |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| chiusura                     |  chiusura di un fascicolo                                                                                                                                                          |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
^ name()                       ^ descrizione                                                                                                                                                                        ^ TS                       ^ operatore                ^ operatore lite           ^ assegnatario             ^ visto                    ^ scarto                   ^ text()                                                                                          ^
| creazione                    |  creazione di un nuovo documento / fascicolo / raccoglitore                                                                                                                        |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| incaricato_tenuta_fascicolo  |  assegnazione a Incaricato Tenuta Fascicolo                                                                                                                                        |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
|                              |  inserimento / rimozione di un documento in un fascicolo. Sono gestiti due ulteriori attributi: \\ **@codice**: codice del fascicolo  \\ **@tipo**: inserimento / rimozione        |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| in_raccoglitore              |  inserimento / rimozione di un documento in un raccoglitore. Sono gestiti due ulteriori attributi: \\ **@codice**: codice del raccoglitore  \\ **@tipo**: inserimento / rimozione  |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| modClassif                   | modifica alla classificazione di un documento                                                                                                                                      |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| modClassifMinuta             | modifica alla classificazione della minuta del documento                                                                                                                           |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| modifica                     | modifica ai dati di un documento. E' gestito un ulteriore attributo: \\ **@azione**: tipo dell'azione (opzionale)                                                                  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  l'elemento figlio opzionale **mod_intervento** contiene l'eventuale dettaglio delle modifiche  |
| protocollazione              |  trasformazione di una bozza di protocollo in un protocollo                                                                                                                        |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| reso                         |  rigetto al protocollista                                                                                                                                                          |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
^ name()                       ^ descrizione                                                                                                                                                                        ^ TS                       ^ operatore                ^ operatore lite           ^ assegnatario             ^ visto                    ^ scarto                   ^ text()                                                                                          ^
| responsabilita               |  assgnazione UOR-RPA                                                                                                                                                               |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| responsabilita_minuta        |  assegnazione UOR-RPA minuta                                                                                                                                                       |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| rimozione_cc                 |  rimozione assegnazione in Copia Conoscenza                                                                                                                                        |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| rimozione_cds                |  rimozione assegnazione in Conferenza di Servizi                                                                                                                                   |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| rimozione_intervento         |  rimozione diritto di intervento a una assegnazione in CC                                                                                                                          |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| rimozione_op                 |  rimozione assegnazione operatore incaricato                                                                                                                                       |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| rimozione_opm                |  rimozione assegnazione operatore incaricato minuta                                                                                                                                |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| ripristino_cestino           |  operazione di ripristino del documento dal cestino                                                                                                                                |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| scartoRuoli                  |  scarto dei ruoli                                                                                                                                                                  |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| segnatura                    |  applicazione della segnatura di protocollo                                                                                                                                        |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| trasferimento                |  trasferimento massivo di fascicoli                                                                                                                                                |  <color green>✔</color>  |  <color red>✘</color>    |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| trasformazioneRepertorio     |  trasformazione di un documento in repertorio                                                                                                                                      |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |
| ultima_modifica              |  ultima modifica effettuata sul documento / repertorio / fascicolo                                                                                                                 |  <color green>✔</color>  |  <color green>✔</color>  |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>    |  <color red>✘</color>                                                                           |

===== Log =====

In DocWay la produzione dei log è affidata alla libreria di logging [[ https://logging.apache.org/log4j/1.2/m|Apache log4j 1.2]]. \\

La configurazione di base prevede la produzione di log ciclici: ''docway4.log'', ''docway4.log.1''...''docway4.log.<n>'' e ''docway4-service.log'', ''docway4-service.log.1''...''docway4-service.log.<n>'':
  * ''docway4.log'': si tratta dei log dell'applicativo DocWay vero e proprio, ossia della web application scritta utilizzando il framework Java Server Faces. Questi log sostanzialmente hanno come scopo quello di tracciare eventuali errori applicativi per facilitarne l'individuazione e la risoluzione;
  * ''docway4-service.log'': in questi log vengono tracciate tutte le richieste HTTP che vengono effettuate dalla web application DocWay4 verso la web application di backend denominata Service. Il Service identifica ossia lo strato software che riceve tutte le richieste, le elabora e restituisce il risultato. Questo log è destinato ad un utilizzo prettamente sistemistico per l'indiduazione degli errori anche se traccia tutte le operazioni del sistema: utente, timestamp, parametri.

==== docway4-service.log ====

Tutte le richieste in ingresso vengono tracciate tramite una stringa del tipo: \\
''<acl o docway jsp (resource path)> entering request #<request number> {key-value pairs (http parameters)}''
\\ \\
La fine delle richieste viene tracciata tramite una stringa del tipo: \\
''<acl o docway jsp (resource path)> exiting request #<request number> (<elapsed time>ms)''