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

RevisioneDataVersione di riferimentoNote
1

 

19.05.02.00Aggiunta la documentazione dei nuovi attributi di configurazione a livello di concorso e delle funzioni di Acquisizione dei risultati da Cisia
2

 


Aggiunta specifica sulle tipologie di test che al momento sono scaricabili dal servizio (solo test TOLC)
3

 


Aggiornate le tabelle con i codici Aree di Interesse e Sezioni
4

 


Aggiunta specifica sui test ARCHED, che non sono scaricabili dal servizio
5

20.07.02.00Aggiunta l'informazione in merito alle modalità di erogazione dei test
6

 

20.07.04.00

Aggiunti criteri di filtro degli esiti in relazione alla modalità di erogazione del test.

Aggiunta possibilità di usare il numero di risposte esatte come punteggio del test.

7

 


Aggiunta specifica sui test TEST DI ITALIANO-L2

8

 

23.04.00.00

Aggiunta la possibilità di valutare più codici TOLC sullo stesso concorso

9


Ripristinata la modalità di erogazione del test: TOLC erogato in sede e TOLC@CASA


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:

Codice CISIA Area di interesse

Descrizione Area di interesse

Tipologia

Codice

AI02

INGEGNERIA

TOLC

TOLC-I

AI03

ECONOMIA

TOLC

TOLC-E

AI04

SCIENZE

TOLC

TOLC-S

AI05

FARMACIA

TOLC

TOLC-F

AI06

BIOLOGIA

TOLC

TOLC-B

AI07

ECONOMIA INGLESE

TOLC

English TOLC-E

AI08

INGEGNERIA INGLESE

TOLC

English TOLC-I

AI09

UMANISTICA

TOLC

TOLC-SU
AI10AGRARIATOLCTOLC-AV
AI11FARMACIA INGLESETOLCEnglish TOLC-F
AI12PSICOLOGIATOLCTOLC-PSI
AI13MEDICINATOLCTOLC-MED
AI14   VETERINARIATOLCTOLC-VET
AI15LAUREE PROFESSIONALIZZANTITOLCTOLC-LP
AI16SCIENZE POLITICHE SOCIALITOLCTOLC-SPS
AL01   TEST DI ITALIANO-L2ALTROITA-L2
AL02TEST BRAVO! - ITALIANO L2ALTROITA-L2 (Bravo!)
AL03TEST SPSALTROTEST-SPS


  •  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

Codice tipologia test CISIA

Descrizione tipologia di test

Scaricabile dal servizio
TOLCTest online CISIA

OFA

Recupero Obblighi Formativi Aggiuntivi

No

TIP

Test in presenza

No
ARCHEDArchitettura, Ingegneria EdileNo
ALTROAltri test erogati da CISIASi



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:

Codice CISIA Modalità di erogazione

Descrizione Modalità di erogazione

TATOLC erogato in sede

TAC

TOLC@CASA


  • 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.

Codice tipo test

Descrizione tipo test

Codice area interesse

Descrizione area interesse

Codice sezione

Descrizione sezione

TOLCTest online CISIAAI02INGEGNERIATCIN01MATEMATICA
TOLCTest online CISIAAI02INGEGNERIATCIN02LOGICA
TOLCTest online CISIAAI02INGEGNERIATCIN03SCIENZE
TOLCTest online CISIAAI02INGEGNERIATCIN04COMPRENSIONE VERBALE
TOLCTest online CISIAAI02INGEGNERIATCIN05INGLESE
TOLCTest online CISIAAI03ECONOMIATCEC01LOGICA
TOLCTest online CISIAAI03ECONOMIATCEC02COMPRENSIONE VERBALE
TOLCTest online CISIAAI03ECONOMIATCEC03MATEMATICA
TOLCTest online CISIAAI03ECONOMIATCEC04INGLESE
TOLCTest online CISIAAI04SCIENZETCSC01MATEMATICA DI BASE
TOLCTest online CISIAAI04SCIENZETCSC02RAGIONAMENTO E PROBLEMI
TOLCTest online CISIAAI04SCIENZETCSC03COMPRENSIONE DEL TESTO
TOLCTest online CISIAAI04SCIENZETCSC04SCIENZE DI BASE
TOLCTest online CISIAAI04SCIENZETCSC05INGLESE
TOLCTest online CISIAAI05FARMACIATCFA01BIOLOGIA
TOLCTest online CISIAAI05FARMACIATCFA02CHIMICA
TOLCTest online CISIAAI05FARMACIATCFA03MATEMATICA
TOLCTest online CISIAAI05FARMACIATCFA04FISICA
TOLCTest online CISIAAI05FARMACIATCFA05LOGICA
TOLCTest online CISIAAI05FARMACIATCFA06INGLESE
TOLCTest online CISIAAI06BIOLOGIATCBI01MATEMATICA DI BASE
TOLCTest online CISIAAI06BIOLOGIATCBI02BIOLOGIA
TOLCTest online CISIAAI06BIOLOGIATCBI03FISICA
TOLCTest online CISIAAI06BIOLOGIATCBI04CHIMICA
TOLCTest online CISIAAI06BIOLOGIATCBI05INGLESE
TOLCTest online CISIAAI07ECONOMIA INGLESETCEE01LOGIC
TOLCTest online CISIAAI07ECONOMIA INGLESETCEE02READING COMPREHENSION
TOLCTest online CISIAAI07ECONOMIA INGLESETCEE03MATHEMATICS
TOLCTest online CISIAAI08INGEGNERIA INGLESETCEI01MATHEMATICS
TOLCTest online CISIAAI08INGEGNERIA INGLESETCEI02LOGIC
TOLCTest online CISIAAI08INGEGNERIA INGLESETCEI03SCIENCES
TOLCTest online CISIAAI08INGEGNERIA INGLESETCEI04READING COMPREHENSION
TOLCTest online CISIAAI09UMANISTICATCSU01COMPRENSIONE DEL TESTO E CONOSCENZA DELLA LINGUA ITALIANA
TOLCTest online CISIAAI09UMANISTICATCSU02CONOSCENZE E COMPETENZE ACQUISITE NEGLI STUDI
TOLCTest online CISIAAI09UMANISTICATCSU03RAGIONAMENTO LOGICO
TOLCTest online CISIAAI09UMANISTICATCSU04INGLESE
TOLCTest online CISIAAI10AGRARIATCAG01BIOLOGIA
TOLCTest online CISIAAI10AGRARIATCAG02CHIMICA
TOLCTest online CISIAAI10AGRARIATCAG03FISICA
TOLCTest online CISIAAI10AGRARIATCAG04MATEMATICA
TOLCTest online CISIAAI10AGRARIATCAG05LOGICA
TOLCTest online CISIAAI10AGRARIATCAG06COMPRENSIONE VERBALE
TOLCTest online CISIAAI10AGRARIATCAG07INGLESE
TOLCTest online CISIAAI11FARMACIA INGLESETCEF01BIOLOGY
TOLCTest online CISIAAI11FARMACIA INGLESETCEF02CHEMISTRY
TOLCTest online CISIAAI11FARMACIA INGLESETCEF03MATHEMATICS
TOLCTest online CISIAAI11FARMACIA INGLESETCEF04PHYSICS
TOLCTest online CISIAAI11FARMACIA INGLESETCEF05LOGIC
TOLCTest online CISIAAI12PSICOLOGIATCPS01COMPRENSIONE DEL TESTO
TOLCTest online CISIAAI12PSICOLOGIATCPS02MATEMATICA DI BASE
TOLCTest online CISIAAI12PSICOLOGIATCPS03

