utenti:msa:manuale_utente_vecchio []

Questa pagina è in sola lettura. Puoi visualizzare il sorgente, ma non puoi modificarlo. Contatta l'amministratore se pensi che ci sia un errore.
====== MSA - Manuale utente - Vecchio ======

===== Introduzione =====

La presente pagina del Wiki costituisce il **Manuale utente** della **Console** del **Mail Storage Agent** (**MSA**), applicativo creato per il **monitoraggio** del nuovo **archiviatore PEC/EMAIL** di **DocWay**.

Nella **tabella** di seguito si riporta l’**elenco** delle **abbreviazioni**, **acronimi** e **definizioni** utilizzati nei paragrafi seguenti:

^ Termine   ^ Descrizione                        ^
| **ANSC**  | Accademia Nazionale Santa Cecilia  |
| **PEC**   | Posta Elettronica Certificata      |
| **MSA**   | Mail Storage Agent                 |
| **ACL**   | Access Control List                |

==== Destinatari ====

I **destinatari** del **manuale** sono il **personale interno ANSC**, in particolar modo gli **amministratori** delle **caselle** di **posta** (email e PEC) configurate all’interno dell’applicativo **DocWay**.

==== Organizzazione ====

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 ====

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

==== Login e logout ====

Gli **utenti** autorizzati avranno a disposizione una **login** e una **password** da inserire nella pagina di **login** per effettuare l’**accesso** tramite **autenticazione** all’**applicativo**. 

Per effettuare il **logout** dall’**applicativo**, è necessario cliccare sull’**icona** dell’**omino** posta in alto a destra della pagina, e cliccare sulla funzione **logout**. 

{{:utenti:msa:logout_utente_e_cambio_lingua_msa.png|Logout utente e cambio lingua}}

L’**utente** esce dall’**applicativo**.
==== Home Page Console MSA ====

Dopo aver effettuato il **login** nell’**applicativo**, l’utente visualizza l’**Home Page** della **console** dell’**MSA**. 

La console permette di monitorare lo **stato** dei **messaggi archiviati** tramite **MSA** su **DocWay**, evidenziando lo stato dell’ultima esecuzione dell’MSA e gli **errori** riscontrati nello **scaricamento** dei singoli **messaggi email/PEC**, **suddivisi** in base alla **casella** mail di **provenienza**.

{{:utenti:msa:home_page_console_msa.png|Home Page Console MSA}}

L’**interfaccia** è suddivisa in due **parti**. Sulla **sinistr**a dello schermo è presente la **sezione** ''Posta'' , sulla **destra** dello schermo è presente la **sezione** ''Messaggi'' .
==== Sezione Caselle di posta ====

La **sezione** ''Posta'' contiene l’**elenco** di tutte le **caselle** di **posta** configurate all’interno dell’applicativo **DocWay**, nella **sezione** ''Caselle di posta'' dell’**ACL**. 

In questa **sezione** è possibile agire a **livello** di **caselle** di **posta**, agendo su tutti i **messaggi** pervenuti sulla singola **casella**. 

Nella **sezione** ''Caselle di posta'' sono presenti i **pulsanti** ''Errori'' e ''Rielabora'' , che agiscono su tutte le **caselle** di **posta** configurate.

{{:utenti:msa:sezione_caselle_di_posta_pulsanti_errori_e_rielabora_msa.png|Sezione Caselle di Posta Pulsanti Errori e Rielabora MSA}}

Il **pulsante** ''Errori'' permette di **ricaricare** tutti i **messaggi** in **errore** di tutte le **caselle** (visualizzati nella parte destra dello schermo nella sezione Messaggi), che vengono già ricaricati in **automatico** al momento della **login** nell’applicativo.

Il **pulsante** ''Rielabora'' permette di **modificare** lo **stato** di tutti i **messaggi**, passandolo da ''Error'' a ''Retry'' , in modo tale che l’**archiviatore**, nel momento in cui riparte con lo scaricamento delle email, rielabori tutti i **messaggi** presenti nello **stato** di ''Error'' in tutte le **caselle**. 

