Estrazione dati
Questa funzione permette di estrarre i dati da una o più tabelle di un dossier X3, creando dei file che contengono la descrizione della tabella e i dati memorizzati, in una sotto-directory del dossier (SVG di default). Si tratta di un'estrazione fisica (paragonabile ad un export oracle, ossia il file ha un formato che non è collegato ad un database e può essere utilizzato per trasferimenti tra database). Per ogni tabella XXX del database, sono creati da quattro a sei file:
- un file XXX.dat, che contiene i dati nel formato di un file costituito da record di lunghezza fissa.
- un file XXX.srf, che contiene la descrizione della struttura del file (in formato ascii).
- un file XXX.fde, che contiene la descrizione della struttura del file (in formato compilato utilizzabile direttamente dal motore adonix: questo file esiste anche nella directory FIL del dossier).
- un file XXX.seq, che contiene il prossimo numero di sequenza associato alla tabella. Questa informazione è importante nella misura in cui ogni tabella è associata ad un numero di sequenza che permette di creare dei numeri univoci (ciò corrisponde alla funzione adonix uniqid([abv]), dove abv è l’abbreviazione della tabella corrispondente).
- un file XXX.blb, che contiene i dati collegati ai «blobs» (immagini) o ai «clobs» (testi) memorizzati nella tabella se ne esistono.
- un file XXX.cfg, che contiene informazioni di configurazione della tabella nel database. Questo file è opzionale, la sua presenza dipende soprattutto dalle opzioni di estrazione fornite. Per ulteriori informazioni sulla struttura dei file di configurazione, si consiglia di consultare l’allegato tecnico corrispondente.
Avviso legale
Questo tipo di funzione è una funzione di sviluppo il cui utilizzo è vietato nell'ambito di una normale gestione.
Le conseguenze legali, dell'utilizzo di strumenti di sviluppo su database contenenti dati i quali la legge ne vieta la manipolazione, sono completa responsabilità del cliente. Per maggiori informazioni consultare l'allegato corrispondente.
Gestione videata
Videata di inserimento
Presentazione
All'entrata nella funzione, ci si trova in una videata di inserimento dove si definiscono i dati da estrarre e i parametri di questa estrazione.
L'atto di validare attiva la funzione. Viene creato e visualizzato un file traccia per permettere di conoscere il risultato (e gli eventuali errori di estrazione).
Chiudi
Campi
I seguenti campi sono presenti in questo folder :
Blocco numero 1
| Definisce il codice del dossier sul quale si desidera lavorare (così come è definito nella tabella dei dossier). |
| Se il dossier da cui si estraggono delle tabelle possiede un dossier di storiicizzazione, si può decidere di estrarre i dati della tabella storica (contrassegnando la casella) o della tabella del dossier di gestione (non contrassegnandola). |
| Definisce il nome della tabella da estrarre, o un modello che caratterizza il nome delle tabelle da estrarre. Se si desidera ad esempio estrarre tutte le tabelle presenti nella directory SVG, basta digitare * in questo campo. |
|
|
Blocco numero 2
| Quando questa casella è contrassegnata, il file di estensione cfg presente nella directory FIL è copiato nella directory di estrazione. Questo file contiene delle direttive di configurazione quali la dimensione degli extents. La sua struttura è descritta in un allegato. |
| Quando questa casella è contrassegnata, il file di estensione srf, che contiene degli elementi di dimensionamento della tabella, è creato tenendo conto della dimensione corrente della tabella e non della dimensione prevista a termine per la tabella (così come definita dalle variabili e dalle formule di dimensionamento in gestione di dossier). |
Chiudi
Utilizzo pratico
Limiti tecnici
Questa funzione è legata al motore adonix e non ai database standard. Di conseguenza, non deve essere utilizzata nell'ambito di una procedura abituale di salvataggio, di cui non possiede le garanzie di sicurezza nè di prestazioni. Prima di ogni utilizzo di questo tipo di funzione è vivamente consigliato un salvataggio utilizzando gli strumenti standard del database.
Fra le limitazioni di questo tipo di funzione occorre notare che, se viene lanciata su più tabelle del database, può condurre ad una immagine del database non totalmente coerente se durante l'export sono avvenuti degli aggiornamenti (contrariamente agli strumenti standard associati ai database). Se si desidera utilizzare questa funzione per estrarre una immagine coerente, occorre quindi assicurarsi che nessun altro sia connesso sul dossier durante l'estrazione.
Casi pratici di utilizzo
Se si desidera estrarre una tabella per effettuarne un salvataggio temporaneo per poterla ripristinare in caso di problema (ad esempio dopo un tentativo sfortunato di manutenzione prima del quale era stato realizzato un salvataggio cautelativo), occorre obbligatoriamente contrassegnare la casella Copia file di configurazione, e deselezionare la casella Dimensione reale in srf. Si tratta nel caso specifico del valore proposto di default.
In compenso, se si desidera estrarre i dati di tutto un database per permettere di riportarli in un altro ambiente, per esempio a fini di analisi, occorre deselezionare la casella Copia file di configurazione per non avere vincoli impossibili da rispettare durante la reintegrazione. In quel momento può essere interessante contrassegnare la casella Dimensione reale in srf. Ciò ha la conseguenza di creare un file di estensione srf dimensionato con la dimensione effettiva del dossier. E' così possibile ricaricare le tabelle di un dossier diminuendo lo spazio fisico necessario nel database. Questa opzione è vivamente consigliata se viene utilizzata una tale estrazione per riportare il dossier a fini di analisi o semplicemente di recupero di un dossier di sviluppo.
Job batch
Questa funzione può essere lanciata in batch. Il job standard DOSSVG è previsto per questo.
Messaggi di errore
Oltre ai messaggi generici, i seguenti messaggi d'errore possono apparire al momento dell'inserimento :
Dossier XXX
Errore accesso tabella AUTILIS
File inesistente
Questo messaggio di errore significa che il dossier scelto non è stato creato, o non esiste più (in ogni caso la tabella degli utenti non è stata trovata in questo dossier).
Altri messaggi di errore
All'estrazione viene creato un file traccia. Possono sopraggiungere degli errori durante l'operazione: si presentano sotto forma di una riga di errore (in rosso) nella traccia, seguita eventualmente da informazioni complementari.