Abstract

Con la versione 20.12.00.00 di ESSE3 è stato completato il rilascio del campo TIPO_SVOLGIMENTO_ESAME richiesto dal Ministero per tracciare lo svolgimento dell'esame da parte degli studenti

Lo scopo dell'intervento è quello di raccogliere i tipi svolgimento esame in fase di svolgimento di ogni singola prova e trasferire questa informazione nel libretto studente dove viene recuperata dalle procedure ANS per l'invio al ministero nelle schede apposite 

Le possibili sorgenti dove la modalità di svolgimento esame può essere inserita sono le seguenti

• lista iscritti 
• verbale d'esame (tramite Verbalidaemon o servizi REST)
• Riconoscimento
• prova del libretto

I possibili valori previsti sono i seguenti

Il valore richiesta_flg serve per differenziare gli stati che non possono essere inseriti a libretto ma che vanno approvati  modificando il dato in un codice valido.

Maggiori dettagli sull'utilizzo di questo campo nella sezione di configurazione e casi d'uso

Configurazione

Sono stati aggiunti i seguenti parametri nella maschera CONFIGURAZIONE CALENDARIO ESAMI

• GESTIONE_SVOLG_ESAME(PARAMETRI APPELLI)
• GESTIONE_SVOLG_ESAME_DEFAULT (PARAMETRI APPELLI)
• CHK_MODALITA_SVOLGIMENTO_ESA (PARAMETRI PRENOTAZIONE)

I primi due valori consentono di gestire la modalità di svolgimento esame su un tipo_gest_app nel seguente modo:

GESTIONE_SVOLG_ESAME

Consente di attivare la modalità, sono possibili i seguenti valori

