Programma dbOAB
Manuale d'uso
In costruzione.
Prefazione
Questo programma serve per la consultazione e gestione di database
relazionali .
In fase di progetto e' stato deciso di utilizzare il database postgreSQL
come riferimento per lo sviluppo del programma.
Per questo motivo il programma e' compatibile per tutte le sue
funzioni solo con questo DB, nel manuale e' specificato quando una funzione
non e' supportata per gli altri.
Il programma al momento include i driver per il database postgreSQL
e per MySql , se richiesto, si possono aggiungere facilmente i driver
per quei database che supportano il protocollo JDBC (tutti i principali
database).
Aggiornamenti
19/09/2001
Aggiunte funzioni
fra tabella e casella del comando sql.
15/10/2001
Aggiunta la gestione dei bookmark,
aggiunto il menu dei comandi sql piu' utilizzati,
aggiunta la funzione zoom alla visualizzazione delle immagini,
risolto bug: il programma in modifica non segalava che la prima colonna
non era valida come chiave d'accesso alla tabella.
26/10/2001
Aggiunta la grafica 2D per la visualizzazione di semplici grafici xy
utilizzando le colonne delle tabelle.
03/12/2001
Aggiunta la possibilta' di aggiornare le tabelle anche se si sta utilizzando
una view in consultazione, e' il programma che si preoccupa di risolvere
la relazione.
18/12/2001
Risolti vari bug,
aggiunta la funzione che interpreta la stringa SQL contenuta
in una tabella e la manda in esecuzione,
aggiunto il bottone examples automaticamente
lista il contenuto della tabella examples,
aggiunto il copy & paste per
le celle della tabella quando sono in modalita' editor.
04/02/2002
Iniziato a scrivere il manuale d'uso,
aggiunta la funzione di visualizzazione delle immagini direttamente
nella tabella mediante il bottone load images,
corretti vari bug.
19/02/2002
Migliorata la funzione di riconoscimento di un
record. Adesso in cancellazione e modifica utilizza tutti i dati disponibili
in tabella per individuare il record.
Menu della window principale.
File
Print
--- ancora da aggiungere.
Exit
--- uscita dal programma.
Database
select
database --- selezione del database al quale
collegarsi.
JukeBox
--- apre la window JukeBox per l'esecuzioni di brani MP3
Edit
insert
record --- inserimento di
un record nella tabella corrente. (solo postrgres)
remove
record --- rimozione del record selezionato
(chiede conferma) (solo postgres)
n.b. per eseguire questi comandi e' richiesto
il privilegio di update per la tabella in questione.
Options
Max column size
--- imposta il numero massimo di caratteri visualizzati per colonna.
enable color
--- abilita il colore per le colonne di tipo numerico.
Info
Program --- informazioni
sul programma.
Manual ---
visualizza questo manuale.
Utilizzo del tasto destro del mouse
Puntando con il tasto destro del mouse su alcuni
componenti visual del programma e' possibile attivare dei Popup
menu che fornisco delle funzioni supplementari .
Alla casella di inserimento della query nella
tool bar in alto e' associato un menu con le seguenti funzioni:
Clear --- pulizia
area testo
Copy --- copia il
contenuto dell'area testo nella clipboard
Paste --- scrive
il contenuto della clipboard nell'area testo dove punta il cursore
bookmarks
--- scrive il bookmark selezionato nell'area testo
edit bookmarks
--- aggiunta e rimozione di bookmark dalla lista
sql keywords
--- visualizza alcuni comandi sql che selezionati vengono scritti dell'area
testo
Alla tabella risultato di una query e' associato
un menu' con le seguenti funzioni:
Copy:
copia il contenuto della cella attualmente selezionata
nella clipboard.
Execute:
esegue il comando SQL contenuto nella cella selezionata
della tabella.
La gestione del comando avviene come se fosse
stato scritto manualmente.
n.b: la funzioneExecute
ha un interessante applicazione, si possono
creare tabelle esclusivamente contenenti comandi SQL specifici
Ad ogni cella della tabella quando e' in modalita'
modifica, cioe', dopo che e' stata selezionata con un doppio click del
mouse, e' associato un menu con le seguenti funzioni:
Copy
--- copia la parte di testo selezionata con il mouse nella clipboard
Paste
--- inserisce il contenuto della clipboard nell'area testo dove punta
il cursore
Replace --- come per paste ma sostituisce
completamente il contenuto della cella
Toolbar delle funzioni
Nella parte bassa del window principale e' visibile una toolbar con aluni
bottoni che richiamano alcune funzioni di
frequente utilizzo.
n.b funzionano solo in il DB postgreSQL.
show tabels:
mostra le tabelle e le view presenti nel database al quale si e' collegati
in quel monemento.
show views:
mostra solo le view ma evidenzia anche la colonna description che puo'
essere utilizzata con la funzione execute (popup menu attivato con il tasto
destro del mouse).
db info:
mostra alcune informazioni sul server al quale si e' collegati.
export data:
attiva la window che permette di salvare i dati della tabella visualizzata
in un file.
examples:
visualizza la tabella examples (se esiste in quel database) che contiene
alcuni esempi di comandi SQL con spiegazione.
Graphics:
visualizza un tool grafico che permette di ottenere dei grafici X/Y
utilizzando i dati in tabella.
Load Images:
cerca nella tabella corrente eventuali celle contenete dei data jpg
o gif e carica la corrispondente immagine nella cella.
Tasto stop
Questo tasto server per interropere una query in corso o il download delle
immagini. Con postgreSql non da una risposta immediata ed a volte non riesce
a bloccare la query. Questo problema sembra dovuto al driver e non a questo
programma perche' con MySql funziona correttamente.
Interprete dei dati BLOB
In certe tabelle compaiono colonne di icone di colore blue o rosse. Esse
segnalano che il database in quella colonna contiene dei dati BLOB cioe:
immagini,dati MP3, html e fits. Cliccando con il mouse su uno dei punti
blue il programma riconosce il contenuto della cella ed esegue il tool
necessario per trattarlo.
Per dati jpg o gif il programma utilizza una window apposita:
viewer, per i dati postscript utilizza: ghostview,
e per i dati html e testo normale utilizza una window in grado di interpretare
l'html.
Per i vari formati musicali utilizza la window Juke Box.
Per i dati jpg e gif il programma e' in grado, a richiesta (bottone
Load
Images), di visualizzarle direttamente nella
tabella.
n.b.: tutte queste funzioni sono implementate
solo per postgreSQL.
