Vi è un sistema di scambio tramite web service delle schede Anagrafe dell’Ateneo e la possibilità di ricevere automaticamente l’acquisizione del file degli errori e di coerenza. Il medesimo servizio, aperto a tutti, è il canale di comunicazione per ricevere dati sui titoli di scuola superiore (ANS ISTRUZIONE) e universitari (ANS UNIVERSITÀ).

Gli Atenei che usano i WS hanno il parametro di configurazione 'ANS_WEBSERVICE' a 1 e valore alfanumerico a 'DEF'.

Se l'Ateneo usufruisce dei 3 servizi dovrà settare in ESSE3 le credenziali di accesso al sito dell’Osservatorio Studenti nella nuova modalità attiva da giugno 2023.

Soltanto nel caso in cui l’Ateneo abbia il servizio ANS_WEBSERVICE attivato, da GENERAZIONE SPEDIZIONI ANS sarà sempre attiva una spunta “invia File ad OSD”.

Sempre in questa casistica, il servizio di ricezione del file degli errori (che comunque è automatico) è contemplato manualmente dalla maschera RIEPILOGO SPEDIZIONI. 

Servizi ANS Università e ANS Istruzione

Se la versione di Esse3 è 23.06.03.00 o successiva si può applicare la configurazione più recente che sfrutta l'utilizzo dei nuovi servizi REST.

I batch WS_ANS_DIPL e WS_ANS_UNIV, che rispettivamente controllano la validità dei Diplomi e dei Titoli di Studio, sono stati scollegati dai SOAP. Dalla versione 23.12.01.00 contatteranno il servizio REST ANSGW che a sua volta contatterà OSD.

Per visualizzare la configurazione accedere alla maschera "Contesti", selezionare il contesto ANSWSDIPLUNIV (nel file esse3.ini  il parametro ABILITA_CONFIGURAZIONE deve valere 1 affinchè vediate a Menù questa maschera).

I parametri significativi per questo contesto, necessari per stabilire la connessione sicura e criptata, sono i seguenti:

Tutti i parametri di contesto presenti sono necessari per stabilire la connessione sicura e criptata e NON devono essere modificati. 

N.B. Gli unici due parametri che potranno essere modificati sono:

• WS_PASSWORD nel caso che l'utente cambi la password di accesso a OSD (https://osservatorio.cineca.it/)
• WS_USER nel caso che l'Ateneo cambi il referente ANS di accesso a OSD (https://osservatorio.cineca.it/)

Dalla versione 23.10.01 di Esse3 abbiamo provveduto, infatti, a rendere non modificabili/protetti, i seguenti parametri:
WS_TENANT e WS_PROVIDER_URL.

Il pulsante "Verifica Connessione" non è applicabile alla verifica dei nuovi servizi REST. Eventuali errori nella configurazione dei Contesti sono esplicitati all'utente dal batch che va in FAILED, poi nel log Esse3 e nelle note del codice fiscale su cui si è effettuata la chiamata all'interno delle funzioni Ans istruzione/Ans università).

Gestione ERRORI ANS ISTRUZIONE

Gestione ERRORI ANS UNIVERSITA'

Servizi ANS Invio Spedizioni

E' stato adeguato Esse3 per gestire le chiamate al nuovo WS REST  Invio Spedizioni. Per l'interfaccia di documentazione delle API del mondo ANS si faccia riferimento allo swagger delle chiamate che trovate su https://wsans.cineca.it 

Se la versione di Esse3 è maggiore o uguale alle 23.08.02.00 si utilizzerà la configurazione che sfrutta l'utilizzo dei nuovi servizi REST. 

Per visualizzare la configurazione accedere alla maschera "Contesti", selezionare il contesto ANSWSFILESPEDNEW  (nel file esse3.ini  il parametro ABILITA_CONFIGURAZIONE deve valere 1 affinchè vediate a Menù questa maschera).

I parametri significativi per questo contesto, necessari per stabilire la connessione sicura e criptata, sono i seguenti:

Tutti i parametri di contesto presenti sono necessari per stabilire la connessione sicura e criptata e NON devono essere modificati. 

N.B. Gli unici due parametri che potranno essere modificati sono:

• WS_PASSWORD nel caso che l'utente cambi la password di accesso a OSD (https://osservatorio.cineca.it/)
• WS_USER nel caso che l'Ateneo cambi il referente ANS di accesso a OSD (https://osservatorio.cineca.it/)

Dalla versione 23.10.01 di Esse3 abbiamo provveduto, infatti, a rendere non modificabili/protetti, i seguenti parametri:
WS_TENANT e WS_URL_REST.

Il pulsante "Verifica Connessione" non è applicabile alla verifica dei nuovi servizi REST, per cui se lo cliccate riceverete un errore #NOCONNECT#.
Ignoratelo pure: eventuali errori reali nella configurazione dei Contesti sono esplicitati all'utente perché il servizio non ha il risultato atteso (in questo caso inviare la spedizione), oltre che nel log Esse3.

