Scopo del documento

Esse3 prevede un'integrazione con i servizi di CISIA, per l'acquisizione degli esiti dei test effettuati tramite le loro piattaforme.

L'integrazione realizzata prevede l'acquisizione dei risultati tramite un WebServices esposto da CISIA, ed opera scaricando i dati di tutti i candidati già iscritti ad un concorso di Esse3.

Il documento ha lo scopo di descrivere tale funzionalità.

Sarà aggiornato per descrivere i rilasci più importati effettuati su Esse3 nelle diverse funzionalità dell'area.

Revisioni

Integrazione Esse3-Cisia

Il recupero in ESSE3 dei dati relativi ai test effettuati sulla piattaforma di CISIA prevede l'interrogazione schedulato di un web service esposto da CISIA.

La schedulazione standard per il recupero dei dati è a livello giornaliero.

L'elaborazione è anche lanciabile manualmente dalla funzione 'Elaborazioni batch' e ha codice SyncCisia.

La struttura del servizio prevede il recupero in sequenza di:

•  Anagrafica delle Aree di Interesse

Le aree di interesse relative ai test effettuati sono identificate da un codice CISIA e una descrizione e vengono parcheggiate dal servizio di lettura schedulato di ESSE3 nella tabella EPI_IMP_AREE_INTERESSE.

Le aree di interesse attualmente recuperate sono:

•  anagrafica delle Sezioni dei Test: le sezioni del test recuperate dal servizio di CISIA sono parcheggiate nella tabella EPI_IMP_SEZIONI
  
  
•  anagrafica dei Tipi di Test erogati: Le tipologie di test recuperate vengono parcheggiate da ESSE3 nella tabella EPI_IMP_TIPI_TEST

Attenzione: in questo momento sono gestiti dal servizio fornito da CISIA solamente i test di tipo TOLC.

Per quanto riguarda le altre tipologie di test, i risultati sono scaricabili per le sedi solo tramite excel e dovranno pertanto essere importate manualmente in Esse3 usando i tracciati standard di importazione delle classifiche da file:

• • File Classifiche standard
  • File Classifiche formato CINECA
    
    
    
• anagrafica delle Modalità di erogazione dei Test:  Le modalità di erogazione dei test vengono salvate da ESSE3 nella tabella EPI_IMP_MOD_EROG_TEST (dato ripristinato dal CISIA dal 29/01/2024)

• anagrafica delle Configurazioni dei Test erogati: L'anagrafica delle configurazioni dei test erogati da CISIA viene parcheggiata da ESSE3 nella tabella EPI_IMP_CONFIG_TEST. (in coda al documento la lista dell'anagrafica delle configurazioni)
  
  
• elenco dei risultati dei Test svolti dagli studenti: data una sede, una tipologia di test e un'area di interesse, i risultati dei test eseguiti su CISIA per quella particolare area di interesse vengono salvati nelle tabelle:
  
  
  • EPI_IMP_STUDENTI_TEST (elenco degli studenti per i quali è stata fatta la richiesta di estrazione dei punteggi dei test);
  • EPI_IMP_RISULTATI_TEST (punteggi totali, numero risposte corrette totali, numero risposte errate totali, numero risposte nulle totali per ogni studente iscritto a quella particolare tipologia di test e area di interesse)
  • EPI_IMP_RISULT_SEZIONI (punteggi parziali di ogni studente per singola sezione del test, in particolare punteggio totale sulla singola sezione, numero di risposte errate sulla singola sezione, numero di risposte nulle sulla singola sezione)
  • EPI_IMP_RICH_ERRATA (è presente un record di errore per tutti quegli studenti per i quali non è stato possibile estrarre i risultati)

Impostazione su ESSE3 dei concorsi per i quali devono essere estratti i risultati da CISIA

Lato ESSE3 vanno identificati dall'ateneo i concorsi per i quali il sistema dovrà effettuare il recupero dei risultati su CISIA.

Per identificare i concorsi di ESSE3 che prevedono lo scarico dei punteggi dal sistema CISIA va impostato a livello di singolo concorso un codice esterno con la seguente struttura:

