Prétraitement [@] Signets de page et valeurs X   -   www.4GL.fr

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

Prétraitement [@] Signets de page et valeurs X   -   www.4GL.fr

Les signets de page et les valeurs X sont des balises spéciales délimitées par des crochets "[" et "]"

 

Syntaxe :

DEFINITION


[@nom] 

définit un  signet de page dans le projet.

Le signet prend la valeur du numéro de page où cette balise est définie, il s'agit d'une  valeur entière.

 

[@XValueName=valeur]

 

définit une valeur X disponible dans le rapport.

La valeur peut être numérique (entière ou décimale) ou alphanumérique.

Si une confusion est possible ou pour conserver le format, il faut placer la valeur entre guillemets simples ou doubles. Ex : [@Montant="1250.00"]

 

[@XValueName=TRANSLATE,target_lang [,source_lang] (text_to_translate)  ] 

 

définit une "valeur X" traduite disponible dans le rapport.

Description complète de la balise dans la fonction translate

 


UTILISATION

[=@name]

 

remplace cette balise par la valeur prétraitée appelée "name".

 


 

Remarques :

Depuis la version 10.41, une variable prétraitée "[@xxxx=xxxx]" peut inclure d'autres variables prétraitées. Un seul niveau est autorisé.

Exemple :

[@TXT=Voici un texte à traduire en plusieurs langues]

 

... puis :

[@DE=translate,DE([@TXT])]

[@NL=translate,NL([@TXT])]

 

... ce qui peut également s'écrire :

[@DE=translate,DE([=@TXT])]

[@NL=translate,NL([=@TXT])]

 

... sont autorisés.

Règles :

1.Les valeurs prétraitées sont disponibles partout dans le rapport, AVANT ou APRÈS leur définition.

2.Si une même balise est définie plusieurs fois, la dernière valeur est conservée,

3.Utilisez "\[@" et"\[=" pour échapper et imprimer "[@" et "[= ".

 

Travailler avec des valeurs prétraitées :

Ces valeurs peuvent être utilisées comme chaînes de caractères, balises ou mots-clés dans des balises.

Utilisation générale :

▪Table des matières,

▪Expressions "Page n sur m",

▪Des valeurs de mots-clés comme "<VIEWPAGE=[=@important]>, supposent qu'un signet de page "[@important]" est défini quelque part dans le rapport,

▪Tout type de chaîne de caractères,

▪...

 

Syntaxe de base :

                 [=@name]                est remplacé par la valeur du numéro de page du signet appelé "name" ou par sa valeur.

 

Syntaxe avancée :

[=@nom |valeur numérique [ + | - ] [@nom2 |valeur numérique ] [ + | - ] [@nom3 | valeur numérique ] ......]

 

Exemples :

1."Page 1 / n" dans un rapport contenant plus d'une section, comme un flux de factures (les opérations arithmétiques ne s'appliquent qu'aux valeurs numériques) :
                       [=@endPage123-@startPage123+1]

a.Placer un signet sur la première page de la facture 123 (exemple). [@startInvoice123]

b.Placer un signet dans la page totale de la facture [@endInvoice123],

c.Utiliser ensuite le pied de page ou l'en-tête avec
               "Page " myPageNumber " /        [=@endInvoice123-@startInvoice123+1]"

2.Tableau récapitulatif :
                       <SENSITIVE,TYPE=LINK,ACTION=PAGE#[=@customer],DEFAULT=Customer,HINT=Customer>

3.Affichage du total de la commande sur la première page:

a.Dans la première page :                Total de la commande [=@TotalOrder]

b.dans la dernière page :                        [@TotalOrder="1,234.56€"]

4.Calculs :

a.[@TotalOrder=1234.56]

b.[@TVA=56]

c.[=@TotalOrder+@VAT+25.73]

 

Comment cela fonctionne-t-il ?

D'un point de vue technique, vpxPrint évalue tous les signets de page  ou les valeurs X "[@....]" avant de traiter le contenu du fichier.

Cela signifie qu'on peut utiliser et/ou intégrer ces variables dans n'importe quelle syntaxe, chaîne ou mot-clé de vpxPrint.

 

Exemple dans le programme xDict.w.

La première page contient une table des matières avec des boutons et des zones sensibles. En cliquant sur un bouton, le preview renvoie vers la page qui contient le signet.

 

... ou avec le Designer...

 

Tuto_Preprocessed2

Exemple de sous-totaux et de numéros de pages prétraités dans The Designer