Crystal Reports  

Principes de base de la syntaxe Crystal

Résultat d'une formule

Le résultat d'une formule, ou la valeur qui s'imprime lorsque la formule est placée dans un état, est appelé la valeur renvoyée par la formule. Chaque formule de Crystal Reports doit renvoyer une valeur. Par exemple, voici une formule simple utilisant la syntaxe Crystal qui renvoie une valeur de 10 :

10

La valeur renvoyée par une formule peut appartenir à l'un des sept types de données simples pris en charge : Nombre, Devise, Chaîne, Booléen, Date, Heure et Date/heure.

Crystal Reports prend également en charge les types plage et tableau, mais ces derniers ne peuvent pas être renvoyés par une formule.

Supposons, par exemple, qu'une société ait une politique d'expédition au titre de laquelle les commandes supérieures à 1 000 € sont couvertes par une assurance tandis que celles inférieures à ce montant ne le sont pas :

//Formule qui renvoie une valeur de type chaîne
If {Commandes.Montant commande} >= 1000 Then
   "Expédition assurée"
Else
   "Expédition ordinaire"

La formule renvoie la valeur de la chaîne de texte "Expédition assurée" si la valeur du champ de base de données {Commandes.Montant commande} est supérieure ou égale à 1 000, et renvoie la valeur de la chaîne de texte "Expéditon ordinaire" dans le cas contraire.

Syntaxe composée d'expressions

Une formule utilisant la syntaxe Crystal est composée d'une suite d'expressions. Une expression correspond à toute combinaison de mots clés, opérateurs, fonctions et de valeurs constantes dont le résultat est une valeur d'un type donné. La valeur de l'expression finale est la valeur renvoyée par la formule et ce qui a été imprimé. Chaque expression doit être séparée de la précédente par un point-virgule (;).

Le fait qu'une formule établie avec la syntaxe Crystal soit une suite d'expressions dont le résultat est la valeur de l'expression finale est le concept le plus important pour la compréhension de la syntaxe Crystal. Cette syntaxe reposant sur les expressions vous permet d'écrire des formules très courtes comportant de nombreuses fonctionnalités.

Respect de la casse

Tous les noms de variables, de fonctions et mots clés utilisés dans les formules à syntaxe Crystal ne font pas de différence entre les majuscules et les minuscules. Par exemple, le mot clé Then pourrait être tapé indifféremment then ou THEN.

seules les chaînes échappent à cette règle. La chaîne "Bonjour" est différente de la chaîne "bonjour".

Entraînement à l'aide de l'exemple de base de données Xtreme.mdb

De nombreux exemples de cette section se réfèrent à l'exemple de base de données Xtreme qui peut être téléchargé à partir de la zone des développeurs Java. Pour télécharger l'exemple de base de données Xtreme, visitez le site http://www.businessobjects.com/products/dev_zone/java/default.asp.

Voir aussi

Syntaxe Crystal