Il File del Progetto: Struttura del file di Progetto: Formato XML


Il formato XML, come per il formato ini, è composto dagli elementi del progetto, dalle viste e le caratteristiche del progetto stesso. Le impostazioni di ogni oggetto vengono definite negli attributi del singolo elemento. Per semplificare la gestione, la struttura è organizzata in modo da ridurre il più possibile la nomenclatura degli elementi principali, e posizionando tutte le caratteristiche del progetto e degli oggetti negli attributi del singolo elemento. In questo modo si è cercato di ridurre le dimensioni del file, ottimizzando le funzioni di scrittura e lettura, ed evitando il più possibile i problemi relativi all'eccessivo consumo delle risorse di sistema e i crash che si verificavano nelle precedenti versioni di pgDesigner.

Tutti gli elementi sono racchiusi sotto un unico elemento: pgDesigner.

Tranne per alcune delle caratteristiche, dedicate alla parte grafica, gli oggetti del progetto si riferiscono a proprietà specifiche di PostgreSQL, per cui fare riferimento alla documentazione ufficiale per gli approfondimenti del caso.

Elemento Attributo Tipo Default Descrizione
pgDesigner   Raggruppa le caratteristiche di base del file progetto.
Version Stringa <blank> Identifica la versione del file. La versione è dipendente dalla release di pgDesigner; nelle ultime release è stata modificata la metodologia e diversificate le cassi di numerazione tra l'applicazione e i file di progetto. Dove possibile è stata mantenuta una certa compatibilità con versioni precedenti, ma questo non esclude la probabilità un vecchio progetto possa non essere letto con le nuove release di pgDesigner.
PROJECT   Raggruppa le caratteristiche di base del progetto.
Name Stringa <blank> Nome del progetto (obbligatorio).
PageFormat Stringa A4 Formato pagina di stampa.
L'impostazione viene utilizzata per la configurazione di default per le stampe, ma può essere modificata all'interno del progetto.
PageOrientation Numerico 0 Orientamento della stampa:
  • 0 = Portrait
  • 1 = Landscape

L'impostazione viene utilizzata per la configurazione di default per le stampe, ma può essere modificata all'interno del progetto.
Revision Stringa <blank> Data l'ultima modifica, nel formato: gg/mm/aaaa hh:mm:ss.
Il valore non condiziona il progetto, ma è usato solo come indicatore.
Description Stringa <blank> Descrizione del progetto.
Può contenere un descrizione sintetica del progetto.
Driver Stringa 8.2 Numero identificativo della versione di PostgreSQL.
Il valore impostato condiziona le caratteristiche del progetto, e determina il tipo di database che si vuole creare.
Author Stringa <blank> Nome autore.
Contiene il nome dell'autore del progetto.
Display Numerico 0 Numero del display corrente.
Indica il numero del display attivo.
DISPLAY   Contiene le caratteristiche di un display (o vista) del progetto.
Name Stringa <blank> Nome del display.
Description Stringa <blank> Descrizione del display.
DISPLAYOBJECT   Definisce un oggetto contenuto nel display.
Display Stringa <blank> Nome del display.
Name Stringa <blank> Nome dell'oggetto contenuto nel display.
X Numerico 0 Coordinata X dell'oggetto all'interno del display.
Y Numerico 0 Coordinata Y dell'oggetto all'interno del display.
AREA   Contiene le caratteristiche di un singolo oggetto di tipo area.
Name Stringa <blank> Nome dell'oggetto area.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
W Numerico 0 Larghezza dell'oggetto.
H Numerico 0 Altezza dell'oggetto.
Display Numerico 0 Numero display a cui l'oggetto è associato.
Color Stringa 0,0,0 Colore di sfondo dell'oggetto (formato: r,g,b).
Description Stringa <blank> Testo contenuto nell'oggetto.
Bold Logico 0 Stampa in grassetto (0=normale, 1=grassetto).
DOMAIN   Contiene le caratteristiche di un singolo oggetto di tipo dominio.
Name Stringa <blank> Nome dell'oggetto dominio.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Check Stringa <blank> La clausola specifica le integrity constraints o testa quale valore del dominio deve essere soddisfatto.
DefaultValue Stringa <blank> La clausola specifica un valore di default per le colonne del tipo di dominio.
NullValue Stringa <blank> Permette di inserire valori nulli.
Type1 Stringa <blank> Il tipo di dato del dominio.
Type2 Stringa <blank> Il tipo di dato del dominio.
Type3 Stringa <blank> Il tipo di dato del dominio.
Constraint Stringa <blank> Il nome opzionale del constraint.
Comment Stringa <blank> Descrizione oggetto.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
PROCEDURE   Contiene le caratteristiche di un singolo oggetto di tipo procedura/funzione.
Name Stringa <blank> Nome dell'oggetto procedura/funzione.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Argument Stringa <blank> Il nome di un argomento della funzione.
Argument2 Stringa <blank> Il tipo degli argomenti della funzione, se presenti.
Definition Stringa <blank> Una stringa che definisce il contenuto della funzione; la struttura interna è dipendente dal linguaggio usato.
Language Stringa <blank> Il nome del linguaggio usato nell'implementazione della funzione.
Property1 Stringa <blank> Questo attributo informa il sistema di salvare eventuali multiple valutazioni della funzione, trattandole come una singola. Valori ammessi:
  • IMMUTABLE
  • STABLE
  • VOLATILE
