Servizio di visualizzazione situazione giornaliera via rest

Il sistema ePAS dà la possibilità a sistemi esterni di collegarsi ad esso e di interrogarlo per conoscere la situazione giornaliera di un dipendente.

In particolare, il metodo getDaySituation è interrogabile all’indirizzo: http://{indirizzo-installazione-epas}/rest/persondays/getdaysituation?email={email}&date={data}

Questo metodo rest permette di visualizzare la situazione giornaliera di un dipendente passando come parametri l’indirizzo mail del dipendente e la data di cui si vuole conoscere la situazione. Il formato del campo date: gg/mm/aaaa In particolare, se l’indirizzo mail non fosse corretto o non corrispondesse ad alcun dipendente verrebbe ritornato un messaggio di errore. Il messaggio json che il metodo ritorna è del tipo:

{“tempolavoro”:minuti di lavoro,

“differenza”: differenza in minuti con il tempo di lavoro, “progressivo”:somma,algiorno,delle differenze giornaliere, “buonopasto”: true se si è raggiunto il tempo per usufruire del buono pasto, false altrimenti, “timbrature”:la lista delle eventuali timbrature, “codiceassenza”:la lista delle eventuali assenze}

Questo metodo, inoltre, è chiamabile da un dipendente per se stesso. Ovvero se un dipendente richiede informazioni passando come parametro una mail che non è la propria, il sistema impedirà la visualizzazione delle informazioni. A parziale deroga di questo, è possibile per gli amministratori e per gli amministratori in sola lettura visualizzare le situazioni giornaliere dei dipendenti su cui questi hanno diritto di visualizzazione e modifica. La condizione necessaria perchè ciò avvenga è che il dipendente che ha fatto richiesta delle informazioni giornaliere di un altro dipendente abbia anche un ruolo amministrativo. Per verificare i ruoli amministrativi fare riferimento alla Documentazione di amministrazione nella sezione “Gestione sedi e amministratori”.

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 sia la data ad essere scritta in modo non corretto, il sistema risponde con un errore http 400