• 0 - disattivata (default)
• 1 - Abilitata solo per Docenti e segreteria (caso d'uso 1)
• 2 - Abilitata per Studenti, docenti, segreteria  caso d'uso 2)

NB. per semplicità è indicato il caso d'uso di riferimento con la configurazione standard prevista, per i dettagli leggere i casi d'uso specifici, è comunque possibile variare la configurazione di default ottenendo altri casi d'uso tramite il parametro CHK_MODALITA_SVOLGIMENTO_ESA

GESTIONE_SVOLG_ESAME_DEFAULT

Nel caso il parametro GESTIONE_SVOLG_ESAME sia differente da zero questo parametro viene utilizzato per impostare la modalità di svolgimento esame di default da inserire in fase di prenotazione (se non inserita dallo studente in modo esplicito).

I valori possibili sono i seguenti

• PRESENZA
• DISTANZA

CHK_MODALITA_SVOLGIMENTO_ESA

Questo parametro viene utilizzato solo se GESTIONE_SVOLG_ESAME è diverso da zero ossia se viene attivata per l'appello in prenotazione la gestione dello svolgimento esame. 

L'utilizzo dei valori consente di definire il comportamento descritto nei casi d'uso per i valori 1 e 2 di GESTIONE_SVOLG_ESAME. Se i casi d'uso descritti soddisfano i requisiti non è necessario modificare questo valore.

I possibili valori del parametro sono i seguenti

• 0 - l'attore può selezionare tutti i valori di modalità svolgimento esame
• 1 - l'attore può selezionare i soli valori di RICHIESTA più il valore di default presente nel tipo_gest_app dell'appello

Nella configurazione di default i valori sono così impostati 

Con questa configurazione tutti gli attori tranne gli studenti hanno la facoltà di inserire dei valori finali al di fuori del default dell'appello (che risulta valido per tutti)

Casi d'uso

Sono previsti differenti casi d'uso a seconda della configurazione, di seguito gli esempi più comuni

Caso 0: Appelli on-line senza svolgimento esame

Nel caso non sia necessario indicare il tipo di svolgimento esame per un appello on-line il sistema si comporta come se il dato non fosse presente. Questa è anche la configurazione di default di tutti gli appelli. Occorre quindi abilitare in modo esplicito la gestione dello svolgimento esame 

Configurazione

Caso 1: Appelli on-line - inserimento da parte del docente

In questo caso è il docente che provvede alla registrazione della modalità di svolgimento in fase di inserimento esiti

I passi del processo sono i seguenti:

1. ogni appello ha definito un tipo svolgimento esame
2. Lo studente in fase di prenotazione non visualizza nessuna informazione, il sistema associa in automatico per tutti gli studenti 
3. (opzionale) il docente e/o la segreteria hanno la facoltà di inserire studenti all'appello. Anche in questo caso viene associato il valore di default  alla prenotazione
4. Il docente in fase di inserimento esiti può inserire il valore della modalità di svolgimento esame se differente rispetto a quello di default
5. Se è prevista la fase di pubblicazione il docente pubblica gli esiti (NB. lo svolgimento esame NON è inserito nella pubblicazione)
6. Il docente verbalizza gli esiti
7. Al caricamento del verbale nel libretto la modalità di svolgimento esame viene inserita nella riga del libretto

Configurazione

Caso 2: Appelli on-line - richiesta da parte dello studente e conferma da parte del docente

il caso d'uso è simile a quello precedente, viene però inserita la possibilità da parte dello studente di richiedere da parte dello studente una differente modalità di svolgimento esame rispetto a quella prevista per l'appello

I passi del processo sono i seguenti:

1. ogni appello ha definito un tipo svolgimento esame
2. Lo studente in fase di prenotazione visualizza la lista delle modalità di svolgimento con richiesta_flg = 1 (nel caso di default solo RD - richiesta distanza) più il default che è preselezionato in automatico, Può pertanto impostare una richiesta di modalità di svolgimento che il docente dovrà confermare o respingere
3. (opzionale) il docente e/o la segreteria hanno la facoltà di inserire studenti all'appello. Anche in questo caso viene associato il valore di default  alla prenotazione
4. Il docente in fase di inserimento esiti può i
   1. Nel caso lo studente non abbia effettuato nessuna "richiesta" può modificare o confermare il default previsto per l'appello
   2. Nel caso lo studente abbia effettuato una richiesta può confermare la richiesta andando a modificare il valore con un valore "finale", nel nostro esempio se approva la modalità a distanza inserirà D
   3. Nel caso lo studente abbia effettuato una richiesta può rifiutare la richiesta andando a modificare il valore con un valore "finale", nel nostro esempio se approva la modalità a distanza inserirà P
   4. Nel caso il docente lasci il valore richiesto questo verrà automaticamente convertito dal sistema al default in fase di verbalizzazione dell'esame
5. Se è prevista la fase di pubblicazione il docente pubblica gli esiti (NB. lo svolgimento esame NON è inserito nella pubblicazione)
6. Il docente verbalizza gli esiti
7. Al caricamento del verbale nel libretto la modalità di svolgimento esame viene inserita nella riga del libretto

Configurazione

Caso 3: Import verbali

II caso d'uso permette agli applicativi che non gestiscono le verbalizzazioni on-line ma che importano i verbali cartacei (tramite VerbaliDaemon oppure il servizio REST di import dei verbali) di definire  la modalità di svolgimento esame in un verbale da importare

Configurazione

Import tramite file CSV

Nel file CSV occorre definire il campo TIPO_SVOLGIMENTO_ESAME (la colonna di intestazione si deve chiamare esattamente TipoSvolgimentoEsameCod) e caricare la colonna nel file. Il caricmento del file con VerbaliDaemon effettuerà il caricamento sul verbale e poi sul libretto del valore indicato

Import tramite i servizi REST

Nel servizio POST - verbali-api-v1/batches è possibile indicare nel payload su ogni singolo verbaleInserimento il campo tipoSvolgimentoEsameCod tra le chiavi aggiuntive. Un esempio di payload è il seguente

{
  "nomeFileBatch": "batch",
  "batchNum": 111,
  "tipo": "INS",
  "verbaliInserimento": [
    {
      "matricola": "10-MAT",
      "dataEsa": "10/10/2018",
      "dataApp": "10/10/2018",
      "voto": 30,
      "causale": null,
      "campiAggiuntivi": [
        {
          "nome": "tipoSvolgimentoEsameCod",
          "valore": "D"
        }
      ],
      "adStuCod": "AD_STU_COD",
      "cdsStuCod": "CDS_STU_COD"
    }
  ]
}

Funzioni Modificate

WEB DOCENTE

La funzione della lista iscritti lato docente è stata modificata aggiungendo la colonna "Svolg Esame" con la modalità di svolgimento esame prevista per la singola prenotazione.

La colonna non viene visualizzata se TIPI_GEST_APP.GESTIONE_SVOLG_ESAME = 0

Accanto ai valori con "richiesta_flg = 1" viene inserita una segnalazione per ricordare al docente di confermare oppure modificare il tipo svolgimento esame nel caso non intenda confermare la richiesta dello studente.

In tooltip è presente la descrizione del codice di richiesta esame inserito

Le pagine dove è stata inserita la colonna sono le seguenti:

• pagina lista iscritti;
• inserimento esiti massivo
  
• inserimento esiti puntuale
  
  
• stampa lista iscritti
  
• sposta studenti da un turno all'altro
  
• iscrivi studenti da lista iscritti precedente
  
• export/import da excel
  

WEB STUDENTE

E' stata modificata la funzione di prenotazione per consentire allo studente (caso d'uso 2) di selezionare una modalità di svolgimento esame con richiesta_flg = 1

