Flussi contributivi ANS

Questa funzione soddisfa al requisito di avere una funzionalità applicativa che permette l’acquisizione di un flusso contributivo di un determinato anno accademico, tramite l’acquisizione di un file di flusso che contiene le causali di supporto degli studenti di un determinato anno accademico. La funzionalità ha il duplice scopo di incamerare i file di flusso e di permettere una visione della situazione globale, permettendo inoltre l’esportazione di un file Excel.

Per inserire le causali di supporto di un insieme di studenti, riferite ad uno specifico anno accademico, in modo automatico, si può utilizzare un file di flusso (che rappresenta un elenco di studenti contenti le informazioni delle causali/descrizioni interventi di supporto) in un formato di tipo CSV/TXT, che andrà preparato dall’Ateneo, come da seguente tracciato:

• MATRICOLA  => indicare il numero di matricola dello studente, esempio ‘1672-6422’;
• STU_ID  => è l’identificativo interno del sistema che identifica l’intera carriera dello studente, chiave in tutte le tabella fondamentali; se l’Ateneo ha accesso alla base dati, lo può agevolmente ricavare per ogni studente. Altrimenti può essere lasciato in bianco: qualora il numero di matricola non identifichi univocamente un’intera carriera, andranno OBBLIGATORIAMENTE valorizzati i campi COD_CDS, AA_ORD_ID, COD_PDS;
• AA_ID => è l’anno accademico dell’iscrizione a cui far riferire il supporto elargito (si ricordi che ogni file processerà un solo anno accademico);
• DATA_SUPP => di default vi chiediamo di non valorizzarla; nel caso in cui uno studente, nel passare da un’iscrizione ad un’altra muti il suo supporto, la data dovrà essere esclusivamente quella dell’iscrizione reale di riferimento; in caso in cui si inserisse una data non referente ad un’iscrizione reale, il dato non verrà processato;
• DES_INT_SUPP_COD => è il codice della causale di supporto/descrizione intervento di supporto, il cui elenco è presente nel dat di riferimento;
• COD_CDS => è il codice del corso di studio, da valorizzare solo se non siete in grado di risalire allo STU_ID;
• AA_ORD_ID => è l’anno accademico di ordinamento, da valorizzare solo se non siete in grado di risalire allo STU_ID;
• COD_PDS => è il codice del percorso di studio, da valorizzare solo se non siete in grado di risalire allo STU_ID;
• NOTA =>  Note in coda ai file inerenti i “Flussi Contributivi ANS” al fine di permettere di indicare le motivazioni generiche del supporto erogato (non obbligatorio)
• AA_FINANZIARIO => Esercizio finanziario di assegnazione del fondo (non obbligatorio)

Lo studente con N interventi di supporto, andrà riportato su N righe, ciascuna portatrice di un intervento.

I campi obbligatori sono MATRICOLA, AA_ID, DES_INT_SUPP_COD. Qualora il numero di matricola non identifichi univocamente un’intera carriera va popolato anche lo STU_ID oppure  i campi COD_CDS, AA_ORD_ID, COD_PDS.

Il file dovrà avere le seguenti specifiche:

• versione TXT del File di Flusso  (es. Flusso_2020.txt): la riga di intestazione dovrà essere

MATRICOLA;STU_ID;AA_ID;DATA_SUPP;DES_INT_SUPP_COD;COD_CDS;AA_ORD_ID;COD_PDS;NOTA;AA_FINANZIARIO

• versione CSV del File di Flusso  (es. Flusso_2020.csv): la riga di intestazione dovrà essere nella forma

ATTENZIONE! consigliamo di gestirvi degli elenchi Excel (xls, xlsx) e, una volta fissati, generare direttamente da questi il file CSV. Sconsigliamo la correzione del file CSV direttamente con Excel, perché il programma può modificare i campi alfanumerici in numerici (esempio matricola 003 –> diverebbe 3!).
Invece con un editor di testo, non incorrerete in alcun rischio.

Caso particolare, esempio:

lo studente MARIO ROSSI ha 2 eventi di carriera (IA e PC) ed è elargito un intervento di supporto solo su un tratto della carriera (un contributo CT sul corso di arrivo) ==> nel file dei flussi bisognerà specificare la data di supporto di CT, altrimenti il supporto sarà considerato valido su entrambi gli eventi

La maschera FLUSSI CONTRIBUTIVI ANS si compone di tre sezioni:

1) Un radio button iniziale, per scegliere l’operazione: 

a)    Visualizza  per visualizzare il dettaglio per un criterio di ricerca da impostare (Anno Accademico –obbligatorio- e Causale Supporto –opzionale-).

b)    Acquisisci file di flusso  per incamerare un file, con criteri da impostare, in modalità di sovrascrittura totale del dato o di accodamento.

c)    Acquisisci da query  che consente l'attribuzione/inserimento di causali di supporto in maniera automatica, secondo alcune query presenti in Elaborazioni query.

2) Una sezione di interrogazione per anno accademico (obbligatorio) e tipo causale di supporto (opzionale). Nel caso b (Acquisisci), si attiva inoltre una sezione per incamerare un file txt/csv, specificando una tra le due modalità Modalità Totale (sovrascrittura totale) e Modalità incrementale (accodamento).

3) Una sezione finale di riepilogo dove si elencano le posizioni degli studenti; vi è un tasto Esporta per permettere di riprodurre un file Excel come estrazione del dato.

