Query di controllo

Gli atenei per i quali è in essere l'integrazione con Banca Popolare di Sondrio hanno a disposizione un'apposita query di controllo, utilizzabile da client Esse3 tramite la funzione Elaborazione Query, per ottenere tutti i dettagli delle Carte Ateneo+ richieste e/o emesse: si tratta della query avente codice identificativo POPSO_BDG.



La query permette di ottenere in maniera aggregata tutti i principali dati relativamente alle carte badge POPSO degli studenti, tenendo conto di quanto censito su Esse3 per il badge e dei diversi flussi scambiati con l'ente tesoriere:

  • flussi da ateneo a POPSO per le richieste di emissione (tracciati ANAG, INFO e FOTO)
  • flussi da POPSO all'ateneo per gli esiti (tracciati OK, KO, CO e Z1).


Tra i dati ritornati ha particolare rilevanza il campo STATO, i cui valori ed il relativo significato sono riportati nella seguente tabella.

StatoSignificato
RICHIESTOE' stato inviato a POPSO un flusso di richiesta (tracciati ANAG, INFO e FOTO) e non è ancora stato ricevuto alcun flusso di ritorno che indichi l'avvenuta emissione
ERRATOA fronte della richiesta di emissione POPSO ha ritornato un esito di errore (motivo per cui la carta badge non e' ancora stata emessa)
STAMPATOIl badge è stato emesso da POPSO: su Esse3 è stato acquisito un flusso OK, impostando come data di stampa del badge la data di caricamento di tale flusso
PRONTOIl badge è pronto per la consegna: su Esse3 è stato acquisito un flusso CO, inviando allo studente una mail nella quale lo si invita a prendere appuntamento per la consegna
CONSEGNATOIl badge risulta già consegnato: ciò può accadere indifferentemente se viene acquisito un flusso Z1 oppure se il badge su Esse3 viene marcato manualmente come tale
ANNULLATOIl badge su Esse3 risulta annullato
N.B.: il fatto che l'entità badge su Esse3 risulti annullata NON implica un annullamento della relativa Carta Ateneo+ di POPSO (non è previsto alcun flusso di annullamento)


I dati di dettaglio estratti dalla query sono quelli riportati nella tabella seguente.

CampoDescrizione
ID_CARTAID univoco della Carta Ateneo+ emessa, ovvero il codice RFID attribuito
STATO

Stato della carta - valori possibili:

  • RICHIESTO

  • ERRATO

  • STAMPATO

  • PRONTO
  • CONSEGNATO
  • ANNULLATO
ERRORE_DESDescrizione dell'errore ritornato da POPSO sulla richiesta di emissione (solo nel caso in cui la carta risulti in stato ERRATO)
COD_FISCodice Fiscale dello studente
COGNOMECognome dello studente
NOMENome dello studente
NOME_ALIASNome Alias dello studente (per i casi di "transizione di genere")
MATRICOLAMatricola dello studente
PERS_IDID di anagrafica persona dello studente
USER_IDUser ID dello studente
BDG_CODCodice identificativo del badge Esse3
BDG_IDID univoco del badge Esse3
BDG_ANN_FLGIndica se il badge in Esse3 risulta annullato (1: si - 0: no)
BDG_CONS_FLGIndica se il badge in Esse3 risulta consegnato (1: si - 0: no)
BDG_REST_FLGIndica se il badge in Esse3 risulta restituito (1: si - 0: no)
BDG_SERV_BANC_FLGIndica se sul badge Esse3 risultano attivi i servizi bancari (1: si - 0: no)
IBAN_CARTAIBAN associato alla carta (come risulta dall'ultimo flusso Z1 ricevuto, nel caso siano stati attivati i servizi bancari)
IBAN_RIMBIBAN presente su Esse3 come coordinata bancaria di rimborso
(di solito coincide con quello associato alla carta, quando acquisito dal flusso Z1, a meno che non sia stato successivamente variato in anagrafica studente su Esse3)
FLUSSO_ANAG_FILE

File ANAG all'interno del quale è stata inviata a POPSO la richiesta di emissione (ultima richiesta, se presente)

FLUSSO_ANAG_DATAData/ora di generazione del file ANAG
FLUSSO_OK_FILEFile relativo all'ultimo flusso OK ricevuto da POPSO per la carta badge in questione
FLUSSO_OK_DATAData/ora di caricamento in Esse3 del flusso OK
FLUSSO_CO_FILEFile relativo all'ultimo flusso CO ricevuto da POPSO per la carta badge in questione
FLUSSO_CO_DATAData/ora di caricamento in Esse3 del flusso CO
ULTIMA_OPER_DESDescrizione dell'ultima operazione intervenuta sul badge Esse3 (come da relativa storico operazioni)
ULTIMA_OPER_DATAData/ora dell'ultima operazione risultante sul badge Esse3
ULTIMA_OPER_USERUtente che ha compiuto l'ultima operazione risultante sul badge Esse3


I parametri di filtro previsti per ogni esecuzione delle query sono quelli indicati qui di seguito.

ParametroDescrizione
id_cartaID univoco della Carta Ateneo+ (utilizzare * per indicare qualsiasi)
statoStato della carta (valori indicati sopra - oppure utilizzare * per indicare qualsiasi tipo)
cod_fisCodice Fiscale dello studente (utilizzare * per indicare qualsiasi)
user_idUser ID dello studente (utilizzare * per indicare qualsiasi)
ultima_oper_daData ultima operazione DA
ultima_oper_aData ultima operazione A


Forzatura nuova emissione

In alcuni casi può essere necessario forzare l'invio a POPSO di una nuova richiesta di emissione Carta Ateneo+ per studenti relativamente ai quali era già stata fatta richiesta in precedenza (e, a meno di errori, una carta era già stata emessa).
O magari forzare la richiesta di emissione anche per studenti per i quali non vi è mai stata alcuna precedente richiesta, ad esempio vecchi studenti che non rientrano nelle condizioni previste per l'invio automatico delle nuove richieste.

A partire dalla versione 21.08.00.00 di Esse3 a tale scopo può essere utilizzata da client Esse3 la funzione “Caricamento flussi”, preparando un apposito file CSV che contiene l’indicazione degli studenti su cui operare.

Dalla maschera in questione sarà sufficiente:

  • impostare come Tipo flusso “Forzatura nuova emissione Carta Ateneo+ di POPSO”
  • selezionare il file CSV da caricare
  • premere il pulsante “Avvia caricamento”.

Il file da caricare deve essere un semplice file di testo con separatore “;” che rispetti il seguente tracciato (senza alcuna riga di intestazione):

<Codice Fiscale>;<Matricola>;<ID Carta>

Non è necessario indicare tutti e tre i campi, basta popolarne anche solo uno (il loro scopo è fornire metodi alternativi per indicare lo studente su cui agire).

Seguono alcuni esempi:

RSSMRA03B01H501E;123456;SON0000000000987654321
RSSMRA03B01H501E;;
;123456;

Attenzione

Se si utilizza Excel per aprire e modificare il file bisogna fare attenzione a non salvarlo poi in formato Excel, in quanto la funzione lavora basata sul formato CSV con separatore ";" (consultabile anche con semplice editor di testo).


Il caricamento e l’elaborazione del file avverranno in maniera asincrona, dalla medesima maschera tramite il pulsante “Aggiorna” sarà possibile consultarne lo stato di avanzamento.

Al termine è possibile anche accedere al dettaglio dell’elaborazione ed avere così evidenza di:

  • numero di record elaborati con successo
  • numero di record non elaborati (scartati)
  • file con il dettaglio degli scarti (quali record e per quale motivo).

Le casistiche di errore che comportano la mancata esecuzione dell'operazione richiesta, generando quindi i relativi scarti, sono le seguenti:

  • non risulta una richiesta di emissione fatta in precedenza (ed eventuale relativa carta già emessa) - a partire dalla versione 22.04.03.00 di Esse3 è possibile configurare il sistema per non applicare tale controllo e consentire quindi di forzare una qualsiasi richiesta di emissione indipendentemente dal fatto che ve ne sia già stata una precedente per lo studente
  • è già presente una richiesta di emissione ancora pendente (già inviata ed ancora senza esito)
  • è già prevista una nuova richiesta di emissione, prossima all'invio (ad esempio è appena stata forzata richiesta di nuova emissione e si tenta di ripeterla)
  • la nuova richiesta di emissione è stata forzata, ma non può avere effetto perchè lo studente comunque non soddisfa le condizioni di carriera e presenza/validità foto previste.


Nota bene

A partire dalla versione 22.03.00.00 di Esse3 la funzione di Forzatura nuova emissione genera in automatico un nuovo badge su Esse3 nel caso ne esista già uno relativo ad una precedente richiesta di emissione a POPSO andata a buon fine, oppure non sia presente alcuna richiesta precedente (si mantiene invece il badge esistente se la precedente richiesta era terminata in errore).

Su tale nuovo badge verrà infatti attestata la richiesta di nuova emissione a POPSO: se esiste già un badge attivo questo verrà automaticamente annullato per consentire la creazione di quello nuovo (dal momento che in Esse3 per lo stesso utente non possono esistere più badge attivi nello stesso istante).
L'annullamento del precedente badge su Esse3 non comporta comunque l'invio di alcuna richiesta di annullamento a POPSO (non sono previsti flussi di blocco/estinzione della carta).