italia / api-padigitale2026-misura1.3.1-uni-afam

Specifiche API relative alla misura 1.3.1 per l'avviso dedicato alle Università e AFAM
Creative Commons Zero v1.0 Universal
7 stars 4 forks source link

Dubbi contenuto IFS02.1 e IFS02.2 #201

Closed silviaavella closed 1 month ago

silviaavella commented 2 months ago

Buongiorno, abbiamo dei dubbi sui due endpoint in oggetto.

IFS02.1 Acquisizione del dettaglio delle ultime iscrizioni per corso di studi negli ultimi tre anni accademici di una studentessa o di uno studente

IFS02.2 Acquisizione delle prove riguardanti l'ultima iscrizione a ogni corso di studi di istruzione terziaria di una studentessa/studente negli ultimi 3 anni accademici

In entrambi i casi si parla di iscrizioni ma dalla response sembrebbe invece si debbano inviare i dati della carriera. Per uno studente con le seguenti iscrizioni. 2021/2022 iscrizione al terzo anno triennale corso A 2022/2023 iscrizione al primo anno magistrale corso B 2023/2024 iscrizione al secondo anno magistrale Corso B

cosa dovremmo inviare?In particolare, cosa si intende per prove? L'esempio purtroppo non è molto esplicativo.

Vi ringrazio in anticipo, saluti Silvia

denismarini commented 2 months ago

Buongiorno @silviaavella,

Partendo dal suo esempio dovreste restituire i seguenti item, ossia le ultime iscrizioni per corso e non la cariera per IFS02.1 e IFS02.2: 2021/2022 iscrizione al terzo anno triennale corso A 2023/2024 iscrizione al secondo anno magistrale Corso B

Il termine "prova" è una terminologia derivata dalle specifiche SDG europee e in questo caso si intende "la prova che uno studente sia iscritto o sia stato iscritto" ed è sufficente l'utima iscrizione per ogni corso negli ultimi 3 anni accademici, quindi se l'invocazione dell'API fosse oggi gli anni accademici utili sono 2023/2024 2022/2023 2021/2022

Mille grazie

silviaavella commented 2 months ago

Grazie mille, quindi concettualmente i due endpoint devono restituire le stesse iscrizioni, gli stessi record.

Grazie in anticipo

denismarini commented 2 months ago

Esatto concettualmente restituiscono le stesse informazioni ma sono dedicati al momento a fruitori diversi, la 2.1 ad ANIS la 2.2 a SDG e la 2.1 non ha la data di iscrizione come da decreto ANIS

silviaavella commented 2 months ago

Grazie mille per il chiarimento, ne approfitto per chiedere un chiarimento sull'attributo status dell'IFS02.1 per il quale sono previsti tre valori:

A quali stati corrispondono?Nell'esempio precedente, supponiamo che nel 2021/2022 lo studente si sia laureato al corso A, dobbiamo restituire 'inactive'?

Ho provato a cercare in rete ma non ho trovato molte indicazioni, vi ringrazio in anticipo

denismarini commented 2 months ago

Buon pomeriggio @silviaavella,

Questo stato è utilizzato dal fruitore per compiere azioni sul proprio sistema. L'API IFS02.1 è stata concepita principalmente per alimentare ANIS ma può essere utilizzata anche da altri enti della Pubblica Amministrazione (PA). Considerato che attraverso ANIS, lo studente può visualizzare e generare le attestazioni delle sue iscrizioni, ANIS utilizza l'attributo "status" per i seguenti scenari

Pertanto, l'istituto definisce lo stato di un'iscrizione in base a questi criteri. Ad esempio, alcuni istituti potrebbero considerare attive le iscrizioni per le quali è già stato effettuato il pagamento della retta, mentre altri no.

È importante notare che le iscrizioni potenzialmente attive sono "le ultime per ogni corso negli ultimi 3 anni accademici". Di conseguenza, se uno studente non si iscrive dopo 3 anni, le sue iscrizioni non devono essere inviate ad ANIS, oppure devono essere inviate come inattive.

Riguardo al suo esempio uno studente che si è laureato nel 2021/2022 potrebbe avere un'iscrizione "inactive" e il relativo titolo di laurea, ma comunque dipende dall'istituto come vuole che lo studente possa visualizzare e generare le proprie attestazioni su ANIS.

Spero di averla aiutata e buon lavoro,