Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. payload complessi per i quali si rimanda alla documentazione di modello (cliccare su ogni elemento del seguente elenco):
    1. Progetti
    2. Bandi di finanziamento
    3. Contratti
    4. Grandi Attrezzature
    5. Mobilità in ingresso
    6. Laboratori
    7. Terza Missione (public engagements)
    8. Gruppi di ricerca

  2. payload complessi non ricostruibili da documentazione di modello:
    1. Persone
    2. Premi
    3. Biblioteche
    4. Riviste
    5. Pubblicazioni

  3. payload semplici (assimilabili a dizionari) NON ricostruibili da documentazione di modello:
    1. SSD
    2. Macrosettori concorsuali
    3. Settori concorsuali
    4. Dipartimenti
    5. Organizzazioni esterne
    6. Facoltà
    7. Ruoli delle persone
    8. Profili delle persone

Progetti

METODO GET:

 /gw/rest/api/projects


Tutti i parametri segnati con asterisco "*" possono essere usati come identificatori per ottenere una singola risorsa.

Nella versione FULL, invece, sono utilizzabili solo i paramentri contrassegnati da asterisco. Gli altri vengono ignorati.

Tutti i parametri in parentesi quadre [...] accettano valori multipli. Ad esempio: 

https://<iris-host>/gw/rest/api/projects?type=2018&year=2019 

Campi disponibili per l'ordinamento: id, pid, name, year, startDate, lastModified.

Parametri della Query di richiesta:

parametrovaloredescrizione

*id

string

Stringa con l'identificativo ID dell'item

*pid

string

Stringa con l'identificatore persistente

[macrotype]

string

Stringa contenente il macro tipo dell'elemento. Per conoscere tutti i possibili valori, contattare l'helpdesk del gruppo di supporto IRIS

[type]

string

Stringa contenente il tipo dell'elemento. Per conoscere tutti i possibili valori, contattare l'helpdesk del gruppo di supporto IRIS

validation.relation

string

Valori permessi: master|mostValidated|all. Se non c'è, allora il valore default è mostValidated

visibleOnPortal

boolean

Questo parametro permette il filtraggio degli item basati sull'autorizzazione data dal creatore dell'elemento stesso.

I valori possibili sono TRUE e FALSE.

Se il valore di questo parametro non viene fornito, allora vengono restituiti tutti gli item.

[year]

number

Anno di creazione dell'item

[wfState]

string

Stringa contenente wfState (stato del workflow) dell'item.

name

string

Stringa contenente la descrizione dell'item. È possibile cercare col carattere "*".

person.id

string

Stringa contenente l'id IRIS della Persona

person.idAb

string

Stringa contenente l'idAb della Persona

person.cf

string

Stringa contenente il Codice Fiscale della Persona

person.sourceId

string

Stringa contenente l'identificativo sorgente della Persona, per coloro che non fanno uso di U-gov

person.pid

string

Stringa contenente il Person PID di IRIS modulo IR.

person.orcid

string

Stringa contenente il Person ORCID.

person.relation

owner|contributor

Questo campo permette di specificare la relazione della persona con l'elemento. I valori possibili sono solo owner o contributor.

Questo campo deve essere usato in associazione con un altro filtro persona come ad esempio person.cf.

Se non viene definito, si prende qualsiasi tipo di associazione.

department.id

string

Stringa contenente l'id del parametro

department.idAb

string

Stringa contenente l'idAb U-gov del dipartimento.

department.sourceId

string

Stringa contenente il sourceId di dipartimento (per enti che non usano U-GOV).

department.relation

owner|contributor

Questo parametro specifica il ruolo nel dipartimento: main(owner) oppure secondary (contributor)

I valori possibili sono solo owner o contributor.

Il campo va usato in associazioni con altri filtri di dipartimento come department.idAb.

Se viene specificato, allora vengono restituiti solo gli item che corrispondono allo specifico dipartimento e al ruolo indicato.

Se invece il parametro non è indicato, allora vengono restituiti tutti gli item che corrispondono al dipartimento specificato.

department.match

byPerson|byDepartment

Questo parametro permette di specificare la modalità di selezione del dipartimento: per persona oppure per dipartimento.

Infatti i valori possibili sono byPerson oppure byDepartment.

Il campo va usato in associazione con altri filtri di dipartimento come il department.idAb.

Se non viene fornito, allora si usano entrambi i tipi di associazione, altrimenti solo quella specificata.

L'associazione "byPerson" prende il dipartimento ATTUALE della persona (owner o contributor). L'associazione "byDepartment" risale al dipartimento che era valido nel momento della CREAZIONE dell'item.

ESEMPI:

Per recuperare tutti gli elementi:


					https://<iris-host>/gw/rest/api/projects
					

Per cercare la persona di codice fiscale=123456:

					https://<iris-host>/gw/rest/api/projects?person.cf=UYGUSGAUYGUGY					
					

Per cercare la persona che è "owner" del progetto e ha codice fiscale UYGUSGAUYGUGY:

					https://<iris-host>/gw/rest/api/projects?person.relation=onwer&person.cf=UYGUSGAUYGUGY					
					

Per cercare tutte le persone con idAb pari a 123456:

					https://<iris-host>/gw/rest/api/projects?person.idAb=123456&
					

Per cercare tutti i dipartimenti con idAb pari a 123456:

					https://<iris-host>/gw/rest/api/projects?department.idAb=123456
					

Per cercare un progetto il cui "owner" ha un id di dipartimento pari a 4400, corrente(per persona) o passato (per dipartimento):

					https://<iris-host>/gw/rest/api/projects?department.relation=owner&department.match=byPerson&department.id=4400
					

Terza missione (publicEngagement - PEN)

METODO GET METODO GET:

/gw/rest/api/public-engagements

Tutti i parametri segnati con asterisco "*" possono essere usati come identificatori per ottenere una singola risorsa (single resource)

...

Campi per l'ordinamento: bi_sort_2_sort

Parametri di Request:

parametrovaloredescrizione

authority.people_authority

string

Recupera le pubblicazioni dell'autore identificato dall'RPID

param.item.selected

string

Recupera le pubblicazioni scelte come pubblicazioni "TOP" dall'autore identificato dall'RPID

handle

string

Recupera le pubblicazioni dato uno specifico handle

ESEMPI:

Per tutte le pubblicazioni:

...