Il file di formato per gli assegni è utilizzato per indicare a GnuCash
come stampare uno o più
assegni in un foglio di carta. Questo file descrive dapprima la disposizione generale
della pagina (numero di assegni, orientazione, ecc…) e poi descrive
l’impaginazione delle singole voci per ogni assegno. Il file è organizzato nel
tipico formato a chiave e valore utilizzato dalla maggior parte delle applicazioni
Linux
. Le coppie di chiave e valore sono raggruppate in sezioni che iniziano con il nome
del gruppo racchiuso tra parentesi quadre.
GnuCash
cerca i file di formato per gli assegni in due differenti posizioni nel momento in cui viene
aperta la finestra di stampa degli assegni: la prima posizione è generalmente
/usr/share/gnucash/checks
, dove risiedono i file
di formato distribuiti con il programma; la seconda posizione è la cartella personale
~/.gnucash/checks
. L’utente può aggiungere
dei file di formato in qualsiasi momento (anche mentre GnuCash
è in esecuzione) copiando
semplicemente un nuovo file *.chk
in questa cartella. Aprendo
nuovamente la finestra di stampa degli assegni, il nuovo formato apparirà nella lista
di quelli disponibili.
Nota | |
---|---|
La stampa funziona in modo differente in funzione della versione di GTK installata nel sistema.
Quando |
Un tipico file per gli assegni di GnuCash
è mostrato di seguito. Il contenuto di questo file verrà
descritto nelle sezioni successive.
[Top] Guid = 67b144d1-96a5-48d5-9337-0e1083bbf229 Title = Quicken/QuickBooks (tm) US-Letter Rotation = 0.0 Translation = 0.0;4.0 Show_Grid = false Show_Boxes = false [Check Positions] Height = 252.0 Names = Top;Middle;Bottom [Check Items] Type_1 = PAYEE Coords_1 = 90.0;102.0;400.0;20.0 Type_2 = AMOUNT_WORDS Coords_2 = 90.0;132.0 Type_3 = AMOUNT_NUMBER Blocking_Chars_3 = true Coords_3 = 500.0;102.0 Type_4 = DATE Coords_4 = 500.0;67.0 Type_5 = NOTES Coords_5 = 50.0;212.0
Questa sezione del file degli assegni descrive la disposizione generale nella pagina degli assegni (o dell’assegno) che vengono immessi nella stampante.
Tabella B.1. Campo per la descrizione della disposizione generale
Nome | Tipo | Necessario | Descrizione |
---|---|---|---|
Guid | stringa | obbligatorio |
Il codice guid permette di identificare univocamente un
formato di assegni utilizzato da GnuCash . Deve essere unico tra tutti quelli
delle applicazioni fornite e quelli forniti dall’utente. Se si copia un
file di formato esistente da utilizzare come base per le proprie modifiche,
questo valore deve essere cambiato. Il programma uuidgen
può essere usato per generare questo identificativo.
|
Titolo | stringa | obbligatorio | Il campo title permette di identificare univocamente il formato di assegni da parte dell’utente. Questo valore è presentato tale e quale nella lista dei formati presente nella finestra di stampa degli assegni. Se si copia un file di formato esistente da utilizzare come base per le proprie modifiche, questo valore deve essere cambiato adottando una qualsiasi stringa in formato utf-8. |
Carattere | stringa | opzionale |
Se fornita, rappresenta il carattere predefinito utilizzato per stampare tutti
campi di testo nell’assegno. Questo campo può contenere qualsiasi
stringa accettata da GTK come carattere. Se questo campo è lasciato vuoto,
verrà utilizzato il carattere predefinito indicato nelle preferenze di GnuCash .
Un valore tipico può essere «sans 12».
|
Blocking_Chars | Booleano | opzionale | Se fornito, rappresenta il valore di default quando si stampano tutti gli elementi TEXT su questo assegno. Quando impostato a «true», stampa i caratteri *** prima e dopo ogni campo di testo nell’assegno. I caratteri di blocco sono stampati per proteggere i campi di testo da modifiche. Per esempio, il campo dell’importo potrebbe essere stampato come ***100,00*** |
DateFormat | Booleano | opzionale | Se fornito, rappresenta il valore predifinto quando si stampano tutti gli elementi DATE su questo assegno. Se impostato a «true», il formato di data verrà stampato in 8 punti, centrato e sopra la data corrente. Per esempio DDMMYYYY. |
Rotation | virgola mobile | opzionale | Questo valore indica la rotazione di tutta la pagina (in gradi) rispetto al punto di origine. Per le versioni di GTK precedenti alla 2.10, il punto di origine è situato nell’angolo in basso a sinistra della pagina e la rotazione è positiva in senso antiorario. Per le versioni di GTK superiori o uguali alla 2.10, il punto di origine è nell’angolo in alto a sinistra della pagina e la rotazione è positiva in senso orario. La rotazione della pagina è applicata prima della traslazione. |
Translation | elenco di 2 numeri a virgola mobile | opzionale | Questi valori specificano la rotazione lungo x e lungo y dell’intera pagina (in punti) relativamente al punto di origine. Per le versioni di GTK precedenti alla 2.10, il punto di origine è situato nell’angolo in basso a sinistra della pagina e la traslazione è positiva verso l’alto e verso destra. Per le versioni di GTK superiori o uguali alla 2.10, il punto di origine è nell’angolo in alto a sinistra della pagina e la traslazione è positiva verso destra e verso il basso. La rotazione alla pagina è applicata prima della traslazione. |
Show_Grid | Booleano | opzionale |
Se questo valore è impostato a true allora GnuCash
disegnerà una griglia nella pagina, partendo dal punto di origine con delle
linee intervallate di 50 punti. Questa opzione è utile quando si desidera
creare un nuovo file di formato per la stampa degli assegni.
|
Show_Boxes | Booleano | opzionale |
Se questo valore è impostato a true allora per ogni
elemento di cui sono state specificate larghezza e altezza, GnuCash disegnerà
un riquadro che mostra la posizione e l’ingombro massimo
dell’elemento stesso. Questa opzione è utile quando si desidera creare
un nuovo file di formato per la stampa degli assegni.
|
Nota | |
---|---|
Le opzioni Blocking_Chars e DateFormat sono definite per tutti i formati di assegno nella scheda Stampa in → . Si raccomanda che queste opzioni globali rimangano impostate a falso (valore predefinito) e che vengano invece impostate per ogni assegno nel gruppo Check Items come descritto nel seguito. |
Questo gruppo di elementi specifica come sono distribuiti gli assegni nel foglio di carta e fornisce
dei nomi a ogni posizione di un assegno in modo che l’utente possa indicare a
GnuCash
quale di queste posizioni debba essere stampata. Questo gruppo di valori e
chiavi è opzionale e deve essere tralasciato se si desidera che venga stampato un
solo assegno per foglio.
Tabella B.2. Campi per la stampa di più assegni per foglio
Nome | Tipo | Necessario | Descrizione |
---|---|---|---|
Altezza | virgola mobile | obbligatorio | Questo campo specifica l’altezza del singolo assegno nella pagina. Se si desidera stampare più di un assegno per pagina, allora questo campo è obbligatorio. Se si desidera invece stampare un solo assegno per foglio, tutta la sezione dovrebbe essere tralasciata. |
Names | elenco di stringhe | obbligatorio | Questo campo specifica i nomi delle posizioni degli assegni che possono essere stampati per ogni pagina. Questi nomi rappresentano le posizioni dell’assegno partendo dall’alto della pagina e spostandosi verso il basso. I nomi vengono indicati in modo identico nella lista delle posizioni presente nella finestra di stampa degli assegni. Un valore tipico per questo campo può essere Top;Middle;Bottom, ma potrebbe anche essere First;Second;Third o qualsiasi altro insieme di stringhe che identifica chiaramente la posizione dell’assegno. Se si desidera stampare più di un assegno per pagina, allora questo campo è obbligatorio. Se si desidera invece stampare un solo assegno per foglio, tutta la sezione dovrebbe essere tralasciata.. |
Questa sezione indica le singole voci da stampare sull’assegno. Non c’è limite al numero di voci che è possibile inserire e la stessa tipologia può essere ripetuta più volte; questo permette la stampa di assegni che hanno una matrice laterale, o degli assegni per le imprese che sono uno per pagina e che hanno sia l’assegno e le matrici multiple nella stessa pagina. per esempio, per stampare il nome del beneficiario in un assegno per imprese e in entrambe le matrici, basta specificare tre diverse voci del tipo Payee con differenti coordinate per la stampa.
Ogni nome di chiave contenuta in questa sezione include esplicitamente il numero dell’elemento
a cui viene applicata: es. la chiave denominata Type_1 si applica
al primo elemento stampato e la chiave Coords_3 viene applicata
al terzo elemento che deve essere stampato. I numeri delle voci cominciano da uno e
crescono in modo sequenziale. Ogni salto nella numerazione viene interpretato da GnuCash
come la fine della lista della voce. Gli elementi sono stampati secondo l’ordine
numerico, non nell’ordine con cui appaiono nel file.
Ogni elemento specificato deve includere un tipo di dichiarazione. I restanti parametri per l’elemento dipendo dal suo particolare tipo. Consultare la Tabella B.4, «Tipi di voci per un singolo assegno» per recuperare una lista di tipi di elementi validi e i rispettivi parametri richiesti.
Tabella B.3. Campi degli elementi per un unico assegno
Nome | Tipo | Necessario | Descrizione | ||||
---|---|---|---|---|---|---|---|
Type_n | stringa | obbligatorio | Questo campo specifica il tipo di elemento da stampare sull’assegno. Consultare la Tabella B.4, «Tipi di voci per un singolo assegno» per una lista di voci valide. | ||||
Coords_n | elenco di 2 o 4 numeri a virgola mobile | obbligatorio |
Questo campo specifica le coordinate in cui la voce verrà inserita
nell’assegno e, opzionalmente, ne specifica anche l’altezza e la
larghezza. I valori rappresentano rispettivamente gli spostamenti lungo agli
assi X e Y rispetto all’angolo in basso a sinistra dell’elemento e
opzionalmente la sua larghezza e altezza. Se viene fornito un valore per
l’altezza, allora deve essere inserita anche la larghezza e quindi
questo campo deve contenere 2 o 4 valori. Per le versioni GTK precedenti alla
2.10, il punto di origine è nell’angolo in bsso a sinistra della pagina
e le traslazioni sono positive verso l’alto e verso destra. Per le
versioni GTK 2.10 e superiori, il punto di origine è situato in alto a
sinistra e le traslazioni sono positive verso il basso e verso destra.
| ||||
Font_n | stringa | opzionale |
Se fornita, rappresenta il carattere utilizzato per stampare la specifica voce
di testo. Questo campo può contenere una stringa qualsiasi purché sia
accettata da GTK. Se questo campo è lasciato vuoto, verrà utilizzato il
carattere predefinito specificato nella sezione Iniziale
del file di descrizione degli assegni o, se anche questo è stato tralasciato,
il carattere specificato nelle preferenze di GnuCash . Questo campo viene
riconosciuto solamente se si utilizza GTK 2.10 o successivo.
| ||||
Align_n | stringa | opzionale | Se fornita, rappresenta l’allineamento utilizzato per stampare la specifica voce di testo. Questo campo deve contenere una delle seguenti stringhe «sinistra», «centro» o «destra». Se questo campo è lasciato vuoto, il testo verrà allineato a sinistra. Questo campo viene riconosciuto solamente se si utilizzano le GTK 2.10 o successive. | ||||
Text_n | stringa | opzionale | Questo campo è utilizzato solamente quando il tipo di voce è impostato a TEXT. Specifica il testo, in formato utf-8, da stampare sull’assegno. | ||||
Filename_n | stringa | opzionale |
Questo campo è utilizzato solamente quando il tipo di elemento è impostato a
PICTURE. Specifica il nome del file dell’immagine
da stampare sull’assegno. La stringa può specificare un percorso
assoluto o relativo. In quest’ultimo caso, GnuCash controlla prima nella
cartella dei formati di assegno forniti dal programma (generalmente
/usr/share/gnucash/checks ) e, se non lo
dovesse trovare, cercherà nella cartella personale
~/.gnucash/checks . Questo campo viene
riconosciuto solamente se si utilizza GTK 2.10 o successivo.
| ||||
Blocking_Chars_n | Booleano | opzionale | Se fornito, imposta l’opzione di stampa Blocking_Chars per questo elemento. | ||||
DateFormat_n | Booleano | opzionale | Se fornito, imposta l’opzione di stampa DateFormat per questo elemento. |
Queste sono le voci che possono essere stampate individualmente su un assegno; necessitano tutte delle coordinate rispetto alla pagina dove devono essere stampate. La maggioranza di queste voci producono la stampa di un testo sul foglio ed è possibile, per ognuna di esse, specificare un carattere e un allineamento. Per esempio, l’importo in cifre di un assegno può essere stampato con la giustificazione a destra mentre, tutto il resto, giustificato a sinistra. Gli altri tipi devono avere dei parametri unici.
Tabella B.4. Tipi di voci per un singolo assegno
Nome | Valori obbligatorio | Valori facoltativi | Descrizione |
---|---|---|---|
PAYEE | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare il nome del beneficiario
partendo dalle coordinate specificate.
|
DATE | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare la data partendo dalle
coordinate specificate.
|
NOTES | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare il campo delle note della
transazione partendo dalle coordinate specificate.
|
CHECK_NUMBER | Coordinate |
Font |
This type value tells GnuCash to print the check number at the specified
coordinates. The check number reflects the book option selection under
→
for number source (transaction number or anchor-split action - see
Use Split
Action Field for Number in the Book Options section of the GnuCash Help
Manual).
|
MEMO | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare il il campo promemoria della
suddivisione partendo dalle coordinate specificate.
|
ACTION | Coordinate |
Font |
This type value tells GnuCash to print the split action field at the specified
coordinates. However, the printed field reflects the book option selection
under
→
for number source (transaction number or anchor-split action - see
Use Split
Action Field for Number in the Book Options section of the GnuCash Help
Manual). If number source for the book is specified as anchor-split action,
this field will instead print the transaction number field.
|
AMOUNT_WORDS | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare l’importo in lettere
dell’assegno partendo dalle coordinate specificate. L’importo
apparirà nella forma Un milione, due cento trenta quattro e
56/100.
|
AMOUNT_NUMBER | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare l’importo in cifre
dell’assegno partendo dalle coordinate specificate. L’importo
apparirà nella forma €1.234,56.
|
ADDRESS | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare l’indirizzo alle
coordinate specificate.
|
SPLITS_ACCOUNT | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare i nomi dei conti per ogni
suddivisione partendo dalle coordinate specificate. Vedere la nota sulla
stampa delle suddivisioni.
|
SPLITS_AMOUNT | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare l’importo per ogni
suddivisione partendo dalle coordinate specificate. Gli importi sono stampati
con il simbolo della valuta. Vedere la nota sulla stampa delle suddivisioni.
|
SPLITS_MEMO | Coordinate |
Font |
Questo valore del tipo indica a GnuCash di stampare il campo del promemoria
partendo dalle coordinate specificate. Vedere la nota sulla stampa delle
suddivisioni.
|
TEXT | Coordinate, testo |
Font |
Questo valore del tipo indica a GnuCash di stampare una stringa arbitraria
partendo dalle coordinate specificate. La stringa da stampare è specificata
dalla chiave Text_n.
|
PICTURE | Coordinate, nome del file | (nessuno) |
Questo valore del tipo indica a GnuCash di stampare un’immagine partendo
dalle coordinate specificate. L’immagine da stampare è specificata
attraverso la chiave Filename_n. Questo tipo è
riconosciuto solamente quando si utilizza GTK 2.10 o successiva.
|
Nota | |
---|---|
SPLIT items include all split entries for the transaction except for the split that applies to the current account register (referred to as the anchor-split). This is usually the last split listed when splits are displayed in the register. The coordinate location defines the lower left location for the split information. |
Creare un proprio file di formato per gli assegni è un’operazione piuttosto semplice. Il
metodo più semplice consiste nel copiare un file di formato esistente dalla cartella
del programma (generalmente
/usr/share/gnucash/checks
) alla cartella
~/.gnucash/checks
. È importante ricordarsi di
cambiare il valore guid per fare in modo che il nuovo file venga
accettato da GnuCash
e di cambiare il titolo in modo che sia di descrittivo. A questo
punto è possibile cambiare e aggiungere i campi come si desidera. È possibile anche
creare un nuovo file di formato premendo il pulsante Salva formato
nella pagina del Formato personalizzato della finestra di stampa
degli assegni.
Nota | |
---|---|
I nomi delle chiavi sono sensibili alle lettere maiuscole o minuscole. Se si avessero dei problemi con un file di formato per gli assegni, assicurarsi che tutti i nomi delle chiavi inizino con la lettera maiuscola. |