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

Il formato INI, come per il file di configurazione del programma, è un classico formato, con le impostazioni raggruppate in appositi blocchi, e ogni variabile (o caratteristica dell'oggetto) con il suo valore, ognuna definita in una singola riga, nel formato: variabile=valore.

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.

Gruppo | Elemento | 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.
Author | Stringa | <blank> | Nome autore. Contiene il nome dell'autore del progetto.
Description | Stringa | <blank> | Descrizione del progetto. Può contenere un descrizione sintetica del progetto.
Display | Numerico | 0 | Numero del display corrente. Indica il numero del display attivo. Subito dopo il caricamento del progetto, l'applicazione imposta questo display come display corrente, visualizzando nel diagramma i soli oggetti contenuti in questo display.
Driver | Stringa | 8.0 | Numero identificativo della versione di PostgreSQL. Il valore impostato condiziona le caratteristiche del progetto, e determina il tipo di database che si vuole creare.
Name | Stringa | <blank> | Nome del progetto (obbligatorio).
Orientation | 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 dell'applicazione.
Page | Stringa | A4 | Formato pagina di stampa. L'impostazione viene utilizzata per la configurazione di default per le stampe, ma può essere modificata all'interno dell'applicazione.
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 e viene aggiornato ogni qualvolta si effettua una modifica al progetto.
OBJECTS |  | Contiene il numero di oggetti del progetto, separati per tipologia.
Area | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo area contenuti nel file.
Domain | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo dominio contenuti nel progetto.
Text | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo testo contenuti nel progetto.
Procedure | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo procedura/funzione contenuti nel progetto.
Relation | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo relazione contenuti nel progetto.
Sequence | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo sequenza contenuti nel progetto.
Table | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo tabella contenuti nel progetto.
Tablespace | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo tablespace contenuti nel progetto.
Trigger | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo trigger contenuti nel progetto.
Type | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo "tipo" contenuti nel progetto.
View | Numerico | 0 | Contatore. Indica il numero totale degli oggetti di tipo vista contenuti nel progetto.
DISPLAYS |  | Contiene le caratteristiche di tutti i display (o viste) del progetto. Il gruppo è definito una sola volta, e raggruppa tutti i display e gli oggetti contenuti in ognuno di essi.
Display | Numerico | 0 | Numero totale di display definiti nel progetto.

Display[d]

Stringa

<blank>

Ogni display viene definito in una singola riga, identificata da un numero progressivo "d" racchiuso tra parentesi quadre (come un array). I parametri del display sono racchiusi all'interno di doppi apici, separati da virgola. L'ordine degli elementi è il seguente:

1. Identificativo display
2. Nome display
3. Descrizione display

Display[d][n]

Stringa

<blank>

Ogni oggetto contenuto nel display (identificato dal progressivo "d"), viene definito in una singola riga, identificata da un numero progressivo "n". I parametri sono racchiusi all'interno di doppi apici, separati da virgola. L'ordine degli elementi è il seguente:

1. Nome dell'oggetto contenuto nel display
2. Coordinata X dell'oggetto all'interno del display
3. Coordinata Y dell'oggetto all'interno del display

AREA_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo area. Ogni singolo oggetto è identificato da l'etichetta "AREA_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo dominio. Ogni singolo oggetto è identificato da l'etichetta "DOMAIN_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo procedura/funzione. Ogni singolo oggetto è identificato da l'etichetta "PROCEDURE_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo relazione. Ogni singolo oggetto è identificato da l'etichetta "RELATION_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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.

Relation_<n>

Stringa

<blank>

Ogni collegamento tra due campi viene definita in una singola riga, identificata da un numero progressivo che corrisponde alla posizione all'interno della relazione stessa. I due campi sono racchiusi all'interno di doppi apici, separati da una virgola. L'ordine è il seguente:

1. Campo tabella padre
2. Campo tabella figlia

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).
SEQUENCE_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo sequenza. Ogni singolo oggetto è identificato da l'etichetta "SEQUENCE_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo tabella. Ogni singolo oggetto è identificato da l'etichetta "TABLE_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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.

Field_<n>

Stringa

<blank>

Ogni colonna viene definita in una singola riga, identificata da un numero progressivo che corrisponde alla posizione all'interno della tabella. I parametri di colonna sono racchiusi all'interno di doppi apici, separati dal carattere "|". L'ordine dei parametri di colonna è il seguente:

1. Nome campo
2. Descrizione del campo
3. Valore di default: assegna un valore di default per la colonna
4. Dimensione del campo
5. Flag di abilitazione della colonna a contenere valori nulli
6. Primary key: specifica che la colonna deve contenere valori unici (non duplicati)
7. Il tipo di dato della colonna
8. Il tipo di dato della colonna
9. Check: specifica un'espressione che ritorna un valore logico quando delle righe nuove o modificate soddisfano un'operazione di inserimento o aggiornamento.

Index_<n>

Stringa

<blank>

Ogni indice viene definito in una singola riga, identificata da un numero progressivo. I parametri dell'indice sono racchiusi all'interno di doppi apici, separati dal carattere "|". L'ordine dei parametri è il seguente:

1. Nome indice
2. Nome della tablespace dove l'indice viene creato
3. Unique: specifica che le colonne dell'indice devono contenere solo valori unici.
4. Elenco dei campi della tabella, separati da virgola.

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).
TABLESPACE_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo tablespace. Ogni singolo oggetto è identificato da l'etichetta "TABLESPACE_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo testo. Ogni singolo oggetto è identificato da l'etichetta "TEXT_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo trigger. Ogni singolo oggetto è identificato da l'etichetta "TRIGGER_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo "type". Ogni singolo oggetto è identificato da l'etichetta "TYPE_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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_<n> |  | Contiene le caratteristiche di un singolo oggetto di tipo vista. Ogni singolo oggetto è identificato da l'etichetta "VIEW_", seguita da un numero progressivo. Questo numero viene impostato automaticamente dalla funzione di salvataggio del progetto.
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).