Wiki

Questa pagina è in sola lettura. Puoi visualizzare il sorgente, ma non puoi modificarlo. Contatta l'amministratore se pensi che ci sia un errore.
====== Notifiche Email Assensi e Consensi ======

Nome un po' infelice, ma ormai... 

===== Panoramica =====

Lo scopo dell'app è quello di consentire di inviare solleciti ad una selezione arbitraria di dipendenti che siano associati ad uno specifico assenso e consenso configurato nel portale zucchetti.

===== Requisiti Lato Server =====

L'accesso all'applicazione è realizzabile esclusivamente tramite SSO da ''Link Prodotti'' del portale zucchetti. Non è previsto login tramite username e password direttamente sull'app.

Quindi deve essere configurato il sistema di portal call specifico dell'SSO e configurata opportunamente la sezione Link prodotti, con eventuale gruppo di sicurezza da assegnare solo a chi deve accedere all'applicazione.

L'app necessita di un proprio DB. Sono supportati MS SQL Server e PostgreSQL.

Per l'invio mail è necessario avere accesso ad un server di posta SMTP.

Sul portale zucchetti devono essere predisposti due web services per poter recuperare la lista degli assensi e consensi e la lista dei dipendenti relativi ad uno specifico assenso e consenso. Le specifiche di questi web services non sono contemplate in questo documento.

===== Requisiti Lato Client =====

Per il corretto caricamento dell'app è necessario un browser basato su Chromium (Chrome o Edge, al momento del rilascio almeno versione 113), ma è importante che il browser sia aggiornato all'ultima versione disponibile.

L'app non è stata testata su altri browser, anche se è probabile che funzioni correttamente su Firefox. Non è testata affatto su Safari. Per entrambi questi ultimi due browser non è garantito il corretto funzionamento.

La risoluzione dello schermo minima per la corretta fruizione dell'app è ''1366 x 768''.

L'interfaccia grafica non è stata sviluppata tenendo in considerazione dispositivi mobile come tablet o smartphone. Quindi anche in questo caso non è garantito il corretto funzionamento su dispositivi di questo tipo.

===== Funzionalità =====

==== Schermata home ====

Dopo il login si giunge alla home che di base mostra solo il menu di scelta degli assensi e consensi.

{{:documentazione:utility:2023-05-24_12_43_29-notifiche_email_assensi_e_consensi_-_home.png?nolink|}}

-----
==== Selezione Assenso e Consenso ====

Va selezionato uno degli assensi e consensi dal menu a tendina per poter caricare l'elenco dei dipendenti associati.

Sono presenti solo gli assensi e consensi attivi alla data corrente.

{{:documentazione:utility:2023-05-24_12_45_38-notifichemailassensieconsensi_-_select_assenso.png?nolink|}}

-----
==== Elenco Dipendenti ====

Il titolo dell'assenso e consenso selezionato viene mostrato nel menu di selezione stesso (1). 

Nella barra del titolo in alto a destra è collocato il pulsante per fare logout (2).

A fianco del menu di selezione assensi/consensi in ordine sono collocati i pulsanti per:
  * ricaricare i dati (3), recuperandoli aggiornati dal web service. Disabilitato quando non è selezionato un assenso/consenso.
  * comporre un nuovo sollecito. Disabilitato finchè non è selezionato almeno un dipendente.

L'elenco dipendenti include solo quelli non cessati alla data corrente, che abbiano un'utenza attiva sul portale e che siano associati all'assenso e consenso selezionato.

{{:documentazione:utility:2023-05-24_12_46_57-notifichemailassensieconsensi_-_elenco_dipendenti.png?nolink|}}

-----
==== Tipo dati esposti in tabella ====

Le colonne in tabella sono:

  * ''Codice Azienda*''
  * ''Codice Matricola Dipendente*''
  * ''Cognome Dipendente*''
  * ''Nome Dipendente*''
  * ''Letto'': indica se il dipendente ha preso visione dell'assenso/consenso e può contenere valori ''Sì''/''No''.
  * ''Prima Lettura'': indica l'eventuale data in cui il dipendente ha preso visione dell'assenso/consenso.
  * ''Ha Risposto'': indica se il dipendente ha fornito risposta all'assenso/consenso e può contenere valori ''Sì''/''No''.
  * ''Data Risposta'': indica l'eventuale data in cui il dipendente ha risposto all'assenso/consenso.
  * ''Numero Notifiche Inviate con Successo'': tiene traccia di quante notifiche sono state inviate al dipendente.
  * ''Errori invio ultima notifica'': indica se __l'ultimo__ tentativo di invio non è fallito.
  * ''Ultima Notifica'': indica la data in cui è stata inviata __l'ultima__ notifica inviata con successo. Non si riferisce mai ad eventuali tentativi di invio andati in errore.
  * ''Email*'': contiene l'indirizzo email del dipendente.

