Comment gérer des macros dans les documents

De Opera Wiki.



Image:iconawip.png page en cours de mise à jours


Le macro sono un potente strumento messo a disposizione da Opera per la creazione dei documenti. Si tratta di stringhe di testo che iniziano e terminano con i caratteri "//" e permettono di creare di modelli di documenti i cui campi verranno generati e caricati coi valori reali al momento della stampa. Per tale motivo, uno stesso documento che rappresenta un modello di preventivo, potrà essere utilizzato per tutti i propri preventivi senza ulteriori modifiche.

Le macro possono essere "semplici" o "con parametri". (Ad esempio, una macro che inserisce un'immagine all'interno del foglio potrebbe avere come parametri la larghezza e l'altezza dell'immagine). Tali parametri, come vedremo in seguito, possono essere obbligatori o opzionali e vanno specificati dopo il titolo della macro stessa, separati da ";". L'ordine dei parametri è importante, per tale motivo, nelle spiegazioni seguenti essi sono riportati nell'ordine esatto in cui Opera si aspetta di trovarli all'interno della macro. Quando si desidera omettere un parametro opzionale, è comunque necessario inserire il carattere ";" dopo il precedente parametro.

Di seguito le principali macro di Opera Gestione Commesse:

Sommaire

Macro di inserimento dati (solo testo)

  • //Anno// : Stampa l'anno corrente.
  • //AnnoXX// : Stampa le ultime due cifre dell’anno presente nel campo in data del quadro dati generali commessa'.
  • //AnteprimaCommessa: // : Stampa l’anteprima delle tipologie presenti all’interno della commessa
Note NOTE:
Parametri
si/no: abilita o meno la visualizzazione anche delle tipologie congelate.
base X (opzionale): lo scostamento dal bordo sinistro del foglio
base Y (opzionale): lo scostamento dal bordo superiore del foglio
larghezza (opzionale): la larghezza dell’area di stampa partendo dal riferimento base X
altezza (opzionale): l'altezza dell’area di stampa partendo dal riferimento base Y
Note N.B: Esempio : //AnteprimaCommessa:no;4;;12;//
  • //Cantiere_CAP//: Stampa il CAP della città del cantiere del quadro Cantiere che si trova all'interno dei dati della commessa.
  • //Cantiere_Citta//: Stampa la città del cantiere.
  • //Cantiere_Indirizzo//: Stampa l’indirizzo del cantiere così come inserito nel campo “Indirizzo”.
  • //Cantiere_nome//: Stampa il testo inserito nel campo “Cantiere” del quadro Cantiere.
  • //Cantiere_Prov//: Stampa la sigla della provincia della città del cantiere.
  • //Cliente_CAP// : Stampa il CAP della città del cliente.
  • //Cliente_Citta// : Stampa la città del cliente.
  • //Cliente_Indirizzo// : Stampa l’indirizzo del cliente, così come inserito nel campo “Indirizzo”.
  • //Cliente_note// : Stampa le note presenti nel campo Note del quadro Dati cliente commessa se il cliente è salvato in archivio.
  • //Cliente_Prov// : Stampa la sigla della provincia della città del cliente.
  • //Cliente_RagioneSociale// : Stampa la ragione sociale del cliente inserita nei dati della commessa riferiti al cliente.
  • //Commessa// : Stampa il progressivo e l’anno della commessa nel formato 01/2009.
  • //data// : Stampa la data corrente nel formato gg/mm/aaaa
  • //dataest// : Stampa la data corrente nel formato gggg nn mmmm aaaa
  • //DescizioneTipologia: // : Stampa la descrizione presente del quadro Dati tipologia
Note NOTE:
Parametri
Quantità caratteri: limite massimo di caratteri della descrizione da mostrare.
Note N.B: Esempio : Una descrizione di 57 battute, con //DescrizioneTipologia:10// diventa da Finestra a due ante con ribalta ed accessori color ottone a Finestra a ...
Note NOTE:
Parametri
Si/No: Abilita/Disabilita la visualizzazione del numero.
Note N.B: Esempio : //NumPag:Si//
Note NOTE:
Parametri
[Nome della mansione]: Il titolo della mansione da mostrare
Note N.B: Esempio : //Operatore:RFPC// Se Piero Verdi ha come mansione RFPC, il suo nome comparirà nella stampa.

Macro di inserimento immagini e impostazione grafica

Note NOTE:
Parametri
nome_file: il percorso del file che contiene l'immagine da mostrare. (è possibile usare anche macro che scrivono percorsi di immagini, come ad esempio //logofile//)
sfondo (opzionale): imposta l'immagine specificata come sfondo della pagina (per stampare ad esempio la fincatura della Dichiarazione CE di conformità).)
larghezza (opzionale): la larghezza dell’area di stampa partendo dal riferimento base X
altezza (opzionale): l'altezza dell’area di stampa partendo dal riferimento base Y
Se si omette l’altezza (o la larghezza) la quota mancante viene calcolata in proporzione alle dimensioni dell’immagine.
Note N.B: Esempio : //bitmap:logo.bmp;sfondo;18// inserisce l'immagine logo.bmp come sfondo del documento, con larghezza pari a 18 cm
Esempio : //bitmap://logofile//;6// inserisce con larghezza pari a 6 cm il logo caricato nel quadro Setup intestazione stampe, anche se non sono state attivate le opzioni Intestaz.BitMaP e Int nel documento.