CISIA-<codice tipo test CISIA>;<codice area di interesse>

Dalla versione 23.04.00.00 sarà possibile gestire la valutazione di più TOLC sullo stesso concorso, per recuperare quello migliore che verrà utilizzato nelle classiffiche delle prove concorsuali:

basterà aggiungere i codici delle aree di interesse, separati da virgola.

Ad esempio un codice esterno valido sul concorso definito su ESSE3 potrebbe essere:

esempio per TIPOLOGIA  TOLC: CISIA-TOLC;AI02,AI05

esempio per TIPOLOGIA ALTRO:  CISIA-ALTRO;AL01

per identificare che il concorso è di tipo TOLC (Test online CISIA) e afferisce all'area di interesse INGEGNERIA che su CISIA ha codice AI02 (vedi tabelle a fine documento).

v

Una volta effettuato il setup dei concorsi nel modo illustrato sopra, popolando il “Codice esterno di concorso” e il blocco “Esito Cisia”, il sistema per ogni iscritto ai concorsi di ESSE3 marcati come CISIA costruisce la chiamata al servizio esposto da CISIA.

In questo modo si otterranno a livello di tipo test, codice fiscale, area di interesse e data di svolgimento del test, il punteggio totale e i punteggi parziali suddivisi per sezione.

Configurazione

A livello di Concorso (nella maschera “Concorsi”) è possibile configurare quali sono i test CISIA ritenuti validi ai fini dell'import delle classifiche di Esse3, in termini di:

a)    Limiti temporali:

verranno recuperati solo i test sostenuti in un certo range temporale (dal, al). È possibile valorizzare solo una o entrambe le date.

IMPORTANTE Il recupero dei TOLC al momento si divide in due fasi:

1. definizione dei concorsi per cui recuperare gli esiti;
2. quali esiti recuperare per ciascun candidati.

Per il punto 1 vengono recuperati tutti i concorsi il cui anno ricade tra il DR_CONC ed il DR_CONC meno il valore impostato nella maschera "Contesti" per parametro "CISIA_ANNI_PREC" (vedi sezione "configurazione del servizio" ).

Per il punto 2 vengono recuperati tutti i TOLC che hanno anno di svolgimento pari all'anno del concorso, anno del concorso -1, anno del concorso -2, anno del concorso - 3.

Dalla versione 21.07.00.00 è stata modificata la logica di recupero dei TOLC.

l recupero dei TOLC  si divide in due fasi:

1. definizione dei concorsi per cui recuperare gli esiti;
2. quali esiti recuperare per ciascun candidati.

Per il punto 1 vengono recuperati tutti i concorsi il cui anno ricade tra il DR_CONC ed il DR_CONC meno il valore impostato nella maschera "Contesti" per il parametro "CISIA_ANNI_CONC" (vedi sezione "configurazione del servizio" ).

Per il punto 2 se :

• sono popolate le date DAL  - AL presenti nella sezione "Esito CISIA" del concorso,  l'interrogazione viene effettuata per tutti gli anni che ricadono nel relativo intervallo temporale (es.: 01/10/2018 - 21/12/2020 --> anni 2018, 2019, 2020);
• se NON sono popolate le date DAL  - AL presenti nella sezione "Esito CISIA" del concorso,  l'interrogazione viene effettuata per tutti gli anni che ricadono tra (AA_ID - N) e AA_ID, dove AA_ID è l'anno su cui è configurato il concorso e N è il valore del parametro CISIA_ANNI_PREC (vedi sezione "configurazione del servizio" ).
• se è popolata solo una delle due date DAL  - AL presenti nella sezione "Esito CISIA" del concorso, la data non popolata viene considerata uguale all'anno del concorso (es.: 01/01/2020 - null per concorso configurato sul 2021 → anni 2020,2021)

b)   Erogazione:

• Tutti: verranno recuperati tutti gli esiti dei test effettuati nel periodo indicato.
• In presenza: verranno recuperati solo gli esiti dei TA= TOLC erogato in sede.
• Da casa: verranno recuperati solo gli esiti dei TAC = TOLC@CASA.

c)    Valutazione:

• Punteggio
• Numero risposte corrette

d)   Scelta dell'esito:

• ultimo effettuato
• miglior punteggio totale
• miglior punteggio escludendo alcune sezioni
• miglior punteggio includendo alcune sezioni

Nei casi sia stata scelta la modalità di Esito "miglior punteggio escludendo alcune sezioni" o "miglior punteggio includendo alcune sezioni" occorre definire quali siano le sezioni da escludere o includere, usando il pulsante "Dettaglio CISIA".

Es. Si decide di escludere la sezione di inglese dal punteggio finale

Nella maschera “Prove”, sulla singola prova concorsuale o sulla singola materia è possibile configurare quali sezioni siano da considerare in quella specifica classifica, utilizzando il pulsante "Dettaglio CISIA":

Cliccando sul pulsante “Dettaglio Cisia”, per la prova specifica si potrà scegliere la modalità di importazione degli esiti: “Inclusione specifiche sezioni” o “Esclusione specifiche sezioni”.

Es. Per la prova di Matematica, scegliendo “Inclusione specifiche sezioni” si sceglierà la sezione del TOLC, TCIN01 corrispondente a Matematica.

Importazione classifiche da esito CISIA

A livello di Concorso o di singola prova/materia è possibile effettuare due operazioni:

• Forzare la chiamata al WS di CISIA per scaricare gli esiti aggiornati dei candidati presenti nelle tabelle sottoelencate, tramite il pulsante "Sincronizza". Questa funzione è solo di aggiornamento non acquisisce né modifica i risultati nella classifica del concorso.
• Acquisire i risultati Cisia, andando a caricare gli esiti opportunamente calcolati sulle classifiche di Esse3, tramite il pulsante "Acquisisci risultati Cisia".

Tali operazioni effettuate dalla maschera “Concorsi” eseguono la chiamata per tutte le prove del concorso opportunamente configurate, mentre se eseguite sulla singola prova dalla maschera “prove”, avviene un aggiornamento dei dati solo per la prova stessa.

Estrazione dati

Attraverso la funzione Elaborazione Query si possono effettuare numerose estrazioni di dati.

Per avere una anteprima dell'elenco dei codici fiscali per i quali ESSE3 esegue una richiesta di ottenimento dei risultati dei test sulla piattaforma di CISIA, si può utilizzare la query con codice CISIA_RICH nella funzione Elaborazione Query. La query si basa sulla vista logica V_EPI_IMP_RISUL_TEST

Per ottenere e analizzare i risultati dei test eseguiti su CISIA, data una sede, una tipologia di test e un’area di interesse, in funzione del tipo di risultato (punteggio totale, numero risposte totali corrette, ecc…) che l'ateneo intende utilizzare per costruire le classifiche dei test su ESSE3 possono essere definite delle elaborazioni query opportune per costruire il file da caricare come esiti su ESSE3. Le query di controllo a disposizione sono:

CISIA_RIS (Risultati test online effettuati su CISIA)

CISIA_SEZ (Elenco risultati test online effettuati su CISIA suddivisi per sezione)

CISIA_ERR (Errori richieste estrazioni punteggi da sistema CISIA)

Configurazione del servizio

Lato ESSE3 per attivare il servizio schedulato di lettura dei risultati dei test su CISIA deve essere impostato l'URL del web service esposto da CISIA. Questa attività è a carico nostro ed è comunque tracciata nella funzione Contesti.

Nella tabella EPI_IMP_SEDI vanno impostati per ogni installazione di ESSE3 che ha aderito al servizio esposto da CISIA la chiave condivisa con CISIA per interrogare il servizio e il codice sede che cambia per ogni ateneo. Anche questa attività è a carico nostro ma è importante sapere che i codici di autenticazione (chiave condivisa) e il codice sede (uno per ogni ateneo) devono essere definiti in questa tabella affinché il servizio di lettura dati da CISIA possa funzionare.

TABELLE

Anagrafica delle Configurazioni dei Test erogati: L'anagrafica delle configurazioni dei test erogati da CISIA viene parcheggiata da ESSE3 nella tabella EPI_IMP_CONFIG_TEST.