NB: ''*'' le colonne con asterisco sono le uniche per cui è disponibile l'ordinamento.

=== Colonna Email ===

L'indirizzo email è quello indicato con flag ''Principale'' nella sezione ''Recapiti'', modulo ''Contatti Persona'' del portale 
Zucchetti.

{{:documentazione:utility:contatti_persona.png?nolink|}}

=== Colonna Numero Notifiche Inviate con Successo ===

Questa colonna non ha una intestazione testuale, ma è rappresentata con l'icona indicata in figura. Posizionando il mouse sull'icona viene ricordato il significato della colonna stessa.

Questo conteggio non include mai i tentativi di invio non andati a buon fine.

{{:documentazione:utility:2023-05-24_17_06_10-notifichemailassensieconsensi_-_tooltip_num_notifiche_con_successo.png?nolink|}}

=== Colonna Errori invio ultima notifica ===

Questa colonna non ha una intestazione testuale, ma è rappresentata con l'icona indicata in figura. Posizionando il mouse sull'icona viene ricordato il significato della colonna stessa.

In caso __l'ultimo__ invio sia andato a buon fine questa colonna sarà vuota.

{{:documentazione:utility:2023-05-24_17_06_02-notifichemailassensieconsensi_-_tooltip_errore_ultima_notifica.png?nolink|}}

== Dettaglio errore ==

Posizionandosi sul simbolo del triangolo in una delle righe in cui sia eventualmente presente un errore, si può leggere la causa dell'errore di invio per quel particolare dipendente. 

L'errore può dipendente da indirizzo email non valido (per esempio manca il simbolo ''@''), oppure l'indirizzo email è vuoto, oppure da un temporaneo problema del server di invio, eccetera.

{{:documentazione:utility:2023-05-24_17_06_21-notifichemailassensieconsensi_-_tooltip_dettaglio_errore_tentativo_invio.png?nolink|}}

-----
==== Filtri e Selezione ====

Il pulsante di composizione Nuova Notifica (5) si abilita non appena si spunta la selezione di almeno una o più righe (1). 

Nel footer della pagina è presente il conteggio di tutti i dipendenti trovati che sono associati all'assenso/consenso selezionato (3), a seguire il numero delle righe selezionate (2) e, solo quando viene applicato un filtro, il numero delle righe rimanenti (4) dall'applicazione del filtro.

A destra dell'intestazione di ogni colonna è presente l'icona (6) per aprire la gestione del relativo filtro. L'icona rimane evidenziata (7) quando è attivo il filtro sulla relativa colonna.

{{:documentazione:utility:2023-05-24_14_02_07-notifichemailassensieconsensi_-_selezione_e_filtri.png?nolink|}}

=== Tipologia Filtri ===

Il menu a tendina che si apre facendo click sull'icona del filtro è composto di un campo dove inserire il termine di ricerca (2), un pulsante per applicare il filtro (4), un pulsante per rimuovere il filtro applicato (3) e un criterio di confronto che determina il comportamento del filtro (1).

{{:documentazione:utility:2023-05-24_15_41_41-notifichemailassensieconsensi_-_filtro_campo_testo.png?nolink|}}

Per i campi di tipo ''testo'' come ad esempio il cognome, abbiamo i seguenti criteri di confronto:

{{:documentazione:utility:2023-05-24_15_47_22-notifichemailassensieconsensi_-_campi_stringa.png?nolink|}}

Per i campi di tipo ''data'', come per esempio la data di prima lettura, i criteri sono i seguenti:

{{:documentazione:utility:2023-05-24_15_51_48-notifichemailassensieconsensi_-_campi_data.png?nolink|}}

Per i campi di tipo ''numerico'', come per esempio il conteggio di quante notifiche sono state inviate con successo, i criteri sono i seguenti:

{{:documentazione:utility:2023-05-24_15_48_21-notifichemailassensieconsensi_-_campi_numerici.png?nolink|}}

La colonna ''Email'', che è di tipo testo, è l'unica ad includere anche il criterio ''Vuoto'':

