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