ePAS - UGov PJ UWeb Timesheet è il servizio che permette di esportare le informazioni presenti in ePAS nelle modalità e formato previsti dal sistema di rendicontazione dei timesheet di Cineca denominato UGov PJ UWeb Timesheet Intime.
In particolare permette di esportare le informazioni sul tempo a lavoro e le assenze del personale presente in ePAS in una finestra di tempo configurabile. Queste informazioni su tempo a lavoro e assenze sono poi utilizzate dall'applicativo Cineca per guidare gli utenti nella compilazione dei timesheet tenendo in considerazione vincoli e suggerimenti che derivano da questi dati.
Il software è distribuito come immagine Docker configurata per accedere a scadenza regolare via REST alle informazioni di ePAS ed inserirle nelle tabelle di frontiera Oracle di UGov Pj UWeb Timesheet Intime.
UGov PJ UWeb Timesheet prevede la possibilità di inserire in una tabella di frontiera Oracle le informazioni relative a tempo a lavoro e assenze che vengono prelevate via REST da un server ePAS.
All'interno di ePAS è necessario create un utente che abbia il ruolo di sistema Consultatore riepiloghi orari e assenze, le credenziali di questo utente devono essere poi specificate nella configurazione di questo servizio (epas.username, epas.password).
UGov Pj Timesheet prevede di raggruppare le assenze in alcune tipologie, per esempio:
- F - FERIE MALATTIE E ROL
- T - Missione / Trasferta
- A - PARTECIPAZIONE ALLE ASSEMBLEE DEL PERSONALE
- R - RIUNIONI RSU
- S - ATTIVITà SVOLTE COME RLS
è necessario definire una correlazione tra questi codici ed i codici si assenza presenti in ePAS, per questo motivo in ePAS è stata aggiunta la possibilità per ogni codice di assenza di specificare un campo External Id, questo campo deve essere valorizzata per i tipi di assenza che si vogliono esportare verso il sistema Cineca con il rispettivo codice Cineca. Per esempio i codici ePAS 32, 31, 94 dovranno aver valorizzato il campo External Id con il valore F.
ePAS UGov Pj Timesheet può essere facilmente installato via docker-compose su server Linux utilizzando il file docker-compose.yml ed il .env presenti in questo repository.
Per l'accesso al database Oracle è necessario richiedere le informazioni di accesso a Cineca. In particolare è necessario avere il TNS Oracle, il nome dello schema SQL, username e password per l'accesso al db. Inoltre Cineca tipicamente fornisce l'accesso al database Oracle solo tramite VPN, di cui eventualmente fare richiesta a Cineca.
Accertati di aver installato docker e docker-compose dove vuoi installare ePAS UGov Pj Timesheet ed in seguito scarica il docker-compose.yml ed il .env di esempio.
curl --remote-name-all https://raw.githubusercontent.com/consiglionazionaledellericerche/epas-ugov-pj-timesheet/main/{compose.yaml,VERSION}
Tipicamente non è necessario modificare il docker-compose.yml, mentre è obbligatorio inserire nel .env i parametri per la connessione al db Oracle e per l'accesso all'API REST di ePAS. Per la configurazione del file .env è possibile seguire i commenti già presenti.
Una volta configurati i parametri del .env è possibile avviare il servizio nella modalità standard docker-compose:
docker-compose up -d
Utilizzando su Ubuntu il client VPN Cisco Anyconnect ci possono essere dei problemi di routing che non permettono al container docker di raggiungere gli host del database Oracle tramite la VPN. Per lo sviluppo di questo servizio è stato utilizzato su Ubuntu il client VPN openconnect.
sudo apt install openconnect network-manager-openconnect network-manager-openconnect-gnome
e configurando la VPN tramite VPN Settings -> Multi-protocol VPN client (open connect).
Questo servizio integra alcuni endpoint REST di amministrazione che permettono di lanciare su richiesta nuove sincronizzazioni dei dati, oltre a vari task di amministrazione. Gli endpoint REST sono protetti tramite Basic Auth, con utente e password configurato tramite le application.properties del servizio, oppure tramite le variabili d'ambiente spring.security.username, spring.security.password nel caso di avvio tramite docker/docker-compose.
È possibile visualizzare le informazioni dei task cron schedulati per la sincronizzazone delle informazioni tra ePAS e le tabelle Oracle di UGOV PJ UWeb Timesheet.
L'endpoint da consultare è /actuator/scheduledtasks.
Il servizio effettua l'aggiornamento dei dati di presenze ed assenze di tutto il personale oggi mattina alle 05:30 AM.
Il servizio espone le informazioni sulle proprie API REST in formato OpenApi all'indirizzo /v3/api-docs. Inoltre è presente un'interfaccia web Swagger UI con la descrizione di tutti i servizi REST e la possibilità di effettuare le chiamate REST, l'interfaccia è raggiungibile all'indirizzo /swagger-ui/index.html.
Il servizio esporta alcune metriche in formato Prometheus, è possibile consultarle all'endpoint /actuator/prometheus.
Le metriche presenti contengono anche le tempistiche di sincronizzazione di tutti i dati e dei singoli uffici, del tipo:
# HELP epas_sync_office_month_seconds Timer della sincronizzazione dei dati di un mese di un ufficio
# TYPE epas_sync_office_month_seconds summary
epas_sync_office_month_seconds_count{officeId="2",yearMonth="2024-01",} 1.0
epas_sync_office_month_seconds_sum{officeId="2",yearMonth="2024-01",} 0.237913661
epas_sync_office_month_seconds_count{officeId="2",yearMonth="2023-12",} 1.0
epas_sync_office_month_seconds_sum{officeId="2",yearMonth="2023-12",} 0.287619208
epas_sync_office_month_seconds_count{officeId="1",yearMonth="2024-02",} 1.0
# HELP epas_sync_all_time_seconds Time taken to sync all the details
# TYPE epas_sync_all_time_seconds summary
epas_sync_all_time_seconds_count{class="it.cnr.iit.epas.timesheet.ugovpj.service.SyncService",exception="none",method="syncAll",} 1.0
epas_sync_all_time_seconds_sum{class="it.cnr.iit.epas.timesheet.ugovpj.service.SyncService",exception="none",method="syncAll",} 6.734464188
E' possibile contribuire a questo progetto utilizzando le modalità standard della comunità opensource (issue + pull request) e siamo grati alla comunità per ogni contribuito a correggere bug e miglioramenti.
ePAS - UGov PJ UWeb Timesheet è concesso in licenza GNU AFFERO GENERAL PUBLIC LICENSE, come si trova nel file LICENSE.