{{:documentazione:utility:2023-05-24_16_05_46-notifichemailassensieconsensi_-_campo_email_vuoto.png?nolink|}}

L'ultimo tipo di filtro è quello con casella di spunta usato nelle colonne con valore ''si/no'' e nella colonna ''errore presente'', sottinteso, ''si/no''

Quando nella casella non è presente nessun simbolo di spunta, significa che il filtro non è applicato e nessun valore di quella colonna è escluso.

{{:documentazione:utility:2023-05-24_17_07_56-notifichemailassensieconsensi_-_filtro_errori_empty.png?nolink|}}

Quando c'è un segno di spunta ''Sì'' ( {{:documentazione:utility:2023-05-25_09_40_21-notifichemailassensieconsensi_-_spunta_si.png?nolink&20|}} ) vengono mostrate solo le righe per cui, per esempio, sia presente un errore di invio, oppure il dipendente ha risposto, oppure ha preso visione.


{{:documentazione:utility:2023-05-24_17_09_03-notifichemailassensieconsensi_-_filtro_errori_si.png?nolink|}}

Quando c'è un segno di spunta ''No'' ( {{:documentazione:utility:2023-05-25_09_40_46-notifichemailassensieconsensi_-_spunta_no.png?nolink&20|}} ) vengono mostrate solo le righe per cui, per esempio, **non** sia presente un errore di invio, oppure il dipendente **non** ha risposto, oppure **non** ha preso visione.

{{:documentazione:utility:2023-05-24_17_09_16-notifichemailassensieconsensi_-_filtro_errori_no.png?nolink|}}

-----
==== Selezione Massiva ====

La casella di spunta della riga di intestazione (1) consente di fare la ''selezione massiva'' di tutti gli elementi della tabella. Quando sono attivi dei filtri, la ''selezione massiva'' ha effetto solo sugli elementi risultanti dai filtri (2). Nell'esempio in figura, filtrando per quei 140 dipendenti che non hanno nè risposto e nemmeno letto l'assenso/consenso, mettendo la spunta sulla ''selezione massiva'' verranno selezionato tutti e soli quei 140 dipendenti.

{{:documentazione:utility:2023-05-24_14_23_28-notifichemailassensieconsensi_-_seleziona_visibili.png?nolink|}}

=== Selezione Massiva - Sottrazione ===

Supponendo di scremare ulteriormente la tabella applicando un filtro sui cognomi che iniziano per ''ma'' (1), abbiamo che rimangono visibili 3 dipendenti (2).

{{:documentazione:utility:2023-05-24_14_33_16-notifichemailassensieconsensi_-_selezione_filtrati_1.png?nolink|}}

Ora togliendo la spunta dalla casella di selezione massiva (3), verranno deselezionati solo i 3 dipendenti visibili risultanti dai filtri (2) e in accordo verrà aggiornato il numero dei dipendenti selezionati (1).

{{:documentazione:utility:2023-05-24_14_33_16-notifichemailassensieconsensi_-_selezione_filtrati_2.png?nolink|}}

=== Selezione Massiva - Aggiunta ===

Similmente, la selezione massiva consente di aggiungere alla selezione corrente, in più passaggi, sottoinsiemi di dipendenti ottenuti applicando i filtri. 

Per esempio, dapprima potrei filtrare per tutti i dipendenti a cui non ho mai inviato un sollecito e spuntare la selezione massiva. Poi posso tornare alla visualizzazione completa e applicare un altro filtro, per esempio tutti i dipendenti a cui l'ultimo sollecito è stato inviato più di una settimana fa e di nuovo spuntare la selezione massiva. In questo modo la selezione finale includerà sia i dipendenti a cui non è mai stato inviato un sollecito sia quelli a cui l'ultimo sollecito è stato inviato oltre una settimana fa.

-----
==== Ordinamento ====

Premendo il pulsante di ordinamento (1) una volta, i dati della relativa colonna vengono ordinati in maniera crescente, premendolo una seconda volta l'ordinamento diventa decrescente.

{{:documentazione:utility:2023-05-24_15_33_24-notifichemailassensieconsensi_-_ordinamento.jpg?nolink|}}

-----
==== Invio Notifica ====

Dopo aver selezionato (1) almeno un dipendente premere il pulsante ''Nuova Notifica'' (2).

{{:documentazione:utility:2023-05-24_15_32_27-notifichemailassensieconsensi_-_selezione_e_notifica.png?nolink|}}

