Smart Query
Dal menu principale si accede alla funzionalità Smart query dal quale si possono selezionare diverse Entità predefinite (Docenti, Registro docente, ecc) ovvero viste su tabelle di database. In esse è quindi possibile ricercare le informazioni in maniera semplificata in quanto la scrittura della query è guidata e non è necessario conoscere la struttura del database di Esse3.
BulK Change
Dal menu principale → Bulk Change si apre la pagina Bulk API, cioè API in grado di modificare in maniera massiva dati in tabelle del database a partire da una query o da un file excel.
Nella pagina si può effettuare una ricerca per Ambito o API ed è presente un flag per mostrare solo le API disponibili.
Ciascuna API è caratterizzata da una descrizione, dal numero di versione di Esse3 e dall'indicazione dell'annullabilità dell'azione una volta modificati i dati (se SI, sarà possibile ripristinare lo stato iniziale del database al termine dell'elaborazione).
Le Bulk API possono essere eseguite in tre diverse modalità: da SQL, da Excel o da Smart query.
Nella immagine sottostante riportiamo le prime quattro bulk change di area ANS.
Aprendo l'API, l'utente trova una descrizione e un elenco di parametri. Per ognuno di essi vengono specificati:
- Descrizione;
- Tipo (tipo di dato);
- Riferimento DB (tabella o vista in cui è presente la colonna);
- Obbligatorio (la valorizzazione del parametro è vincolante o meno al fine dell'esecuzione).
Per invocare l'API è necessario passargli in input dei parametri che possono essere espressi tramite valori fissi o dinamici:
- Fisso: viene assegnato un valore (in caso fosse un booleano sono già presenti i valori "Abilitazione" e "Disabilitazione");
- Dinamico: si seleziona la colonna della tabella da cui prendere i valori per ogni riga. Può accadere che la formattazione della suddetta colonna e il tipo di dato del parametro siano diversi, la procedura sarà comunque eseguita ma verrà segnalato il problema.
In questo modo l'utente definisce un mapping tra l'excel/query inseriti in fase di esecuzione e i parametri di input dell'API.
UPDATE_TESTATA - Aggiorna NOTE e VIP_FLG di una spedizione.
Funzionalità Bulk API che consente di modificare in maniera massiva alcuni dati di una testata di una spedizione, tabella P15_ANS_TST, precisamente i campi VIP_FLG e NOTE.
Tale API è annullabile una volta modificati i dati ovvero sarà possibile ripristinare lo stato iniziale del database al termine dell'elaborazione.
Parametri:
ans_tst_id → Id della testata di una spedizione (P15_ANS_TST.ANS_TST_ID), obbligatorio.
enabled_vip → Tipo di operazione: abilitazione o disabilitazione (P15_ANS_TST.VIP_FLG), obbligatorio.
note → Tipo di operazione: aggiornamento note (NB: se questo parametro non viene specificato, il campo corrispondente sarà impostato a NULL) (P15_ANS_TST.NOTE), facoltativo.
PORTFOLIO_NON_AGGIORNABILE - Aggiorna NO_AGGIORNA_FLG e NOTE di uno o più portfoli.
Funzionalità Bulk API che consente di modificare in maniera massiva alcuni dati del portfolio dello studente, tabella P01_STU_ANS., precisamente i campi NOTE. e NO_AGGIORNA_FLG.
Tale API è annullabile una volta modificati i dati ovvero sarà possibile ripristinare lo stato iniziale del database al termine dell'elaborazione.
Parametri:
no_aggiorna → Tipo di operazione: possibile aggiornare o non possibile aggiornare (P01_STU_ANS.NO_AGGIORNA_FLG), obbligatorio.
stu_id → Id dello studente (P01_STU_ANS.STU_ID), obbligatorio.
note → Tipo di operazione: aggiornamento note (NB: se questo parametro non viene specificato, il campo corrispondente sarà impostato a NULL) (P01_STU_ANS.NOTE), facoltativo.
ESCLUDI_STUDENTE - Aggiorna NOTE e ESCL_FLG di uno o più portfoli.
Funzionalità Bulk API che consente di modificare in maniera massiva alcuni dati del portfolio dello studente, tabella P01_STU_ANS., precisamente i campi NOTE. e ESCL_FLG.
Tale API è annullabile una volta modificati i dati ovvero sarà possibile ripristinare lo stato iniziale del database al termine dell'elaborazione.
Parametri:
esclusion→ Tipo di operazione: esclusione o inclusione (P01_STU_ANS.ESCL_FLG), obbligatorio.
stu_id → Id dello studente (P01_STU_ANS.STU_ID), obbligatorio.
note → Tipo di operazione: aggiornamento note (NB: se questo parametro non viene specificato, il campo corrispondente sarà impostato a NULL) (P01_STU_ANS.NOTE), facoltativo.
PUT_LIBRETTO_ANS - Aggiorna NO_AGGIORNA_FLG, FORZA_INVIO_FLG e NOTE_NO_AGG di uno o più esami.
Funzionalità Bulk API che consente di modificare in maniera massiva alcuni dati del libretto ANS dello studente, tabella P15_AD_SCE_MIUR, precisamente i campi FORZA_INVIO_FLG, NO_AGGIORNA_FLG, NOTE_NO_AGG
Tale API è annullabile una volta modificati i dati ovvero sarà possibile ripristinare lo stato iniziale del database al termine dell'elaborazione.
Parametri:
adsce_id→ Id Esame (P15_AD_SCE_MIUR.ADSCE_ID), obbligatorio.
forza_invio → Tipo di operazione: forzatura, obbligatorio.
no_aggiorna → Tipo di operazione: possibile aggiornare o non possibile aggiornare (P15_AD_SCE_MIUR.NO_AGGIORNA_FLG), obbligatorio.
note_no_agg→ Tipo di operazione: aggiornamento note (NB: se questo parametro non viene specificato, il campo corrispondente sarà impostato a NULL) (P15_AD_SCE_MIUR.NOTE_NO_AGG), facoltativo.
Esecuzione di una Bulk API
Questa funzionalità permette di procedere alla modifica massiva di dati sfruttando alcune API predefinite di Esse3.
Selezionando uno dei casi dalla lista iniziale, si trova la possibilità di scaricare la query e il documento excel di esempio dell'API selezionata; è sufficiente cliccare sui relativi pulsanti in alto a destra. Questi file costituiscono un'esemplificazione delle modalità con cui l'utente può ottenere i dati che, come vedremo, serviranno per la modifica massiva.
Esecuzione da SQL
Cliccando su "Esegui da SQL" si presenta un riquadro in cui è possibile scrivere una query oppure caricare quella di esempio e modificarla ("Carica SQL di esempio") oppure se ne può scegliere una tra quelle salvate ("Carica query"). Una volta inserita la query, l'utente può eseguirla cliccando su "Avanti" e apparirà il risultato in una tabella; si noti che alcune query sono settate per recuperare un numero massimo di record e, per questo, potrebbe comparire un errore.
Esecuzione da Excel
Cliccando su "Esegui da Excel" si apre un'interfaccia dalla quale si carica un file che viene importato e mostrato in forma tabellare. Si può optare per caricare un file in formato .csv o .xlsx e indicare la presenza o meno della testata nel file stesso.
Esecuzione da Smart query
Cliccare su "Esegui da Smart query". Viene mostrata la barra di ricerca in cui si può scrivere una Smart query per acquisire i dati, si può poi decidere se conservare tutti i record recuperati.
Per la documentazione su Esse3 Admin si consulti questo menù Esse3 Admin