Utilisation des formules
Spécification des formules
22
Utilisation de l'Editeur de formule
Vous pouvez créer de nombreux types de formules dans l'Atelier de formules.
Celui-ci se compose d'une barre d'outils, d'une arborescence contenant tous les types de formules pouvant être créés et modifiés, ainsi que d'une zone dans laquelle l'utilisateur définit la formule proprement dite.
Remarque :
Les formules de recherche et de condition de total cumulé sont créées et gérées par le biais de l'Expert Recherche et de la boîte de dialogue Créer un champ de total cumulé (ou Modifier le champ de total cumulé). Ces fonctions ouvrent l'Atelier de formules de manière à pouvoir utiliser son interface utilisateur familière, mais il est impossible d'ajouter ou de gérer directement ces types de formules dans l'Atelier de formules principal.
Accès à l'Atelier de formules
Vous disposez de plusieurs façons d'accéder à l'Atelier de formules. Celui-ci est visible lorsque vous ajoutez des champs de formule, lorsque vous définissez des formules de sélection, lorsque vous utilisez des fonctions personnalisées, etc.
Vous pouvez ouvrir l'Atelier de formules avant de commencer à ajouter des types spécifiques de formules.
Pour accéder à l'Atelier de formules
1.
Dans le menu Rapport, cliquez sur Atelier de formules.
Conseil :
Vous pouvez également effectuer cette opération en cliquant sur le bouton Atelier de formules de la barre d'outils Experts.
L'Atelier de formules apparaît.
2.
Cliquez sur Nouveau, puis sélectionnez dans la liste qui s'affiche le type de formule que vous souhaitez créer.
Conseil :
Vous pouvez également sélectionner le dossier correspondant dans l'arborescence de l'atelier, puis cliquer sur le bouton Nouveau.
Guide de l'utilisateur de Crystal Reports 2008 SP1 601
Utilisation des formules
22
Spécification des formules
L'éditeur ou la boîte de dialogue approprié(e) s'ouvre.
Arborescence de l'atelier
L'arborescence de l'atelier contient des dossiers pour chaque type de formule que vous pouvez créer dans Crystal Reports. Elle inclut également des dossiers pour les fonctions personnalisées et les expressions SQL. Si l'atelier apparaît à la suite de l'utilisation d'une commande spécifique (par exemple, la commande Enregistrement du sous-menu Formules de sélection), le dossier correspondant dans l'arborescence est sélectionné et la version appropriée de l'Editeur de formule s'ouvre.
Développez l'arborescence d'un dossier pour voir les formules existantes.
Vous pouvez ajouter des formules et modifier ou supprimer, au besoin, des formules existantes.
Conseil :
L'arborescence de l'atelier peut être ancrée. Par défaut, elle est ancrée dans la partie gauche de l'Atelier de formules, mais vous pouvez l'ancrer manuellement à droite. En mode flottant, vous pouvez faire glisser l'arborescence vers n'importe quel emplacement de l'atelier.
Boutons Atelier de formules
La barre d'outils principale de l'Atelier de formules se compose de trois barres d'outils plus petites. Chacune d'elles contient un ensemble de boutons se rapportant à des actions spécifiques : utilisation de l'Atelier de formules dans sa globalité, utilisation de l'arborescence de l'atelier ou utilisation d'un éditeur.
Selon la tâche que vous effectuez, les boutons individuels sont disponibles ou non. Chaque barre d'outils peut être déplacée et ancrée selon vos besoins.
Les boutons de la barre d'outils générale de l'Atelier de formules ont les fonctions suivantes :
602 Guide de l'utilisateur de Crystal Reports 2008 SP1
Utilisation des formules
Spécification des formules
22
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.
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.
Active soit la boîte de dialogue
Editeur de fonction personnalisée, soit la boîte de dialogue Propriétés des fonctions personnalisées. 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.
Guide de l'utilisateur de Crystal Reports 2008 SP1 603
Utilisation des formules
22
Spécification des formules
Ouvre l'aide en ligne de la boîte de dialogue Atelier de formules.
Les boutons de la barre d'outils de l'arborescence de l'atelier de l'Atelier de formules ont les fonctions suivantes :
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 le noeud 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 de rapport si aucune formule n'est associée à ces objets.
Ouvre la boîte de dialogue Ajouter les fonctions personnalisées au référentiel pour vous permettre de sélectionner le référentiel dans lequel ajouter la fonction personnalisée.
Ajoute la fonction personnalisée du référentiel sélectionné au rapport.
604 Guide de l'utilisateur de Crystal Reports 2008 SP1
Utilisation des formules
Spécification des formules
22
Les boutons de la barre d'outils de l'Editeur d'expression de l'Atelier de formules ont les fonctions suivantes :
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 de rapport 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.
Guide de l'utilisateur de Crystal Reports 2008 SP1 605
Utilisation des formules
22
Spécification des formules
606 Guide de l'utilisateur de Crystal Reports 2008 SP1
Va au signet suivant.
Va au signet précédent.
Supprime tous les signets de la formule en cours.
Réorganise toutes les arborescences de champs de rapport, de fonctions et d'opérateurs par ordre alphabétique.
Masque ou affiche l'arborescence de champs de rapport.
Remarque :
Ce bouton n'est pas disponible pour les fonctions personnalisées.
Masque ou affiche l'arborescence de fonctions.
Masque ou affiche l'arborescence d'opérateurs.
Masque ou affiche les résultats d'une formule de recherche globale.
Permet de sélectionner la syntaxe
Crystal ou la syntaxe Basic pour votre formule.
Utilisation des formules
Spécification des formules
22
Vous permet de sélectionner Exceptions pour les valeurs nulles comme mode de traitement des valeurs nulles dans vos données.
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.
Utilisation de l'Editeur de formule
L'Editeur de formule est un composant de l'Atelier de formules. Il permet de créer et de modifier le contenu des formules.
Sections de l'Editeur de formule
L'Editeur de formule contient quatre fenêtres principales.
Fenêtre Description du contenu
Champs du rapport
Les champs du rapport contiennent tous les champs de base de données accessibles pour votre rapport. Ils contiennent également les formules et groupes déjà créés pour le rapport.
Guide de l'utilisateur de Crystal Reports 2008 SP1 607
Utilisation des formules
22
Spécification des formules
Fenêtre
Fonctions
Opérateurs
Fenêtre de texte de formule
Description du contenu
Les fonctions sont des procédures déjà écrites 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 majuscules.
Cette fenêtre contient également les fonctions personnalisées.
Les opérateurs sont en quelques 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
à.
Zone dans laquelle la formule est créée.
Choix de la syntaxe
La Barre d'outils de l'Editeur d'expression de l'Atelier de formules contient une liste déroulante vous permettant de choisir soit la syntaxe Crystal, soit la syntaxe Basic pour la formule que vous créez.
Remarque :
Changer la syntaxe de Crystal en Basic ou inversement modifiera la liste des fonctions dans la fenêtre Fonctions ainsi que la liste des opérateurs
608 Guide de l'utilisateur de Crystal Reports 2008 SP1
Utilisation des formules
Spécification des formules
22 dans la fenêtre Opérateurs. Les fonctions et les opérateurs sont différents d'une syntaxe à l'autre.
Les champs disponibles du rapport restent les mêmes, puisque ces champs peuvent être utilisés avec chacune des deux syntaxes.
Définition de la syntaxe par défaut
Lorsque vous lancez l'Editeur de formule, la syntaxe Crystal s'affiche par défaut. Si vous souhaitez modifier la syntaxe par défaut, sélectionnez Options dans le menu Fichier, puis cliquez sur l'onglet Reporting. Sélectionnez la syntaxe de votre choix dans la liste déroulante des langages de formule et cliquez sur OK. Lorsque vous ouvrez l'Editeur de formule, la syntaxe sélectionnée s'affiche par défaut.
Saisie des composants de formule
L'arborescence des champs de rapport, des fonctions et des opérateurs en haut de l'Editeur de formule contient les composants de formule primaires.
Cliquez deux fois sur un composant dans ces arborescences pour l'ajouter
à la formule.
Par exemple, si la syntaxe utilisée est la syntaxe Basic et que vous cliquez deux fois sur Opérateurs > Structures de contrôle > If à plusieurs lignes dans l'arborescence des opérateurs, le texte suivant est transféré vers la fenêtre
Texte de la formule, le curseur se plaçant entre If et Then :
If | Then
ElseIf Then
Else
End If
Le texte ci-dessus vous aide à organiser les différentes parties nécessaires
à l'écriture de la formule.
Boutons de l'Editeur de formule
Voir la partie Barre d'outils de l'Editeur d'expression de la section
Boutons
Atelier de formules
page 602 pour avoir la liste des boutons que vous pouvez utiliser dans l'Editeur de formule.
Guide de l'utilisateur de Crystal Reports 2008 SP1 609
Utilisation des formules
22
Spécification des formules
Changement de la taille de police pour l'Editeur de formule
La boîte de dialogue Options (menu Fichier) vous permet de changer la taille de la police et la couleur d'arrière-plan et de premier plan de texte, les commentaires et les mots clés dans l'Editeur de formule.
Contrôles de touche de l'Editeur de formule
L'Editeur de formule accepte les contrôles de touche suivants :
Combinaisons de clavier Opération effectuée
Alt+B
Alt+C
Alt+F
Alt+M
Alt+O
Alt+P
Alt+S
Ouvre la boîte de dialogue Parcourir pour le champ sélectionné.
Vérifie qu'il n'y a pas d'erreur dans la formule.
Ouvre ou ferme l'arborescence de champs.
Met en commentaire la ligne en cours ou supprime le marquage de mise en commentaire.
Trie le contenu des arborescences.
Ouvre ou ferme l'arborescence d'opérateurs.
Enregistre la formule sans fermer l'Editeur de formule.
610 Guide de l'utilisateur de Crystal Reports 2008 SP1
Combinaisons de clavier
Alt+U
Ctrl+A
Ctrl+C
Ctrl+Fin
Ctrl+F
Ctrl+F2
Ctrl+Maj+F2
Ctrl+Orig
Ctrl+Flèche gauche
Ctrl+N
Utilisation des formules
Spécification des formules
22
Opération effectuée
Ouvre ou ferme l'arborescence de fonctions.
Sélectionne tout.
Copie.
Va à la fin de la dernière ligne de la formule.
Ouvre la boîte de dialogue Rechercher (vous pouvez également cliquer sur les boutons Rechercher ou
Remplacer).
Définit un signet.
Efface tous les signets.
Va au début du fichier.
Va à la première lettre du mot à gauche (+Maj fera la sélection).
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.
Guide de l'utilisateur de Crystal Reports 2008 SP1 611
Utilisation des formules
22
Spécification des formules
Combinaisons de clavier
Ctrl+S
Ctrl+T
Ctrl+Maj+ Tabulation
Ctrl+Tab
Ctrl+V
Ctrl+X
Ctrl+Z
Ctrl+Maj+Z
Ctrl+Espace
Fin
Opération effectuée
Enregistre la formule et ferme l'Editeur de formule.
Dirige le foyer sur la zone de liste des noms de syntaxe.
Dirige le foyer sur la zone de contrôle suivante (ordre inversé de la combinaison Ctrl-Tabulation).
Dirige le foyer sur la zone de contrôle suivante.
Colle la sélection.
Coupe la sélection.
Annule une opération.
Répète une opération.
Complétion automatique de mots clés : affiche la liste des fonctions disponibles.
Va à la fin de la ligne.
612 Guide de l'utilisateur de Crystal Reports 2008 SP1