Note NOTE:
Parametri
x0;y0 (opzionale) : specificano il punto di origine della linea in cm; se omessi la linea verrà tracciata a partire dal punto corrente.
dx;dy : rispettivamente la distanza in cm dal punto di origine della linea, rispetto all'asse x e all'asse y
Note N.B: Esempio : //Linea: 1;1;4;0 // traccia una linea orizzontale di 4cm a partire dal punto (1;1) rispetto al margine superiore del foglio


Note NOTE:
Parametri
spostamento : valore in cm dello spostamento da effettuare
Note N.B: Esempio : //OffsetX: 2// sposta tutta la stampa di 2cm a destra rispetto al margine sinistro del documento


Note NOTE:
Parametri
spostamento : valore in cm dello spostamento da effettuare
Note N.B: Esempio : //OffsetY: 3// sposta tutta la stampa di 3cm in basso rispetto al margine superiore del documento


Note NOTE:
Parametri
x0;y0 (opzionale) : specificano lo spostamento in cm del punto in alto a sinistra del rettangolo rispetto al margine in alto a sinistra del documento; se omessi il rettangolo verrà tracciata a partire dal punto corrente.
x1;y1 : le coordinate del punto inferiore destro del rettangolo.
N;offset (opzionale): se specificati, permettono di tracciare rettangoli all'interno del principale, a distanza l'uno dall'altro pari ad offset (valore in mm) per un massimo di N. Quindi il valore di N indica il totale dei rettangoli da tracciare, compreso quello più esterno.
Note N.B: Esempio : //Rettangolo: 1;1;5;3;2;5// crea un rettangolo dal punto (1:1) al punto (5:3) con al suo interno un altro rettangolo a 5mm di distanza.


Macro di formattazione del testo

Note NOTE:
Parametri
tipo carattere: il nome del carattere da utilizzare.
Note N.B: Esempio : //Font:Arial//


Note NOTE:
Parametri
valore dell’interlinea[ri]: Il valore della nuova interlinea espresso in mm. Se il numero è seguito dal suffisso ri il valore numero verrà interpretato come frazione di riga.
Note N.B: Esempio : //Interlinea:5,5//: imposta il valore dell'interlinea a 5,5mm
Esempio : //Interlinea:2ri// imposta il valore dell'interlinea a mezza riga


Note NOTE:
Parametri
base X (opzionale): la distanza in cm del nuovo margine rispetto al bordo sinistro del documento
base Y (opzionale): la distanza in cm del nuovo margine rispetto al bordo superiore del documento
larghezza (opzionale): la larghezza della nuova area. se omessa viene presa in automatico la dimensione massima del foglio
altezza (opzionale): l'altezza della nuova area. se omessa viene presa in automatico la dimensione massima del foglio
Note N.B: Esempio : //posiziona:1;2;19;26// Crea un'area di stampa di lato 19x26 con il vertice superiore sinistro ad 1 cm dal bordo sinistro del foglio ed a 2 cm dal bordo superiore.
Esempio : //posiziona:2;;16;// In questo caso viene creata un'area di stampa larga 16 cm e alta fino alla fine del documento, che si scosta 2 cm rispetto al margine sinistro corrente



Macro di automazione del testo

Queste macro permettono di compilare alcune parti manualmente in fase di stampa e di inserire del testo solo al verificarsi di certe condizioni.

Note NOTE:
Parametri
Nome campo : Il nome del campo che verrà richiesto prima della fase di stampa
Lunghezza (opzionale): la lunghezza del campo
Valore predefinito' (opzionale): il valore predefinito che conterrà il campo
Note N.B: Esempio : //Campo:Validità preventivo;3;30// Insersce un campo chiamato Validità preventivo, di 3 caratteri e con valore predefinito 30
Esempio: //Campo:Data;8// Inserisce un campo di lunghezza 8 che conterrà la data corrente come valore predefinito


Note NOTE:
Parametri
Nome campo : Il nome del campo che verrà richiesto prima della fase di stampa
Lunghezza (opzionale): la lunghezza del campo
SI/NO
Note N.B: Esempio : //Data://Campo:Data documento;8////


Questa macro consente di inserire delle parti di testo solo se si verificano determinate condizioni. È composta da due macro: una di inizio, //If//, nella quale è contenuta la condizione da verificare, e una finale //EndIf// che chiude la macro. Se la condizione all'interno della parte //If// è vera, verrà mostrato tutto il testo contenuto tra le parti //If// e //EndIf//. Può essere usata in abbinamento alla macro //VeroFalso// oppure per confrontare il valore della pagina corrente (Npag) con quello totale delle pagine(TotPag).

Note N.B: Esempio : //If://VeroFalso:Stampa il sistema// Serramenti// //serie// //sistema//.//EndIf//
Esempio //If:NPag=TotPag//Fine//EndIf//


Macro per la costruzione di bolle e fatture

Queste macro consentono di costruire DDT e fatture.

Es. //Ora://Campo:Ora di partenza;5////

Note NOTE:
Parametri
Numero righe pagina : il numero di righe da inserire
Posizione campo[lunghezza campo][(S
Note N.B: Esempio : //RigaTpg:16;1,7d"Pezzi" 2,2l5"Descrizione" 10,8d"PrzUnitario" 13,8d"PrzTotale"//

Macro di impostazioni stampa

Dichiarazione CE di conformità

Récupérée de « http://wiki.operacompany.com/fr/index.php/Comment_g%C3%A9rer_des_macros_dans_les_documents »
Affichages
Outils personnels
Navigation
Boîte à outils