Property2 Stringa <blank> Modalità di chiamata della funzione. Valori ammessi:
  • CALLED ON NULL INPUT
  • RETURNS NULL ON NULL INPUT
Property3 Stringa <blank> Privilegi di chiamata della funzione: Valori ammessi:
  • SECURITY INVOKER
  • SECURITY DEFINER
ReturnValue Stringa <blank> Il tipo del valore di ritorno.
ReturnValue2 Stringa <blank> Il tipo del valore di ritorno.
Comment Stringa <blank> Descrizione oggetto.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
RELATION   Contiene le caratteristiche di un singolo oggetto di tipo relazione.
Name Stringa <blank> Nome dell'oggetto relazione.
X1 Numerico 0 Coordinata X dell'oggetto rispetto alla tabella padre.
Y1 Numerico 0 Coordinata Y dell'oggetto rispetto alla tabella padre.
X2 Numerico 0 Coordinata X dell'oggetto rispetto alla tabella figlia.
Y2 Numerico 0 Coordinata Y dell'oggetto rispetto alla tabella figlia.
Table1 Stringa <blank> Nome tabella padre.
Table2 Stringa <blank> Nome tabella figlia.
OnUpdate Stringa <blank> La clausola specifica l'azione da eseguire quando una riga della tabella referenziata viene modificata.
OnDelete Stringa <blank> La clausola specifica l'azione da eseguire quando una riga della tabella referenziata viene cancellata.
ColorLine Stringa 0,0,0 Colore della linea (formato: r,g,b).
ColorLineSelected Stringa 0,0,0 Colore della linea quando selezionata (formato: r,g,b).
ColorStartPoint Stringa 0,0,0 Colore del punto di partenza (formato: r,g,b).
ColorMiddlePoint Stringa 0,0,0 Colore del punto centrale (formato: r,g,b).
ColorEndPoint Stringa 0,0,0 Colore del punto di arrivo (formato: r,g,b).
RELATIONFIELD   Definizione dei campi delle tabelle in relazione. Ogni riga determina uno dei campi della tabella padre con il corrispettivo dell'altra tabella.
Relation Stringa <blank> Nome della relazione.
Field1 Stringa <blank> Nome del campo tabella padre.
Field2 Stringa <blank> Nome del campo tabella figlia.
SEQUENCE   Contiene le caratteristiche di un singolo oggetto di tipo sequenza.
Name Stringa <blank> Nome dell'oggetto sequenza.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Cache Numerico 0 Clausola opzionale che specifica quanti numeri sequenziali devono essere preallocati e memorizzati per un accesso veloce.
Increment Numerico 0 Valore di incremento.
La proprietà è opzionale e specifica quale valore viene aggiunto al valore corrente della sequenza per la creazione di un nuovo valore.
Initial Numerico 0 La proprietà è opzionale permette di attivare la sequenza partendo da questo valore.
Iterate Logico 0 L'opzione permette alla sequenza di reiniziare la numerazione al raggiungimento dei valori minimo o massimo. Valori ammessi: 0 o 1.
MaxValue Numerico 0 La clausola è opzionale e determina il massimo valore della sequenza.
MinValue Numerico 0 La clausola è opzionale e determina il minimo valore della sequenza.
Comment Stringa <blank> Descrizione oggetto.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
TABLE   Contiene le caratteristiche di un singolo oggetto di tipo tabella.
Name Stringa <blank> Nome dell'oggetto tabella.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Comment Stringa <blank> Descrizione oggetto.
Option Stringa <blank> La clausola è opzionale e specifica se le righe della nuova tabella devono avere l'identificatore di oggetto (OID).
PrimaryKey Stringa <blank> Specifica se la colonna o le colonne di una tabella devono contenere valori unici (non duplicati).
Tablespace Stringa <blank> Il nome della tablespace dove viene creata la nuova tabella.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
TABLEFIELD   Definizione di un singolo campo di tabella.
Name Stringa <blank> Nome del campo.
Table Stringa <blank> Nome della tabella.
Check Stringa <blank> Specifica un'espressione che ritorna un valore logico quando delle righe nuove o modificate soddisfano un'operazione di inserimento o aggiornamento.
Comment Stringa <blank> Descrizione del campo.
DefaultValue Stringa <blank> Assegna un valore di default per la colonna.
Length Stringa <blank> Dimensione del campo.
NullCheck Logico 0 Flag di abilitazione della colonna a contenere valori nulli.
PrimaryKey Stringa <blank> Specifica che la colonna deve contenere valori unici (non duplicati).
Type1 Stringa <blank> Il tipo di dato della colonna.
Type2 Stringa <blank> Il tipo di dato della colonna.
INDEX   Definizione di un singolo indice di tabella.
Name Stringa <blank> Nome dell'indice.
Table Stringa <blank> Nome della tabella.
Tablespace Stringa <blank> Nome della tablespace dove l'indice viene creato.
Unique Logico 0 Specifica che le colonne dell'indice devono contenere solo valori unici.
INDEXFIELD   Definizione di un campo di indice.
Name Stringa <blank> Nome del campo indice.
Table Stringa <blank> Nome della tabella.
Index Stringa <blank> Nome dell'indice.
TABLESPACE   Contiene le caratteristiche di un singolo oggetto di tipo tablespace.
Name Stringa <blank> Nome dell'oggetto tablespace.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Location Stringa <blank> La directory usata per la tablespace.
Owner Stringa <blank> Nome utente proprietario della tablespace.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
TEXT   Contiene le caratteristiche di un singolo oggetto di tipo testo.
Name Stringa <blank> Nome dell'oggetto testo.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Alignment Stringa L Allineamento del testo:
  • L = sinistra
  • C = centrato
  • R = destra
