Crystal Reports Designer  

Boîte de dialogue Editeur de formule

L'Editeur de formule est un composant majeur de la boîte de dialogue Atelier de formules. Il peut prendre différents noms en fonction du type de formule sur lequel vous travaillez :

L'Editeur de formule est identique à l'Editeur de formule personnalisée et à l'Editeur d'expressions SQL. Ces éditeurs sont inclus dans cette description.

Cette boîte de dialogue s'affiche lorsque vous modifiez un champ de formule existant ou que vous en créez un nouveau en cliquant avec le bouton droit de la souris sur Champs de formule dans l'Explorateur de champs et en sélectionnant Nouveau. Une fois que vous avez nommé votre formule, la boîte de dialogue Editeur de formule s'affiche.

Fenêtres de l'Editeur de formule

L'Editeur de formule contient quatre fenêtres principales.

Champs de l'état
Les champs de l'état contiennent tous les champs de la base de données accessibles pour votre état. Ils contiennent également les formules et groupes déjà créés pour l'état.
Note   Cette fenêtre n'apparaît pas lors de la création d'une fonction personnalisée.
Fonctions
Les fonctions sont des procédures intégrées qui renvoient des valeurs. Elles permettent d'effectuer des calculs comme la moyenne, la somme, le comptage, le sinus, la suppression de blancs ou la mise en majuscule.
Remarque    Le passage de la syntaxe Crystal à la syntaxe Basic, ou vice versa, entraînera la modification de la liste de fonctions dans la fenêtre Fonctions et de la liste des opérateurs dans la fenêtre Opérateurs. Les fonctions et opérateurs sont différents d'une syntaxe à l'autre.
Opérateurs
Les opérateurs sont en quelque sorte les "verbes" des formules. Ils décrivent une action ou une opération devant être effectuée avec deux valeurs ou plus.

Exemples d'opérateurs : addition, soustraction, inférieur à et supérieur à.

Fenêtre Texte de la formule
Zone dans laquelle vous créez ou modifiez une formule.

Vous créez une formule en cliquant deux fois sur l'un des composants répertoriés dans les arborescences de champs d'états, de fonctions ou d'opérateurs. Lorsque vous choisissez un composant, la syntaxe requise est également insérée. Vous pouvez aussi entrer une formule manuellement.

Une fois une formule créée ou modifiée, cliquez sur le bouton Vérifier pour contrôler qu'elle ne contient pas d'erreur. Cliquez sur le bouton Enregistrer pour enregistrer la formule.

Boutons de l'Atelier de formules

Les boutons de la barre d'outils générale de l'Atelier de formules ont les fonctions suivantes :

Bouton Description
Enregistrer et fermer Ferme l'Atelier de formules après vous avoir invité à enregistrer vos modifications. Si vous enregistrez vos modifications, il vérifie que votre formule ne contient aucune erreur.
Enregistrer Enregistre la formule, l'expression SQL ou la fonction personnalisée.
Crée une formule du type que vous avez sélectionné dans la liste. Permet également de créer une fonction personnalisée ou une expression SQL.
Affiche ou masque l'arborescence de l'atelier.
Affiche/masque alternativement l'Editeur de fonction personnalisée ou la Boîte de dialogue Propriétés des fonctions personnalisés. Les fonctions personnalisées et les formules (le cas échéant) s'affichent dans le mode sélectionné jusqu'à ce que vous cliquiez une nouvelle fois sur ce bouton.
Ouvre l'Expert Formule. Utilisez cet Expert pour créer une formule à partir d'une fonction personnalisée.
Remarque   Ce bouton n'est pas disponible lorsque vous créez une fonction personnalisée.
Ouvre l'aide en ligne pour cette boîte de dialogue.

Les boutons de la barre d'outils de l'arborescence de l'Atelier des formules ont les fonctions suivantes :

Bouton Description
Permet de renommer la formule sélectionnée, la fonction personnalisée ou l'expression SQL.
Supprime la formule sélectionnée, la fonction personnalisée ou l'expression SQL.
Développe ou réduit le nœud sélectionné dans l'arborescence de l'atelier. Fonctionne également avec des sélections multiples de nœuds.
Dans le dossier des formules de mise en forme, affiche ou masque les nœuds correspondant aux objets état si aucune formule n'est associée à ces objets.
Ouvre la boîte de dialogue Ajouter les fonctions personnalisées au référentiel afin que vous puissiez sélectionner le référentiel auquel ajouter la fonction personnalisée.
Remarque   Cette option ne fonctionne pas dans cette version de Crystal Reports.
Ajoute la fonction personnalisée du référentiel sélectionné à l'état.
Remarque   Cette option ne fonctionne pas dans cette version de Crystal Reports.

