How to manage document macros

From Opera Wiki

(Difference between revisions)
Jump to: navigation, search
(Created page with '{{WIP}} {{BR}} <!-- 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…')
 
(6 intermediate revisions not shown)
Line 2: Line 2:
{{BR}}
{{BR}}
<!--
<!--
-
Le macro sono un potente strumento messo a disposizione da Opera per la creazione dei documenti.
+
Macros are a tool made available by Opera for creating documents.
-
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.
+
These are text strings that begin and end with the characters "//" and allow you to create document templates whose fields will be generated and loaded with the real values ​​at the time of printing. For this reason, the same document that represents a quote template can be used for all your quotes without further modifications.
-
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.  
+
Macros can be "simple" or "parameterized". (For example, a macro that inserts an image into the sheet might have the width and height of the image as parameters). These parameters, as we will see later, can be mandatory or optional and must be specified after the title of the macro itself, separated by ";". The order of the parameters is important, for this reason, in the following explanations they are shown in the exact order in which Opera expects to find them within the macro. When you want to omit an optional parameter, you still need to insert the ";" after the previous parameter.
-
Di seguito le principali macro di Opera Gestione Commesse:
+
Below are the main macros of Opera Job Management:
-
==Macro di inserimento dati (solo testo)==
+
==Data entry macros (text only)==
-
* '''//Anno// ''': Stampa l'anno corrente.
+
 +
* '''//Year// ''':Print the current year.
-
* '''//AnnoXX// ''': Stampa le ultime due cifre dell’anno presente nel campo ''in data'' del quadro ''dati generali commessa'''.
+
* '''//YearXX// ''': Print the last two numbers of the year in the '' Date '' field of the ''Job''.
-
* '''//AnteprimaCommessa: // ''': Stampa l’anteprima delle tipologie presenti all’interno della commessa
+
* '''//JobPreview: // ''': Print the preview of the typologies within the job.
-
:{{NOTE|Parametri: <br/> '''si/no''': abilita o meno la visualizzazione anche delle tipologie congelate. <br/> '''base X''' ''(opzionale)'': lo scostamento dal bordo sinistro del foglio<br/> '''base Y''' ''(opzionale)'': lo scostamento dal bordo superiore del foglio<br/> '''larghezza''' ''(opzionale)'': la larghezza dell’area di stampa partendo dal riferimento base X<br/> '''altezza''' ''(opzionale)'': l'altezza dell’area di stampa partendo dal riferimento base Y}}
+
 
 +
:{{NOTE|Parameters: <br/> '''yes/no''': enable or not the display of the frozen typologies as well. <br/> '''base X''' ''(optional)'': the offset from the left edge of the document<br/> '''base Y''' ''(optional)'': the offset from the top edge of the document<br/> '''width ''' ''(optional)'': the width of the print area starting from the reference base X<br/> '''height''' ''(optional)'': the height of the print area starting from the reference base Y}}
-
:{{NB|Esempio : '''//AnteprimaCommessa:no;4;;12;//'''}}
+
:{{NB|Example : '''//JobPreview:no;4;;12;//'''}}
-
* '''//Cantiere_CAP//''': Stampa il CAP della città del cantiere del quadro Cantiere che si trova all'interno dei dati della commessa.
+
* '''//BuildingYard_Postcode//''': Print the postcode of the construction site city in the job data.
-
* '''//Cantiere_Citta//''': Stampa la città del cantiere.
+
* '''//BuildingYard_City//''': Print the city of the construction site.
-
* '''//Cantiere_Indirizzo//''': Stampa l’indirizzo del cantiere così come inserito nel campo “Indirizzo”.
+
* '''//BuildingYard_Address//''': Print the address of the construction site
-
* '''//Cantiere_nome//''': Stampa il testo inserito nel campo “Cantiere” del quadro Cantiere.
+
* '''//BuildingYard_Name//''': Print the name of the construction site.
-
* '''//Cantiere_Prov//''': Stampa la sigla della provincia della città del cantiere.
+
* '''//BuildingYard_Country//''': Print the country of the construction site.
-
* '''//Cliente_CAP// ''': Stampa il CAP della città del cliente.
+
* '''//Client_Postcode// ''': Print the customer's city postcode.
-
* '''//Cliente_Citta// ''': Stampa la città del cliente.
+
* '''//Client_City// ''': Print the customer's city.
-
* '''//Cliente_Indirizzo// ''': Stampa l’indirizzo del cliente, così come inserito nel campo “Indirizzo”.
+
* '''//Client_Address// ''': Print the customer's address.
-
* '''//Cliente_note// ''': Stampa le note presenti nel campo Note del quadro Dati cliente commessa se il cliente è salvato in archivio.
+
* '''//Client_note// ''': Prints the notes in the Job Customer Data panel if the customer is saved in the archive.
-
* '''//Cliente_Prov// ''': Stampa la sigla della provincia della città del cliente.
+
* '''//Client_CorporateName// ''': Print the customer's corporate name.
-
* '''//Cliente_RagioneSociale// ''': Stampa la ragione sociale del cliente inserita nei dati della commessa riferiti al cliente.
+
* '''//JobNo// ''': Print the sequence nu. and the year of the job in 01/2009 format.
-
* '''//Commessa// ''': Stampa il progressivo e l’anno della commessa nel formato 01/2009.
+
* '''//Date// ''': Prints the current date in dd / mm / yyyy format.
-
* '''//data// ''': Stampa la data corrente nel formato gg/mm/aaaa
+
* '''//FullDate// ''': Prints the current date in the format ddd nn mmmm yyyy
-
* '''//dataest// ''': Stampa la data corrente nel formato gggg nn mmmm aaaa
+
* '''//Description Typologie: // ''': Prints the description of the typologie.
-
 
+
:{{NOTE| Parameters: <br/> '''Quantità caratteri''': limite massimo di caratteri della descrizione da mostrare.}}
-
* '''//DescizioneTipologia: // ''': Stampa la descrizione presente del quadro Dati tipologia
+
-
:{{NOTE| Parametri: <br/> '''Quantità caratteri''': limite massimo di caratteri della descrizione da mostrare.}}
+
:{{NB|Esempio : Una descrizione di 57 battute, con //DescrizioneTipologia:10// diventa da ''Finestra a due ante con ribalta ed accessori color ottone'' a  ''Finestra a ...''}}
:{{NB|Esempio : Una descrizione di 57 battute, con //DescrizioneTipologia:10// diventa da ''Finestra a due ante con ribalta ed accessori color ottone'' a  ''Finestra a ...''}}

Latest revision as of 09:37, 18 July 2023



Image:iconawip.png work in progress



Personal tools