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:

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.

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.

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

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.

L’utente esce dall’applicativo.

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.

L’interfaccia è suddivisa in due parti. Sulla sinistra dello schermo è presente la sezione Posta , sulla destra dello schermo è presente la sezione Messaggi .

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.

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.

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:
• Error : E' rappresentato dal simbolo del triangolo con il punto esclamativo, posizionandosi con il mouse sopra il simbolo viene visualizzata lo stato Error:

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.

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 fine 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.

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.

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:

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:

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:

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.