RAGIONAMENTO VERBALE

TOLCTest online CISIAAI12PSICOLOGIATCPS04RAGIONAMENTO NUMERICO
TOLCTest online CISIAAI12PSICOLOGIATCPS05BIOLOGIA
TOLCTest online CISIAAI12PSICOLOGIATCPS06INGLESE
TOLCTest online CISIAAI13MEDICINA

TCME01

COMPRENSIONE DEL TESTO E CONOSCENZE ACQUISITE NEGLI STUDI
TOLCTest online CISIAAI13MEDICINA

TCME02

BIOLOGIA
TOLCTest online CISIAAI13MEDICINA

TCME03

CHIMICA E FISICA
TOLCTest online CISIAAI13MEDICINA

TCME04

MATEMATICA E RAGIONAMENTO
TOLCTest online CISIAAI14VETERINARIA

TCVE01

COMPRENSIONE DEL TESTO E CONOSCENZE ACQUISITE NEGLI STUDI
TOLCTest online CISIAAI14VETERINARIA

TCVE02

BIOLOGIA
TOLCTest online CISIAAI14VETERINARIA

TCVE03

CHIMICA E FISICA
TOLCTest online CISIAAI14VETERINARIA

TCVE04

MATEMATICA E RAGIONAMENTO
TOLCTest online CISIAAI15LAUREE PROFESSIONALIZZANTITCLP01MATEMATICA
TOLCTest online CISIAAI15LAUREE PROFESSIONALIZZANTITCLP02LOGICA
TOLCTest online CISIAAI15LAUREE PROFESSIONALIZZANTITCLP03COMPRENSIONE VERBALE
TOLCTest online CISIAAI15LAUREE PROFESSIONALIZZANTITCLP04INGLESE
TOLCTest online CISIAAI16SCIENZE POLITICHE SOCIALITCSP01COMPRENSIONE DEL TESTO
TOLCTest online CISIAAI16SCIENZE POLITICHE SOCIALITCSP02CONOSCENZE ACQUISITE
TOLCTest online CISIAAI16SCIENZE POLITICHE SOCIALITCSP03LOGICA, RAGIONAMENTO E LINGUAGGIO MATEMATICO
TOLCTest online CISIAAI16SCIENZE POLITICHE SOCIALITCSP04INGLESE
ALTROAltri test erogati da CISIAAL03TEST SPSTSPS01COMPRENSIONE DEL TESTO
ALTROAltri test erogati da CISIAAL03TEST SPSTSPS02CONOSCENZE ACQUISITE
ALTROAltri test erogati da CISIAAL03TEST SPSTSPS03LOGICA, RAGIONAMENTO E LINGUAGGIO MATEMATICO
ALTROAltri test erogati da CISIAAL03TEST SPSTSPS04INGLESE
ALTROAltri test erogati da CISIAAL01ITALIANOITL201ASCOLTO - Brano 1
ALTROAltri test erogati da CISIAAL01ITALIANOITL202ASCOLTO - Brano 2
ALTROAltri test erogati da CISIAAL01ITALIANOITL203LETTURA
ALTROAltri test erogati da CISIAAL01ITALIANOITL204

STRUTTURE LINGUISTICHE

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL201

1a Ascolto

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL202

1b Lettura

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL203

1c Strutture linguistiche

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL204

2a Ascolto

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL205

2b Lettura

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL206

2c Strutture Linguistiche

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL207

3a Ascolto

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL208

3b Lettura

ALTROAltri test erogati da CISIAAL02ITALIANO (Bravo!)BIL209

3c Strutture linguistiche