Servizi ANS Ricezione File Errori

E' stato adeguato Esse3 per gestire le chiamate al nuovo WS REST  Errori. 

Per l'interfaccia di documentazione delle API del mondo ANS si faccia riferimento allo swagger delle chiamate che trovate su https://wsans.cineca.it 

Se la versione di Esse3 è maggiore o uguale alle 23.08.02.00 si utilizzerà la configurazione che sfrutta l'utilizzo dei nuovi servizi REST. 

Per visualizzare la configurazione accedere alla maschera "Contesti", selezionare il contesto ANSWSERRFILENEW (nel file esse3.ini  il parametro ABILITA_CONFIGURAZIONE deve valere 1 affinchè vediate a Menù questa maschera).

I parametri significativi per questo contesto, necessari per stabilire la connessione sicura e criptata, sono i seguenti:

Tutti i parametri di contesto presenti sono necessari per stabilire la connessione sicura e criptata e NON devono essere modificati. 

N.B. Gli unici due parametri che potranno essere modificati sono:

• WS_PASSWORD nel caso che l'utente cambi la password di accesso a OSD (https://osservatorio.cineca.it/)
• WS_USER nel caso che l'Ateneo cambi il referente ANS di accesso a OSD (https://osservatorio.cineca.it/)

Dalla versione 23.10.01 di Esse3 abbiamo provveduto, infatti, a rendere non modificabili/protetti, i seguenti parametri:
WS_TENANT e WS_URL_REST.

Codici ERRORI WS REST SPEDIZIONI

Prima dell'esecuzione di uno qualunque degli endpoint, viene chiamato l’endpoint "Autenticazione" per poter recuperare il bearer token.

Riportiamo in tabella i codici risposta stampati attualmente nel log di Esse3.

Dalla maschera "Generazione Spedizioni ANS" generando una nuova spedizione verrà chiamato l’Endpoint WSANS “Servizi per le spedizioni ANS – Invio Spedizioni”.

Riportiamo in tabella i codici risposta stampati attualmente nel log di Esse3.

Dalla maschera "Riepilogo spedizioni ANS", per una spedizione pendente, cliccando su "Carica File Errori da OSD" verrà chiamato l’Endpoint WSANS “Servizi per le spedizioni ANS – Errori”.

Riportiamo in tabella i codici risposta stampati attualmente nel log di Esse3.

Errori restituiti da OSD e rimappatura in Esse3:

Alcuni casi utili:

1) Nel caso in cui si tenti di generare una spedizione mentre il parametro WS_URL_REST non è correttamente compilato la spedizione non verrà né generata né il file sarà salvato.
Il messaggio visualizzato a client sarà “L'URL inserito nei contesti non è corretto.”;

2) Nel caso in cui si tenti di generare una spedizione mentre uno o più dei parametri WS_USER, WS_TENANT, WS_PASSWORD non sono correttamente compilati, il messaggio client sarà
“Le credenziali inserite nei contesti non sono valide.”, mentre a log verrà stampato
“Codice Risposta WSANS = '403'; Token errato.”;

3) Se nella testata del file di spedizione inviato c’è un qualche errore di battitura, come ad esempio aver inserito aa_id ‘2022222’ invece che ‘2022’, il messaggio client sarà
“Errore durante la validazione del file.”, mentre a log verrà stampato
“Codice Risposta WSANS = '406'; Errore durante la validazione del file: 0005;Anno Invio non corretto.” (l’ultima parte del messaggio a log consiste nel messaggio recuperato da OSD).
Nuove modifiche, testate nel caricamento del file ERR.
1) Nel caso in cui si tenti di caricare un file ERR mentre uno o più dei parametri WS_USER, WS_TENANT, WS_PASSWORD non sono correttamente compilati, il messaggio client sarà
“Le credenziali inserite nei contesti non sono valide.”, mentre a log verrà stampato
“Codice Risposta WSANS = '403'; Token errato.”;

4) Se il PROGR utilizzato per il recupero del file ERR è inesistente o inesatto, il messaggio client sarà
  “La ricerca del file non ha prodotto risultati.”;

5) Nel caso in cui si tenti di caricare un file ERR prima che questo sia stato processato da OSD, il messaggio client sarà “La spedizione non è ancora stata processata da OSD.”

6) Nel caso in cui si tenti di caricare un file ERR2 prima che questo sia stato processato da OSD, il messaggio client sarà “Non è ancora disponibile il file ERR2 della coerenza.”

7) Nel caso in cui si tenti di caricare un file ERR2 per una spedizione di tipo TEST, il messaggio client sarà “Il file ERR2 non verrà calcolato per le spedizioni di TEST.”

Il pulsante "Verifica Connessione" non è applicabile alla verifica dei nuovi servizi REST, per cui se lo cliccate riceverete un errore #NOCONNECT#.
Ignoratelo pure: eventuali errori reali nella configurazione dei Contesti sono esplicitati all'utente perché il servizio non ha il risultato atteso (in questo caso inviare la spedizione), oltre che nel log Esse3.

