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).