Servizio di controllo assenze via rest

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.

Questo modulo rest consente a programmi esterni di verificare la fattibilità dell’inserimento di un codice di assenza per uno o più giorni SENZA PERO’ SALVARLA SUL DATABASE

Questa funzionalità è utile nel caso in cui si abbiano più giorni in cui inserire un codice di assenza soggetto a limitazioni (es.: ferie anno corrente, ferie anno passato, permessi legge, riposi compensativi...) e si voglia verificare che per tutti i giorni richiesti quel codice risulti utilizzabile. La chiamata è del tipo: https://{indirizzo-installazione-epas}/rest/absences/checkAbsence?email={email}&abscenceCode={absenceCode}&begin={begin}&end={end} Dove {email} è l’indirizzo mail del dipendente di cui si vogliono conoscere le assenze nel periodo, {absenceCode} è il codice d’assenza che si intende verificare, {begin} è la data di inizio del periodo di cui si vogliono conoscere le assenze, e {end} è la data di fine di tale periodo. Il formato dei campi data begin e end è del tipo: gg/mm/aaaa 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:

• la data dell’assenza
• il codice dell’assenza
• se c’è un warning nell’inserimento
• se l’inserimento è andato a buon fine
• se il giorno richiesto per l’inserimento è un festivo
• se quel giorno il dipendente era in turno o reperibilità

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