La modalità di svolgimento esame viene visualizzata nella bacheca prenotazioni

SERVIZI REST

POST calesa-service-v1/appelli/{cdsId}/{adId}/{appId}/iscritti

L'endpoint di prenotazione è stato modificato per permettere la valorizzazione del campo tipoSvolgimentoEsameCod nel caso l'attore possa inserire questo valore in fase di prenotazione

GET calesa-service-v1/appelli/{cdsId}/{adId}/{appId}/iscritti

GET calesa-service-v1/appelli/{cdsId}/{adId}/{appId}/iscritti/{stuId}

Gli endpoint di recupero della lista iscritti sono stati modificati per includere le informazioni sullo svolgimento esame

CLIENT DI SEGRETERIA

LIBRETTO

E' stato aggiunto il campo Svolgimento al libretto, Il valore non è modificabile dal libretto.

Normalmente il popolamento di questo campo avviene tramite verbalizzazioni (on-line oppure con VerbaliDaemon) oppure tramite le procedure di caricamento di un esame (registrazione prove oppure riconosicmenti)

Le modifiche sono comunque possibili da manutenzione carriera (per correzione valori errati dai caricamenti precedenti)

Manutenzione Carriera

è stato aggiunto il campo in manutenzione carriera per permettere la modifica del valore nel caso ci siano degli errori, come ogni campo modificato da manutenzione carriera lo storico delle modifiche è disponibile nel tasto Storico Operazioni del libretto.

Sono esclusi i valori "richiesta_flg = 1" tra i possibili valori selezionabili

Carica Prove

Nel caricamento di una prova da libretto è stato aggiunto il campo Svolgimento, anche in questo caso i soli valori selezionabili sono quelli con "richiesta_flg = 0"

Riconoscimenti

Nella maschera dei riconoscimenti è stato aggiunto il campo Svolgimento. Anche in questo caso i soli valori selezionabili sono quelli con "richiesta_flg =0" 

LISTA ISCRITTI

E' stato aggiunto il campo Svolgimento alla lista iscritti. Il campo risulta modificabile se l'appello prevede la modalità di svolgimento esame. I valori selezionabili  sono identificati dalla configurazione della maschera "configurazione calendario esami". Nella configurazione di default la segreteria vede tutti i valori disponibili