FASE DI ACQUISIZIONE da FILE TOTALE /INCREMENTALE

Una volta preparato il file di flusso, selezionando l’anno accademico dalla maschera FLUSSI CONTRIBUTIVI ANS, partirà l’acquisizione: verrà chiesto se si intendono sovrascrivere tutti i dati pre-esistenti o si intende effettuare un accodamento dei dati; al termine del processo, il file di log elencherà esattamente le righe che sono state scartate, dandone anche un’interpretazione.
Se si risponde SI alla domanda di sovrascrivere, vengono cancellati tutti gli interventi di supporto per l’anno selezionato (ed eventualmente per la causale) nella maschera e poi vengono reinseriti in tabella secondo il contenuto del file.
Se si seleziona ad esempio 2020 e causale ME, rispondendo SI il sistema cancella gli interventi di supporto presenti con anno 2020 e causale ME e vengono reinseriti con quelli contenuti nel file che rispettano questi criteri.
Se non si valorizza la causale, vengono cancellati tutti quelli dell’anno 2020 e reinseriti prendendo quelli contenuti nel file che rispettano questo criterio ovvero hanno AA_ID= 2020.

La modalità di lavoro che si ottiene rispondendo SI alla domanda permette di cancellare tutti i dati (del filtro specificato in maschera) prima di reinserirli ed è utile quando a causa di errori nel file che è stato importato in precedenza, si voglia eliminare tutto per poi reimportare il file corretto.
Il contenuto del file viene letto in un secondo momento, per l'acquisizione.
Questo è, ad esempio, l'unica modalità di lavoro che consente di eliminare i dati di uno studente errato che non doveva essere caricato, perché non ci sarebbe altrimenti modo per farlo.

Quindi le due attuali modalità sono per sovrascrittura totale (secondo i filtri impostati a maschera) e per accodamento (secondo i filtri impostati a maschera).

Per lavorare a logica incrementale acquisendo un pò di studenti per volta in differenti file, basta usare l'accodamento rispondendo NO alla domanda. Se il fine è quello di lavorare a logica incrementale acquisendo un pò di studenti per volta in differenti file, usate l'accodamento.

Per aggiornare singole posizioni, è possibile farlo direttamente da RIepilogo Carriera ANS --> Tasto € Riepilogo situazione contributiva ANS. Infatti una volta che si sarà incamerato il file, verrà popolato il nuovo campo, visibile da RIEPILOGO CARRIERA ANS>Iscrizioni OFF.F.>Riepilogo Situazione Contributiva ANS

Al caricamento del file scattano i seguenti controlli:

• Il campo AA_FINANZIARIO può essere NULL o deve essere a 4 cifre. In caso di fallimento la riga non viene caricata e viene data comunicazione sul file di log.
• Il campo matricola è obbligatorio.
• L’intestazione la riga di intestazione dovrà essere nella forma MATRICOLA;STU_ID;AA_ID;DATA_SUPP;DES_INT_SUPP_COD;COD_CDS;AA_ORD_ID;COD_PDS;NOTA;AA_ FINANZIARIO con flessibilità sulla presenza del ';' finale nella stringa che può esserci oppure no. Il fallimento della composizione porta al fallimento dell'operazione con relativa scrittura sul file di log.
• E' presente anche un controllo sul numero di campi della singola linea basato sul numero di ';' separatori. In caso di controllo fallito la singola linea non viene caricata e ne viene data comunicazione sul file di log.
• Nel caso esistano più righe con i medesimo dati (STU_ID, AA_ID, DATA_SUPP, DES_INT_SUPP_COD), viene lasciata solo la prima
• Nel caso esistano più righe con i medesimo dati (STU_ID, AA_ID, DES_INT_SUPP_COD) e diverse DATA_SUPP, sono eliminate le righe con DATA_SUPP che non esiste nelle date delle iscrizioni reali dello STU_ID per l’anno accademico AA_ID
• Al termine del processo, viene effettuato un inserimento nella tabella P15_ELABORAZIONI con codice ‘FLUSSO’.

FASE DI ACQUISIZIONE da QUERY TOTALE /INCREMENTALE

E' possibile impostare delle query nella maschera Elaborazioni che forniranno l'elenco degli studenti e relativi interventi di supporto da inserire. La query dovrà avere codice LIKE 'ANS_FQ%'

L'acquisizione verifica che la query restituisca almeno le seguenti colonne:

• STU_ID
• AA_ID
• DATA_SUPP (può essere nulla)
• DES_INT_SUPP_COD
• NOTA (può essere nulla)
• AA_FINANZIARIO (può essere nullo)

in caso contrario emette un messaggio applicativo “Errore nel formato della query”.

Inoltre vale quanto segue:

• Per ogni riga recuperata, se la modalità è Totale (sovrascrittura) si cancellano le righe già caricate e presenti in Esse3 per quello stu_id, aa_id, des_int_supp_cod e si inseriscono in Esse3 a seguire i dati presenti nel result set della query.
• Se la modalità è Incrementale (accodamento) si inseriscono i dati in Esse3 presenti nel result set della query.
• Al termine del processo, viene effettuato un inserimento nella tabella P15_ELABORAZIONI con codice ‘QUERY e, nel campo NOTA viene inserito il codice della query usata. Se è un accodamento si imposta Tipo Elaborazione =N, se è una sovrascrittura Tipo Elaborazione='R'.