8.6.1. Permessi¶

Per poter accedere a queste interfaccie REST è necessario utilizzare un utente che abbia il ruolo di Lettore Informazioni per la sede su cui si vuole effettuare le operazioni. I nuovi utenti possono essere definiti dagli utenti che hanno il ruolo di amministratore tecnico.

Su https://epas-demo.devel.iit.cnr.it potete per esempio creare un nuovo utente associato alla vostra sede tipo istituto_xxx_person_day_reader (cambiate il nome o in futuro andrà in conflitto con quello di altri istituti) ed una volta creato l'utente assegnateli il ruolo Lettore informazioni.

L'autenticazione da utilizzare è come per gli altri servizi REST quella Basic Auth.

8.6.2. Aspettative per persona e anno (byPersonAndYear)¶

Le informazioni relative alle aspettative di un singolo dipendente in uno spefico anno sono disponibili tramite una HTTP GET all'indirizzo /rest/v2/leaves/byPersonAndYear.

La persona può essere individuata passando i parametri identificativi delle persone: id, email, eppn, perseoPersonId, fiscalCode, number, l'anno tramite il campo year. Negli esempi successivi viene utilizzato il parametro email=galileo.galilei@cnr.it, cambiatelo con un utente appropriato per la vostra sede.

$ http -a istituto_xxx_person_day_reader
    GET https://epas-demo.devel.iit.cnr.it/rest/v2/leaves/byPersonAndYear
    email==galileo.galilei@cnr.it year==2020

Il JSON restituto contiene una lista con le eventuali aspettative del dipendente per l'anno selezionato

[
  {
    "person":
      {
        "id":9999,
        "fullname":"Galileo Galilei",
        "fiscalCode":null,
        "email":"galileo.galilei@cnr.it",
        "number":"9802",
        "eppn":"galileo.galilei@cnr.it",
      },
    "code":"54A17",
    "start":"2020-01-01",
    "end":"2020-06-02"}
]

Per avere anche la lista delle assenze associate al periodo di aspettativa utilizzare nella chiamata REST il parametro includeDetails=true, nel JSON di risposta sarà popolato per ogni periodo di aspettativa il campo absences con la lista delle assenze nel periodo.

8.6.3. Aspettative per ufficio e anno (byOfficeAndYear)¶

Analogamente ai metodi precedenti è possibile avere le informazioni annuali di tutte le aspettative dei dipendenti di una sede tramite una HTTP GET all'indirizzo /rest/v2/leaves/byOfficeAndYear.

La sede è individuata tramite il parametro codeId, per esempio per l'IIT corrisponde a 223400. Negli esempio successivi sostituite 223400 con il codeId della vostra sede.

$ http -a istituto_xxx_person_day_reader
    GET https://epas-demo.devel.iit.cnr.it/rest/v2/leaves/byOfficeAndYear
    codeId==223400 year==2020

Il JSON restituto contiene una lista con le eventuali aspettative di tutti i dipendenti della sede per l'anno selezionato.

[
  {
    "person":
      {
        "id" : 1234,
        "fullname" : "Galileo Galilei",
        "fiscalCode" : "GLLGLL74P10G702B",
        "email" : "galileo.galilei@cnr.it"
        "number" : "9802",
        "eppn" : "galileo.galilei@cnr.it"
      },
    "code":"54A17",
    "start":"2020-01-01",
    "end":"2020-06-02"
  },
  {
    "person":
      {
        "id" : 1235,
        "fullname" : "Leonardo Fibonacci",
        "fiscalCode" : "FBNLRD74P10G702G",
        "email" : "leonardo.fibonacci@cnr.it",
        "number":"9801",
        "eppn":"leonardo.fibonacci@cnr.it",
      },
    "code":"54A17",
    "start":"2020-03-06",
    "end":"2020-09-23"
  }
]

Anche in questo caso per avere anche la lista delle assenze associate al periodo di aspettativa utilizzare nella chiamata REST il parametro includeDetails=true, nel JSON di risposta sarà popolato per ogni periodo di aspettativa il campo absences con la lista delle assenze nel periodo.