A questo punto si apre una finestra dove comporre il messaggio di sollecito, specificando l'oggetto dell'email (1) e il testo del messaggio (2).

Se si preme annulla (4) per tornare alla tabella dipendenti, si perde il messaggio finora scritto. Una volta terminato di scrivere il messaggio procedi premendo il pulsante Invia Notifica (5).

Di default è spuntata la casella (3) che abilita la funzione per memorizzare i messaggi inviati come modello da riutilizzare per notifiche future. Uno stesso messaggio, con identico oggetto e testo, verrà salvato una sola volta anche se rimane spuntata la casella che abilita questa funzione.

{{:documentazione:utility:2023-05-24_16_12_32-notifichemailassensieconsensi_-_modale_notifica.png?nolink|}}

Una volta premuto il pulsante di invio viene chiesta un'ultima conferma prima di procedere all'effettivo invio.

{{:documentazione:utility:2023-05-24_16_50_23-notifichemailassensieconsensi_-_conferma_invio.png?nolink|}}

Nel menu a tendina in basso è consultabile la lista dei messaggi inviati in precedenza e salvati come modelli da poter riutilizzare per future notifiche. L'oggetto e la data di invio costituiscono il titolo delle voci di questo menu.

{{:documentazione:utility:2023-05-24_16_23_56-notifichemailassensieconsensi_-_elenco_template_notifiche.png?nolink|}}

Posizionando il mouse sull'icona ''occhio'' su una delle voci del menu con i modelli è possibile vedere un'anteprima con le prime righe del messaggio.

{{:documentazione:utility:2023-05-24_16_30_03-notifichemailassensieconsensi_-_anteprima_messaggio.png?nolink|}}

Una volta selezionato il modello desiderato (1), premendo il pulsante ''Incolla'' (2) si va a rimpiazzare completamente il contenuto dei campi ''Oggetto'' e ''Messaggio'', quindi si perde qualsiasi cosa fosse stata scritta.

{{:documentazione:utility:2023-05-24_16_39_32-notifichemailassensieconsensi_-_incolla_modello.png?nolink|}}

Di default, dopo che è stato salvato almeno un modello, quando si apre la maschera di composizione di una nuova notifica, viene sempre caricato il modello dell'ultimo messaggio inviato.

=== Esito invio ===


Al termine della fase di invio delle email viene mostrata una notifica con l'esito

{{:documentazione:utility:2023-05-24_17_01_01-notifichemailassensieconsensi_-_invii_con_successo.png?nolink|}}

In caso di almeno un invio fallito il messaggio indica il numero di invii falliti 

{{:documentazione:utility:2023-05-24_17_00_24-notifichemailassensieconsensi_-_invii_falliti.png?nolink|}}

===== Esportazione Excel =====

Tramite pulsante ''Esporta Excel'' è possibile scaricare un file Excel con il contenuto della tabella filtrato e ordinato secondo i criteri scelti.

{{:documentazione:utility:2023-06-22_11_21_49-notifichemailassensieconsensi_-_esporta_excel.png?nolink|}}
===== Altro =====

==== Sessione scaduta ====

In caso di prolungata inattività, utilizzando alcune funzionalità dell'app, come l'aggiornamento dei dati, l'invio notifica, la selezione di un assenso/consenso, verrà mostrato un messaggio per indicare che la sessione è scaduta.

{{:documentazione:utility:2023-05-24_12_46_04-notifichemailassensieconsensi_-_sessione_scaduta.png?nolink|}}

==== Autenticazione fallita ====

Qualora non fosse ben configurato il SSO Zucchetti o qualora ci sia un problema tecnico temporaneo sul server, tentando di accedere dal Link Prodotti, verrebbe mostrato questo messaggio di errore, indicante che il login all'applicazione è fallito.

{{:documentazione:utility:2023-05-25_10_04_58-notifichemailassensieconsensi_-_autenticazione_fallita.png?nolink|}}

==== Pagina non trovata ====

Questa pagina di errore verrà mostrata in caso si cercasse di accedere ad una pagina dell'app tramite un indirizzo errato o inesistente (magari perchè cambiato nel tempo rispetto ad un preferito salvato nel browser).

{{:documentazione:utility:2023-05-25_10_08_00-notifichemailassensieconsensi_-_404.png?nolink|}}
Wiki

Strumenti Utente

Strumenti Sito

Strumenti Pagina