Les boutons de la barre d'outils de l'Editeur d'expression de l'Atelier de formules ont les fonctions suivantes :

Bouton Description
Teste la syntaxe de la formule ou de la fonction personnalisée et identifie les erreurs de syntaxe le cas échéant.
Annule la dernière action effectuée.
Répète la dernière action.
Lorsque vous sélectionnez un champ dans une fenêtre de champs d'état et que vous cliquez sur le bouton Parcourir les données, une boîte de dialogue contenant une liste des valeurs pour le champ sélectionné apparaît.

Visualisez les valeurs des champs sélectionnés et choisissez les valeurs individuelles que vous souhaitez insérer dans votre formule.

Remarque   Ce bouton n'est pas disponible pour les fonctions personnalisées.
Recherche un mot, un nombre ou une chaîne de formule spécifiés dans l'Editeur de formule.
Insère un signet au début d'une ligne de formule sélectionnée. Cliquez de nouveau sur le bouton pour supprimer le signet.
Accède au signet suivant.
Accède au signet précédent.
Supprime tous les signets de la formule sélectionnée.
Réorganise toutes les arborescences des champs, des fonctions et des opérateurs d'état par ordre alphabétique.
Masque ou affiche l'arborescence des champs d'état.
Remarque   Ce bouton n'est pas disponible pour les fonctions personnalisées.
Masque ou affiche l'arborescence des fonctions.
Masque ou affiche l'arborescence des opérateurs.
Vous permet de sélectionner la syntaxe Crystal ou la syntaxe Basic pour votre formule. Pour en savoir plus, voir Formules - Référence.

Changer la syntaxe de Crystal en Basic ou inversement modifiera la liste des fonctions dans la fenêtre de fonctions ainsi que la liste des opérateurs dans la fenêtre des opérateurs. Les fonctions et opérateurs sont différents d'une syntaxe à l'autre.

Met en commentaire la sélection en surbrillance d'une formule. Les lignes de commentaire ne sont pas considérées comme partie intégrante de la formule.

Touches de raccourci

Les touches de raccourci qui fonctionnent dans l'Editeur de formule sont les suivantes :

Combinaisons de clavier Opération effectuée
Alt+B Ouvre la boîte de dialogue Parcourir pour le champ sélectionné.
Alt+C Vérifie qu'il n'y a pas d'erreur dans la formule.
Alt+F Ouvre ou ferme l'arborescence des champs.
Alt+M Met en commentaire la ligne en cours ou supprime le marquage de mise en commentaire.
Alt+O Trie le contenu des arborescences.
Alt+P Ouvre ou ferme l'arborescence des opérateurs.
Alt+S Enregistre la formule sans fermer l'Editeur de formule.
Alt+U Ouvre ou ferme l'arborescence des fonctions.
Ctrl+A Sélectionne tout.
Ctrl+C Copie.
Ctrl+Fin Va à la fin de la dernière ligne de la formule.
Ctrl+F Ouvre la boîte de dialogue Rechercher.
Ctrl+F2 Définit un signet.
Ctrl+Maj+F2 Efface tous les signets.
Ctrl+Orig Va au début du fichier.
Ctrl+Flèche gauche Va à la première lettre du mot à gauche (+Maj fera la sélection).
Ctrl+N Ouvre la boîte de dialogue Nom de la formule ou une autre boîte de dialogue appropriée pour créer une nouvelle formule.
Ctrl+S Enregistre la formule et ferme l'Atelier de formules.
Ctrl+T Dirige le foyer sur la zone de liste des noms de syntaxe.
Ctrl+Maj+
Tab
Dirige le foyer sur la zone de contrôle suivante (ordre inversé de la combinaison Ctrl-Tabulation).
Ctrl+Tab Dirige le foyer sur la zone de contrôle suivante.
Ctrl+V Colle la sélection.
Ctrl+X Coupe la sélection.
Ctrl+Z Annule une opération.
Ctrl+Maj+Z Répète une opération.
Ctrl+Espace Complétion automatique de mots clés : affiche une liste des fonctions disponibles.
Fin Va à la fin de la ligne.
Entrée Copie un objet sélectionné depuis une liste et l'insère dans la zone de texte de la formule.
F2 Va au signet suivant.
F3 Recherche l'occurrence suivante de l'élément tel que défini dans la boîte de dialogue Rechercher.
Maj+F2 Va au signet précédent.

Voir aussi

Exécution des calculs dans un état | Création de formules avec une syntaxe Basic | Création de formules avec une syntaxe Crystal | Boîte de dialogue Atelier de formules