I **messaggi** in **errore** vengono infatti riprocessati solo se viene cliccato il **pulsante rielabora**, per evitare che il sistema rielabori in continuazione i messaggi in errore, mandando più volte le medesime **notifiche** di **errore**. 

Al termine della **rielaborazione** dei **messaggi** in **errore**, la **situazione** del dettaglio delle singole **caselle** sarà **aggiornata** con le eventuali **risoluzioni** di **errori** effettuate.

{{:utenti:msa:dettaglio_caselle_msa.png|Dettaglio Caselle MSA}}

Per ogni **casella** di **posta** presente vengono riportate le seguenti **informazioni**:

  * **Nome** della **casella**: **Nome** della **casella** registrato in **ACL** nel **campo** ''NOME'' ;
  * **Indirizzo**: **Indirizzo email** della **casella** configurato in **ACL** nel **campo** ''EMAIL'' della **sezione** ''Mailbox_in'' della **Casella** di posta;
  * **Stato**: Indica lo **stato** della **casella**, relativo all’**ultima esecuzione** dell’MSA;
  * **Errori**: Indica il **numero totale** di **messaggi PEC/EMAIL** in **errore** presenti sulla **casella** di posta;
  * **Azioni**: Permette di accedere ai **pulsanti** relativi alle **azioni** disponibili sulle singole **caselle ** ( ''Rielabora'' , ''Dettaglio'' , ''Errori'' ).

Lo **stato** è sempre relativo all’**ultima esecuzione** dell’**MSA**, e può avere due diversi **valori**:

  * ''Success'' : E' rappresentato dal **simbolo** della **spunta**, posizionandosi con il mouse sopra il simbolo viene visualizzata lo **stato** Success: {{:utenti:msa:valore_success_msa.png|Valore Success MSA}} 
  * ''Error'' : E' rappresentato dal **simbolo** del **triangolo** con il **punto esclamativo**, posizionandosi con il mouse sopra il simbolo viene visualizzata lo **stato** Error:{{:utenti:msa:valore_error_msa.png|Valore Error MSA}}

Lo **stato** indica se l’**MSA** è in grado di **processare** correttamente la **casella** di posta configurata sull’**ACL**:

  * Se lo **stato** è ''Success'' , la **casella** viene **processata correttamente**; 
  * Se lo **stato** è ''Error'' vuol dire che è stato riscontrato un **problema** nel **processare** la **casella** di posta (ad esempio perché non è possibile connettersi alla casella perché la password registrata è sbagliata). 
 
In **caso** di ''Error'' sarà necessario intervenire sulla **configurazione** della **casella** di posta lato **ACL** per risolvere i **problemi** di **connessione**. 

Nella **sezione** ''Azioni'' , posizionandosi sul **pulsante** ''Dettaglio'' con il mouse, viene mostrato il dettaglio relativo all’**ultima esecuzione** dell’**MSA** su quella **casella** di posta.

{{:utenti:msa:pulsante_dettaglio_msa.png|Pulsante Dettaglio}}

Il **dettaglio** riporta le **indicazioni** relative al totale dei **messaggi** trovati sulla **casella**, il **numero** di **messaggi** che sono stati **archiviati** correttamente su **DocWay** e l’eventuale numero degli **errori** riscontrati nell’**ultima esecuzione** dell’**MSA**. 

Viene inoltre riportata l’**informazione** relativa all’**inizio** e alla **fin**e dell’**elaborazione** della **casella** di posta da parte dell’**MSA** (data e ora).

Il **numero** degli **errori** disponibili nel **dettaglio** riporta quindi esclusivamente gli errori riscontrati nell’**ultima esecuzione** dell’**MSA** sulla **casella**; mentre nella **sezione** ''Errori'' viene riportato il **numero totale** di **messaggi** in **errore** rimasti sulla **casella**. Questo permette di avere un **controllo** capillare di tutti i **messaggi** passati sulla **casella** di posta.

