Servizio di visualizzazione situazione mensile via rest

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

In particolare, il metodo getMonthSituation è interrogabile all’indirizzo: http://{indirizzo-installazione-epas}/rest/persondays/getmonthsituation?email={email}&month={mese}&year={anno}

Questo metodo rest permette di visualizzare la situazione giornaliera di un dipendente passando come parametri l’indirizzo mail del dipendente, il mese e l’anno 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. 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. Il messaggio json di risposta di epas sarà del tipo:

{“progressivoFinaleMese”:il progressivo all’ultimo giorno del mese in minuti, “possibileUtilizzareResiduoAnnoPrecedente”:true se possibile usufruire del residuo dell’anno passato, false altrimenti, “residuoTotaleAnnoCorrente”:residuo totale dell’anno in corso in minuti, “residuoTotaleAnnoPassato”:residuo totale dell’anno passato in minuti, “straordinari”:ore di straordinario assegnate nel mese, “buoniMensa”:quanti buoni mensa sono stati assegnati nel mese}

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 siano le date ad essere scritte in modo non corretto, il sistema risponde con un errore http 400