Codici ERRORI WS REST SPEDIZIONI

Prima dell'esecuzione di uno qualunque degli endpoint, viene chiamato l’endpoint "Autenticazione" per poter recuperare il bearer token.

Riportiamo in tabella i codici risposta stampati attualmente nel log di Esse3.

Dalla maschera "Generazione Spedizioni ANS" generando una nuova spedizione verrà chiamato l’Endpoint WSANS “Servizi per le spedizioni ANS – Invio Spedizioni”.

Riportiamo in tabella i codici risposta stampati attualmente nel log di Esse3.

Dalla maschera "Riepilogo spedizioni ANS", per una spedizione pendente, cliccando su "Carica File Errori da OSD" verrà chiamato l’Endpoint WSANS “Servizi per le spedizioni ANS – Errori”.

Riportiamo in tabella i codici risposta stampati attualmente nel log di Esse3.

Mappatura risposte OSD/Esse3:

Casi di test utili:

1) Nel caso in cui si tenti di generare una spedizione mentre il parametro WS_URL_REST non è correttamente compilato la spedizione non verrà né generata né il file sarà salvato.
Il messaggio visualizzato a client sarà “L'URL inserito nei contesti non è corretto.”;

2) Nel caso in cui si tenti di generare una spedizione mentre uno o più dei parametri WS_USER, WS_TENANT, WS_PASSWORD non sono correttamente compilati, il messaggio client sarà
“Le credenziali inserite nei contesti non sono valide.”, mentre a log verrà stampato
“Codice Risposta WSANS = '403'; Token errato.”;

3) Se nella testata del file di spedizione inviato c’è un qualche errore di battitura, come ad esempio aver inserito aa_id ‘2022222’ invece che ‘2022’, il messaggio client sarà
“Errore durante la validazione del file.”, mentre a log verrà stampato
“Codice Risposta WSANS = '406'; Errore durante la validazione del file: 0005;Anno Invio non corretto.” (l’ultima parte del messaggio a log consiste nel messaggio recuperato da OSD).
Nuove modifiche, testate nel caricamento del file ERR.
1) Nel caso in cui si tenti di caricare un file ERR mentre uno o più dei parametri WS_USER, WS_TENANT, WS_PASSWORD non sono correttamente compilati, il messaggio client sarà
“Le credenziali inserite nei contesti non sono valide.”, mentre a log verrà stampato
“Codice Risposta WSANS = '403'; Token errato.”;

4) Se il PROGR utilizzato per il recupero del file ERR è inesistente o inesatto, il messaggio client sarà
  “La ricerca del file non ha prodotto risultati.”;

3) Nel caso in cui si tenti di caricare un file ERR prima che questo sia stato processato da OSD, il messaggio client sarà “La spedizione non è ancora stata processata da OSD.”

4) Nel caso in cui si tenti di caricare un file ERR2 prima che questo sia stato processato da OSD, il messaggio client sarà “Non è ancora disponibile il file ERR2 della coerenza.”

5) Nel caso in cui si tenti di caricare un file ERR2 per una spedizione di tipo TEST, il messaggio client sarà “Il file ERR2 non verrà calcolato per le spedizioni di TEST.”

Batch WS_ANS_DIPL e WS_ANS_UNIV

I batch WS_ANS_DIPL e WS_ANS_UNIV, che rispettivamente controllano la validità dei Diplomi e dei Titoli di Studio, sono stati scollegati dai SOAP. Dalla versione 23.12.01.00 contatteranno il servizio REST ANSGW che a sua volta contatterà OSD.

Batch WS_FILE_ERR 

Il batch WS_FILE_ERR è stato sganciato dalle repliche dalla versione 23.12.02.00

I file ERR vengono acquisiti correttamente da servizio rest tramite batch WS_FILE_ERR su spedizioni POST, PL, ANTE, con o senza errori.
Sia che il batch finisca in SUCCESS sia che finisca in FAILED, il batch non si interromperà al primo errore incontrato ma continuerà finché non avrà tentato di recuperare tutti i file ERR processati dal batch.

Il batch andato in SUCCESS potrà contenere:
- Recuperi di file ERR che hanno trovato riscontro e vengono caricati correttamente su DB; [200]
- Tentativi di recupero di file ERR o ERR2 che non sono ancora stati elaborati; [200 trasformato da codice a 404]
- Tentativi di recupero di file ERR2 con ANS_WEBSERVICE = TEST (essendo in prod, il parconf valorizzato a DEF, l’errore non dovrebbe verificarsi) [406]

Il batch andato in FAILED potrà contenere tutti i precedenti casi MA, se conterrà anche solo uno dei seguenti, alla fine dell’esecuzione andrà in FAILED:
- Tentativi di recupero con URL errato;
- Tentativi di recupero con almeno una delle credenziali utilizzate errata (username, password, codeUn); [403]
- Tentativi di recupero che non trovano riscontro; [404]
- Tentativi di recupero interrotti da un errore del server o di connessione (non testabile) [500]