Il **pulsante** ''Rielabora'' permette di riavviare il **processo** di **scaricamento** delle **mail** andate in **errore** presenti sulla singola **casella** da parte dell’**MSA**. I **messaggi** in **errore** vengono infatti riprocessati solo se viene cliccato il **pulsante** ''rielabora'', per evitare che il **sistema** rielabori in continuazione i messaggi in errore, mandando più volte le medesime **notifiche** di **errore**. 

Al termine della **rielaborazione** dei **messaggi** in **errore**, la situazione del **dettaglio** delle singole **caselle** sarà aggiornata con le eventuali **risoluzioni** di **errori** effettuate.

Il **pulsante** ''Errori'' permette di **aggiornare** il **numero** totale delle **mail** in **errore** presenti sulla **casella**. 
==== Sezione Messaggi ====

Nella **sezione** ''Messaggi'' sono invece visualizzati tutti i **messaggi** in **errore** di tutte le **caselle** di posta configurate. 

In questa **sezione** è possibile agire a **livello** di **singolo messaggio** in **errore**.

{{:utenti:msa:sezione_messaggi_msa.png|Sezione Messaggi MSA}}

Per **selezionare** la singola **mail** fra quelle presenti nella lista, è sufficiente posizionarsi con il mouse sulla relativa **riga** e cliccare il tasto destro. 

La **riga** viene evidenziata **in grigio**. Per muoversi nella **lista** è possibile utilizzare la **scrollbar** presente sulla destra della sezione. 

Per ogni **email** in **errore** vengono visualizzati i seguenti **dati**:

  * ''Nome della casella'' : **Nome** della **casella** registrato in **ACL** nel **campo** ''NOME'' ; 
  * ''Data invio'' : **Data** e **ora** dell’**invio** della **mail processata**;
  * ''Oggetto'' : **Oggetto** della **mail processata**;
  * ''Stato'' : Indica lo **stato** della **mail** relativo al suo scaricamento in DocWay da parte dell’MSA;
  * ''Azioni'' : Permette di accedere ai **pulsanti** relativi alle **azioni** disponibili sulle singole **caselle** (Rielabora, Dettaglio, EML).

Posizionando il **mouse** sull’**icona** della **busta** è possibile visualizzare il ''Message-ID'' della **mail processata**:

{{:utenti:msa:icona_busta_e_message_id_msa.png|Icona busta e Message Id}}

Lo **stato** segnala tramite l’apposito **simbolo** lo stato di **errore** della **mail**, ovvero che la mail non è stata scaricata correttamente su **DocWay** da parte dell’**MSA**. Posizionandosi con il mouse sopra il **simbolo** del **triangolo** viene visualizzata la **scritta** ''Error'' .

Nella **sezione** ''Azioni'' , posizionando il mouse sul **pulsante** ''Dettaglio'' , viene visualizzato il **dettaglio** dell’**errore** riscontrato in fase di **scaricamento** dall’**MSA**:

{{:utenti:msa:pulsante_dettaglio_msa_2.png|Pulsante Dettaglio MSA}}

Cliccando invece sul **pulsante** ''EML'' viene proposta la possibilità di **aprire** o **salvare** l’**EML originale** della **email **che è stata **processata** e che è andata in **errore** nella fase di **scaricamento**:

{{:utenti:msa:pulsante_eml_msa.png|Pulsante EML}}

Cliccando su ''Rielabora'' invece viene **riavviato** il **processo** di **scaricamento** della **mail** da parte dell’**MSA**: se l’**errore** risulta **risolto**, la **mail** scomparirà dalla **lista** dei **messaggi** e scalerà il **numero** degli **errori** presenti sulla **casella** relativa alla **mail riprocessata**.