Value Stringa <blank> Contenuto del testo.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorFore Stringa 0,0,0 Colore di testo (formato: r,g,b).
ColorForeSelected Stringa 0,0,0 Colore di testo quando selezionato (formato: r,g,b).
TRIGGER   Contiene le caratteristiche di un singolo oggetto di tipo trigger.
Name Stringa <blank> Nome dell'oggetto trigger.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
BeforeAfter Stringa <blank> Determina se la funzione è chiamata prima o dopo l'evento. Può assumere i valori:
  • BEFORE
  • AFTER
InsUpdDel Stringa <blank> Specifica l'evento che deve essere scatenato dal trigger. Può assumere i valori:
  • INSERT
  • UPDATE
  • DELETE
Procedure Stringa <blank> Nome della funzione, dichiarata senza argomenti e che ritorna un valore di tipo trigger, che è eseguita quando è attivato il trigger.
Table Stringa <blank> Il nome della tabella su cui viene attivato il trigger.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
TYPE   Contiene le caratteristiche di un singolo oggetto di tipo "type".
Name Stringa <blank> Nome dell'oggetto type.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Input Stringa <blank> Nome funzione che converte il dato da un tipo testuale esterno ad un tipo interno.
Output Stringa <blank> Nome funzione che converte il dato da un tipo interno ad un tipo testuale esterno.
Receive Stringa <blank> Nome funzione che converte il dato da un tipo binario esterno ad un tipo interno.
Send Stringa <blank> Nome funzione che converte il dato da un tipo interno ad un tipo binario esterno.
Analize Stringa <blank> Nome funzione che esegue le analisi statistiche per il tipo di dato.
InternalLength Numerico 0 Costante numerica che specifica la lunghezza in byte della rappresentazione interna del nuovo tipo.
PassedByValue Logico 0 Indica che i valori di questo tipo di dato sono passati per valore, altrimenti per riferimento. Valori ammessi: 0 o 1.
Alignment Stringa <blank> Allineamento di memoria richiesto per il tipo di dato. Se specificato, deve essere char, int2, int4, o double.
Storage Stringa <blank> Strategia di memoria per il tipo di dato. Se specificata, deve essere plain, external, extended, o main.
DefaultValue Stringa <blank> Valore di default per il tipo di dato.
Element Stringa <blank> Il tipo viene creato in un array; specifica il tipo degli elementi dell'array.
Delimiter Stringa <blank> Carattere delimitatore usato tra i valori in array costruiti di questo tipo.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).
VIEW   Contiene le caratteristiche di un singolo oggetto di tipo vista.
Name Stringa <blank> Nome dell'oggetto vista.
X Numerico 0 Coordinata X dell'oggetto.
Y Numerico 0 Coordinata Y dell'oggetto.
Definition Stringa <blank> Definizione SQL della vista.
Comment Stringa <blank> Descrizione oggetto.
ColorBack Stringa 0,0,0 Colore di background (formato: r,g,b).
ColorText Stringa 0,0,0 Colore del testo (formato: r,g,b).
ColorBackTitle Stringa 0,0,0 Colore di background del titolo (formato: r,g,b).
ColorBackTitleSelected Stringa 0,0,0 Colore di background del titolo quando selezionato (formato: r,g,b).
ColorForeTitle Stringa 0,0,0 Colore del titolo (formato: r,g,b).
ColorForeTitleSelected Stringa 0,0,0 Colore del titolo quando selezionato (formato: r,g,b).