Servizio di inserimento assenze via rest

Il sistema ePAS consente a moduli esterni di interrogare la propria base di dati e consente di poter inserire da altri moduli specifiche assenze per specifici utenti.

Come per il caso di inserimento di timbrature via client, anche qui occorre precedentemente creare un utente di tipo restClient su ePAS:

Una volta loggati con account admin, dalla sezione Configurazione, si seleziona Sedi e amministratori e qui, per la sede su cui si ha diritto, si crea un utente nella sezione Account di sistema. Nella form che appare, selezionare il ruolo restClient e specificare username e password per quel ruolo.

Il metodo insertAbsence è un metodo che consente al chiamante di inserire su ePAS un’assenza per una persona in un determinato periodo temporale. La chiamata è del tipo: https://{indirizzo-installazione-epas}/rest/absences/insertAbsence?email={email}&absenceCode={code}&begin={begin}&end={end} Dove {email} è l’indirizzo mail del dipendente di cui si vuole inserire l’assenza nel periodo, {code} è il codice di assenza che si intende inserire, {begin} è la data di inizio del periodo in cui si vuole inserire l’assenza e {end} è la data di fine di tale periodo. Il formato dei campi data begin e end è del tipo: gg/mm/aaaa N.B.: nel caso in cui {begin} e {end} coincidano, la chiamata inserisce l’assenza per il solo giorno specificato. Il sistema ePAS riceve la richiesta e, nel caso la richiesta sia andata a buon fine, risponde con un json contenente un array in cui ogni elemento è caratterizzato da:

• il codice di assenza che si desiderava inserire
• la data in cui si voleva inserire il codice di assenza
• un booleano che specifica se l’inserimento è andato a buon fine o no

Se la richiesta fosse malformata, nel caso ad esempio in cui l’indirizzo mail non fosse scritto correttamente, il sistema epas risponde con un errore http 404. Nel caso in cui siano le date ad essere scritte in modo non corretto, il sistema risponde con un errore http 400