Codice sorgente Wiki di Gestione Carico Tabella Base

Ultima modifica di Paolo Bruno Angori il 2020/03/05 17:08
Nascondi i numeri di riga
  1: |(% style="width:677px" %)[[image:1583392518688-556.png]]|(% style="width:799px" %)(((
  2:  
  3: 
  4: {{box title="**Sommario**"}}
  5: {{toc /}}
  6: {{/box}}
  7: )))
  8: 
  9: La registrazione di un campione non può essere fatta nel sistema se prima non è stato opportunamente classificato e inquadrato nella TABELLA BASE che andremo di seguito a descrivere.
 10: 
 11: La struttura informatica del sistema prevede che vi siano 7 tabelle di dati univoci che riguardano:
 12: 
 13: 1. **Tipo Branca**: rappresenta generalmente il piano di campionamento o il settore di attività di campionamento a cui si riferisce la classificazione;
 14: 1. **Tipo Sottobranca**: costituisce un sotto livello della branca che consente di ripartire la pianificazioni in settori o sottoinsiemi definiti;
 15: 1. **Tipo luogo**: classifica le tipologie di luogo di campionamento in cui il prelievo va effettuato (p.es. Azienda agricola, laboratorio, stabilimento di produzione ecc...)
 16: 1. **Tipo Specie**: classifica le specie animali o vegetali a cui è condizionato il campione quando necessario;
 17: 1. **Tipo Quesito**: classifica il macro settore delle sostanze da ricercare richieste al laboratorio di analisi (p.es. Metalli pesanti, PROVE MIRATE MICROBIOLOGIA, Caratteri fisico chimici, ecc...)
 18: 1. **Tipo di prova**: classifica le tipologie di prove specifiche che devono essere eseguite nell'ambito del quesito specificato ( p.es. Salmonelle, cadmio, Escherichia coli, Radionuclidi (Pool) ecc.....)
 19: 1. **Tipo Materiale**: classifica le tipologie di materiali che possono essere campionati utilizzando possibilmente sistemi di classificazione internazionali;
 20: 
 21: Le 7 voci sopra riportate si ricombinano all'interno della **TABELLA BASE**, a seconda della pianificazione o della corretta impostazione di un campionamento previsto. Solo se la specifica combinazione è stata preventivamente prevista nella tabella base sarà possibile registrare il campione nel sistema.
 22: 
 23: Pertanto in tabella base sono presenti migliaia di combinazioni di questi elementi per guidare la registrazione del campionamento ed impedire la registrazioni che non hanno una correttezza scientifica o di laboratorio (prove accreditate).
 24: 
 25: 
 26: = Tabella Base =
 27: 
 28: |(% style="width:833px" %)[[image:1583392899997-284.png]]|(% style="width:643px" %)(((
 29: La griglia di cui all'immagine a fianco elenca tutte le combinazioni di valori costruite appositamente per governare la registrazione di un campione in modo che questi abbia una reale corrispondenza logica e scientifica.
 30: 
 31: La manutenzione dei dati che sono presenti nella tabella base è quindi elevata e prevede che questa possa essere effettuata attraverso due modalità:
 32: 
 33: 1. **Diretta**, attraverso l'interfaccia di registrazione che si aziona con il pulsante [[image:1583393119263-744.png]] che si trova in alto a destra nella finestra rappresentata a fianco;
 34: 1. **Indiretta**, attraverso lo scarico off-line di dati della tabella stessa in formato .CSV utilizzando il pulsante [[image:1583393225727-473.png]] posto in alto a destra della finestra rappresentata di fianco.
 35: 
 36: (% class="box infomessage" %)
 37: (((
 38: **ATTENZIONE!! Lo scarico in formato Excell produce un file identico ai contenuti delle griglia mostrata. Lo scarico in formato .CSV produce un tracciato di dati leggermente diverso dalla griglia che è stato appositamente studiato per poi effettuare il carico che consenta automaticamente di aggiornare la tabella base.**
 39: )))
 40: )))
 41: 
 42: == Gestione diretta della tabella base ==
 43: 
 44: |(% style="width:533px" %)(((
 45: [[image:1583394060612-753.png]]
 46: 
 47: 
 48: 
 49: Una volta completata la registrazione di tutte le voci previste nella schermata di cui sopra  procedere al salvataggio dei dati utilizzando:
 50: 
 51: * Il pulsante [[image:1583401045887-561.png]] quando si intende salvare e poi chiudere la registrazione di nuove combinazioni;
 52: * Il pulsante [[image:1583401094531-809.png]] quando si vuole salvare e riaprire una nuova registrazione che nei contenuti è molto simile a quella appena registrata. Il sistema praticamente ripropone una scheda identica, completamente compilata con le stesse informazioni che va cambiata nella parti che variano rispetto al record appena registrato. Il sistema non consente il salvataggio di due record perfettamente identici.
 53: 
 54: [[image:1583401211195-878.png]]
 55: )))|(% style="width:943px" %)(((
 56: La maschera di inserimento dati nella tabella base di cui all'immagine a fianco, si attiva con il pulsante [[image:1583393119263-744.png]].
 57: 
 58: Per ogni campo previsto ai fini della costruzione del record di combinazione dei valori vi è una tendina che mostra i valori previsti nella varie tabelle di codifica dei dati: Branca, Sottobranca, luogo, Specie ecc...
 59: 
 60: |(% style="width:477px" %)[[image:1583394412285-109.png]]|(% style="width:448px" %)(((
 61: La selezione del materiale è un pò particolare: prevede infatti che si selezioni preliminarmente il tipo nella tendina riportata come illustrato a fianco.
 62: 
 63: Una volta selezionato il tipo utilizzare il pulsante [[image:1583394508773-816.png]] per aprire il sistema di codifica prescelto
 64: )))
 65: |(% style="width:477px" %)(((
 66: [[image:1583394579940-990.png]]
 67: 
 68: Una volta individuata la voce di interesse cliccare sulla casella di spunta e utilizzare il pulsante [[image:1583394863480-483.png]]
 69: )))|(% style="width:448px" %)(((
 70: Si apre l'immagine come nell'illustrazione a fianco che mostra i materiali in formato gerarchico. Nell'esempio stiamo esplorando la classificazione foodex2.
 71: 
 72: Aprendo le voci con il pulsante [[image:1583394674094-944.png]] posto nell'alberatura sarà possibile navigare nel sistema di classificazione e scegliere la voce di interesse
 73: 
 74: [[image:1583394748628-295.png]]
 75: )))
 76: 
 77: (% style="text-align:center" %)
 78: [[image:1583394947349-429.png]]
 79: 
 80: (% class="box infomessage" %)
 81: (((
 82: **ATTENZIONE!! Come nell'esempio sopra riportato è possibile selezionare e importare nel sistema una qualsiasi voce a qualsiasi livello gerarchico. Per impostazione strutturata nel sistema l'importazione di un "padre" che ha sotto di lui una serie anche variegata e articolata di "figli" abilita tutte le voci figlie alla registrazione nella combinazione che si sta registrando. Questo semplifica molto la costruzione delle combinazioni della tabella base: nell'esempio sopra riportato abbiamo selezionato la voce [[image:1583395239506-662.png]]. Questo comporta che l'operatore che registra il campione potrà utilizzare a sua discrezione tutte le tipologie sotto riportate nell'albero (Biscotti al burro, biscotti farina di farro ecc.....)**
 83: )))
 84: )))
 85: 
 86: == Gestione Indiretta della tabella base ==
 87: 
 88: |(% style="width:847px" %)[[image:1583403427199-465.png]]|(% style="width:629px" %)(((
 89: La gestione indiretta dei dati dalla tabella base prevede lo scarico degli stessi su un file .CSV sul quale è possibile poi lavorare con gli strumenti di gestione dei fogli di calcolo e poi ricaricare il file sul sistema con le sole modifiche da effettuare per una gestione automatica di lettura e inserimento dei dati.
 90: 
 91: |(% style="width:148px" %)[[image:1583393225727-473.png]]|(% style="width:463px" %)(((
 92: Lo scarico del file viene effettuato utilizzando il pulsante in alto a destra che consente di produrre il file in formato .CSV.
 93: 
 94: **Si suggerisce di impostare i filtri a scomparsa posti sulla sinistra per scaricare solo la branca su cui si intende lavorare, scaricando tutti i record di una intera branca con  le righe attive( senza data di fine) che concluse (con data di fine).**
 95: )))
 96: 
 97: Il file scaricato va aperto con strumenti di gestione dei fogli di calcolo come di seguito descritti.
 98: 
 99: I passaggi essenziali sono:
100: 
101: 1. Aprire il file .CSV
102: 1. Salvarlo in formato excell
103: 1. Impostare ordinamento e filtri in maniera adeguata per gestire le combinazioni;
104: 1. Confrontare le tabelle di programmazione del piano con i dati presenti nel file e conseguentemente:
105: 11. **Chiudere **con data fine le righe che non devono più essere rese disponibili;
106: 11. **Inserire **nuove righe con le combinazioni di valori non presenti tra quelle disponibili;
107: 1. Salvare in formato .CSV su due file separati le righe da chiudere e quelle da aggiungere;
108: 1. Procedere al caricamento dei file nel sistema per aggiornare la tabella base.
109: )))
110: 
111: === Caratteristiche  e gestione del file .CSV ===
112: 
113: |(% style="width:892px" %)(((
114: [[image:1583403597365-664.png]]
115: 
116: 
117: S suggerisce di impostare fin da subito all'apertura il **filtro **sulla prima riga e di **salvare il file in formato .XLS o .XLSX i**n modo che le impostazioni dei filtri rimangano e anche altre particolarità che vedremo nel corso della lavorazione del file.
118: 
119: Soltanto alla fine della elaborazione ritrasformeremo solo le righe necessarie in formato .CSV per effettuare l'import su SISPC.
120: )))|(% style="width:584px" %)(((
121: Come da immagine riportata a fianco il file scaricato è particolare: contiene per ogni dato sia la colonna con il codice che la colonna della descrizione del valore codificato. I valori dei codici sono contenuti all'interno di carattere "#" per consentire al sistema in fase di carico un riconoscimento particolare.
122: 
123: (% style="text-align:center" %)
124: [[image:1583404495618-495.png]]
125: 
126: Questo vale per tutti i dati codificati presenti nella riga che sono a seguire:
127: 
128: * Ricerca ovvero sottobranca
129: * Luogo
130: * Specie
131: * Materiale
132: * Quesito
133: * Prova
134: 
135: Autore è la denominazione del soggetto che ha inserito il record nel sistema.
136: 
137: Data Inizio e Data fine definiscono il periodo di validità del record e distingue quindi quelli attivi da quelli chiusi
138: 
139: (% style="text-align:center" %)
140: [[image:1583404730916-123.png]]
141: 
142:  
143: )))
144: |(% style="width:892px" %)(((
145: [[image:1583405017346-625.png]]
146: 
147: 
148: Nell'ordinamento sopra esposto valutare se ordinare anche per **Specie **se significativo per una facile individuazione dei dati da verificare.
149: 
150: Per procedere in maniera ordinata si suggerisce inoltre di impostare anche il **filtro per Ricerca (Sottobranca)** in modo da analizzare una sottobranca per volta.
151: )))|(% style="width:584px" %)(((
152: A seconda del software disponibile per gestire il file trasformato in formato Excell, si suggerisce di ordinare il file con scelta multipla dei valori di ordinamento.
153: 
154: Si ritiene utile ordinare per:
155: 
156: * Quesito
157: * Prova
158: * Materiale 
159: * Luogo
160: 
161: |(% style="width:309px" %)[[image:1583405339932-353.png]]|(% style="width:257px" %)(((
162: In questo modo sarà più facile procedere in maniera ordinata al confronto con il file di programmazione che è stato eventualmente fornito per verificare che le combinazioni presenti in tabella base siano coerenti con la programmazione prevista.
163: 
164: Una volta ordinato l'intero file si suggerisce di mantenere visibili solo le righe con **Data fine vuota agendo sul filtro impostato sulla prima riga.**
165: 
166: Qualora non si riscontri la presenza di una nuova combinazione potremo comunque andarla sempre a cercare sulle righe "chiuse" e riaprire queste opportunamente come più avanti spiegato nel dettaglio.
167: )))
168: 
169:  
170: )))
171: |(% style="width:892px" %)(((
172: [[image:1583406946580-595.png]]
173: 
174: 
175: Si suggerisce di contrassegnare le righe corrette che si intendono mantenere con un colore di sfondo (P.es. verde) e quelle da eliminare con un altro colore (p.es. rosso)
176: 
177: [[image:1583407105270-410.png]]
178: 
179: 
180: Nelle righe contrassegnate in **Rosso **dovrà essere compilata la **data fine. Solo l'inserimento di una data fine in maniera opportuna consentirà di chiudere quelle combinazioni all'interno del sistema.**
181: 
182: (% class="box warningmessage" %)
183: (((
184: **Attenzione!! Il filtro impostato nel CAMPO PROVA a volte va impostato nel campo QUESITO quando la ricerca prevista è più generica e comprende un'insieme ampio di prove che rientrano all'interno di uno stesso quesito diagnostico non puntualmente definito come nell'immagine di esempio riportata di fianco.**
185: )))
186: 
187: (% class="box infomessage" %)
188: (((
189: E' possibile che una riga di programmazione diventi anche più di una riga nel nostro file di configurazione della tabella base quando variano per la stessa ricerca il tipo di materiale, oppure le specie a cui si applica il controllo ecc.... Le combinazioni possibili previste vanno generate tutte.
190: )))
191: )))|(% style="width:584px" %)(((
192: |(% style="width:245px" %)[[image:1583406835737-151.png||height="299" width="219"]]|(% style="width:321px" %)(((
193: Una volta ordinato il file si suggerisce di procedere ricercando per tipologia di prova o quesito. Se, ad esempio, nel file di programmazione è prevista la ricerca dell' **arsenico **aprire il filtro in testa sulla tipologia di prova e ricercare tutte le righe che contengono il termine "Arsenico".
194: 
195: Applicato il filtro rimarranno solo le righe di interesse.
196: )))
197: 
198: [[image:1583407999456-740.png]]
199: 
200:  
201: )))
202: 
203: === Inserimento di nuove righe di combinazione ===
204: 
205: |(% style="width:660px" %)[[image:1583411989154-603.png]]|(% style="width:816px" %)Si suggerisce, nel momento in cui si cominciano a gestire nuove righe, di creare nello stesso file due nuovi fogli di lavoro nei quali andremo a copiare le righe da **aprire **e le righe da **chiudere **sulla base delle attività di verifica rispetto alla programmazione.
206: |(% style="width:660px" %)[[image:1583409292349-924.png]]|(% style="width:816px" %)(((
207: Qualora una combinazione di valori richiesti in programmazione non sia presente tra le soluzioni disponibili va aggiunta.
208: 
209: Per prima cosa si suggerisce di verificare che la "nuova" combinazione non sia già presente tra quelle che sono registrate con data fine e che sono presenti nel file scaricato. Quindi rimuovere il filtro che nasconde le righe con data fine mantenendo gli altri filtri attivi, in particolare quello sulla prova o sul quesito, in modo da scoprire se esistono già righe di nostro interesse tra quelle "chiuse".
210: 
211: Se la combinazione che ci necessita è presente procedere in questo modo:
212: 
213: 1. Copiare interamente le righe di interesse in fondo al foglio di calcolo o, meglio ancora su un altro foglio in cui andiamo ad inserire le righe da aggiungere per averne un elenco completo
214: 1. Eliminare la data fine dalle righe copiate di cui al punto precedente.
215: 
216: Se si copiano su un nuovo foglio ricordarsi di inserire nella prima riga del nuovo foglio la riga con le intestazioni delle colonne.
217: 
218: Aggiornare la data inizio con la data corrente o inizio di validità della nuova combinazione. (p.es. inizio anno)
219: )))(((
220: [[image:1583411646650-321.png]]
221: 
222:  
223: )))
224: |(% style="width:660px" %)[[image:1583418041536-342.png]]|(% style="width:816px" %)(((
225: (% style="text-align:center" %)
226: [[image:1583404495618-495.png]]
227: 
228: Nel caso in cui si debbano inserire righe completamente nuove è ovviamente possibile comporle completamente inserendo con le caratteristiche delle varie righe e colonne tutti i valori esatti come riportato dei sistemi di classificazione compilando per ogni valore sia il codice ID nella voce tra segni di # e la relativa descrizione.
229: 
230: **La compilazione deve essere esattamente quella presente nel sistema**: anche un piccolo errore su uno spazio, un carattere o altro comporta sempre lo scarto dell'intero record.
231: 
232: Si consiglia pertanto di copiare una riga che contiene già buona parte dei dati di interesse e di agire in modifica dei valori riportati inserendoli con il copia e incolla o da altre righe che contengono quel valore o dalla maschera di SISPC che mostra il valore della tabella di codifica.
233: 
234: Se inseriamo ad esempio il tipo quesito "ANTIMICROBICI E ANTIPARASSITARI" dobbiamo esattamente inserirlo così:
235: 
236: (% style="text-align:center" %)
237: [[image:1583418115532-976.png]]
238: 
239: Il sistema considera anche la differenza tra maiuscole e minuscoli. Quindi è bene utilizzare sempre il copia e incolla.
240: )))
241: 
242: 
243: == Export del file in formato .CSV e carico dei dati ==
244: 
245: |(% style="width:626px" %)(((
246:  
247: 
248: [[image:1583420441697-946.png]]
249: 
250: 
251: 
252: [[image:1583420702630-850.png]]
253: )))|(% style="width:850px" %)(((
254: Una volta competa la verifica e definiti contenuti dei due fogli di calcolo contenenti le righe nuove da inserire e quelle da chiudere si procede all'esportazione dei due file separati per le operazioni di aggiornamento.
255: 
256: I file vanno esportati in formato CSV quindi procedere ad effettuare l'operazione di Salva con nome sul foglio di calcolo di interesse 
257: 
258: (% style="text-align:center" %)
259: [[image:1583420631104-670.png]]
260: 
261: Il  sistema solitamente avverte che il formato .CSV non supporta i fogli multipli e che se si procede verrà salvato il foglio di lavoro attivo. Se ci siamo posizionati nel foglio giusto possiamo salvare il file per averlo disponibile nella cartella selezionata.
262: 
263: **Stessa identica operazione va fatta anche per estrarre il file che contiene i record da chiudere.**
264: 
265: **Ricordarsi di aver compilato su tutte le righe la data di chiusura, altrimenti in caricamento non avrà nessun effetto.**
266: 
267:  
268: )))
269: |(% style="width:626px" %)(((
270: [[image:1583420997188-194.png]]
271: 
272: Cliccando con il pulsante destro su una qualsiasi riga dell'elenco riportato a fianco si apre un menù contestuale che consente di gestire il file caricato secondo le seguenti funzioni:
273: 
274: [[image:1583421244453-712.png]]
275: )))|(% style="width:850px" %)(((
276: === Carico dei dati ===
277: 
278: Per procedere al carico dei dati ai fini dell'aggiornamento delle tabelle utilizzare la funzione [[image:1583421046451-981.png]].
279: 
280: L'utilizzo di questa funzione apre la maschera sotto riportata che contiene l'elenco di tutti i file che sono stati caricati nel tempo.
281: 
282: (% style="text-align:center" %)
283: [[image:1583421105005-249.png]]
284: 
285:  
286: )))
287: |(% style="width:626px" %)(((
288: [[image:1583421142072-787.png]]
289: 
290: Selezionato il file e cliccato sul pulsante Apri il sistema carica il file ed esegue un controllo formale sul contenuto dello stesso per verificare che sia coerente con quanto previsto nel tracciato di import. Il sistema risponde immediatamente a video e se tutto è regolare avremo una risposta di questo genere.
291: 
292: [[image:1583421576465-491.png]]
293: )))|(% style="width:850px" %)(((
294: Utilizzando il pulsante [[image:1583421291524-377.png]] si apre la maschera di carico per gestire il file che abbiamo predisposto, sia che abbia righe nuove da inserire o contenga righe che hanno la data di chiusura compilata.
295: 
296: Con il pulsante [[image:1583421366189-452.png]] si apre la finestra di dialogo che consente di selezionare il file presente nel nostro computer e che vogliamo caricare nel sistema. 
297: 
298: (% style="text-align:center" %)
299: [[image:1583421428210-821.png]]
300: 
301: Se il sistema rileva degli **errori **mostra una anteprima degli stessi nella parte **Report **riportata qui a fianco e soprattutto rende disponibile con il pulsante [[image:1583421666454-431.png]] lo scarico di un file che contiene il diagnostico degli errori rilavati record per record sulla base del file caricato. **Nel caso di errore NON SALVARE e chiudere la finestra. Va corretto gli errori e ritentato successivamente il carico.**
302: )))
303: |(% style="width:626px" %)(((
304:  
305: 
306: (% style="text-align:center" %)
307: [[image:1583421925804-584.png]]
308: 
309: (% class="box warningmessage" %)
310: (((
311: **NOTA BENE.
312: Nel caso in cui tra le righe inserite come nuove ve ne sia una o più di una la cui combinazione è perfettamente identica ad una riga già presente in tabella base ma CHIUSA, questa riga NON viene duplicata ma il sistema cancella la data fine e rende la combinazione disponibile per essere utilizzata (riapertura automatica di un record in tabella base. **
313: )))
314: )))|(% style="width:850px" %)(((
315: Qualora non vi siano errori cliccare sul pulsante [[image:1583421822621-709.png]].
316: 
317: A questo punto il sistema avverte che il file è stato salvato e chiede se si vuole procedere all'aggiornamento della tabella base.
318: 
319: (% style="text-align:center" %)
320: [[image:1583421893440-917.png]]
321: 
322: Se si clicca su SI il sistema aggiorna la tabella base e  risponde con il resoconto delle attività effettuate in tabella base come da immagine riportata a fianco.
323: 
324: **La stessa operazione deve essere eseguita con le stesse modalità anche per le righe con la chiusura di voci attività alla data inserita in ogni riga.**
325: )))
326: 
327: 
328: 
329: 
330: 
331: