Formules de recherche
Les formules de recherche vous aident à rechercher les données dans un rapport. Tout comme pour les formules de sélection, celles-ci ne sont habituellement pas saisies directement, mais les critères de recherche sont au lieu de cela spécifiés au moyen de l'Expert Recherche. Crystal Reports génère la formule. Vous pouvez également modifier manuellement ces formules, mais vous devez utiliser la syntaxe Crystal.
Remarque
Si vous connaissez déjà la syntaxe Basic, vous n'aurez besoin que d'un minimum de connaissance de la syntaxe Crystal pour pouvoir modifier la plupart des formules de recherche et de sélection.
Formules de condition de total cumulé
Les formules de condition de total cumulé vous permettent de définir la condition selon laquelle le total cumulé sera évalué ou réinitialisé. Voir
Création des totaux cumulés conditionnels
[page 184].
Formules d'alerte
Les formules d'alerte vous permettent de définir des conditions et des messages pour les alertes de rapport. Voir
A propos des alertes de rapport
[page 408].
21.4.1 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.
21.4.1.1 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.
420
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
Vous pouvez ouvrir l'Atelier de formules avant de commencer à ajouter des types spécifiques de formules.
21.4.1.1.1 Pour accéder à l'Atelier de formules
1. Dans le menu
Rapport
, cliquez sur
Atelier de formules
.
Astuce
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.
créer.
Cliquez sur
Nouveau
, puis sélectionnez dans la liste qui s'affiche le type de formule que vous souhaitez
Astuce
Vous pouvez également sélectionner le dossier correspondant dans l'arborescence de l'atelier, puis cliquer sur le bouton Nouveau.
L'éditeur ou la boîte de dialogue approprié(e) s'ouvre.
21.4.1.2 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.
Astuce
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.
21.4.1.3 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
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
421
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 :
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.
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 nœud sélectionné dans l'arborescence de l'atelier. Fonctionne également avec des sélections multiples de nœuds.
422
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
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.
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.
Va au signet suivant.
Va au signet précédent.
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
423
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.
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.
21.4.2 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.
21.4.2.1 Sections de l'Editeur de formule
L'Editeur de formule contient quatre fenêtres principales.
424
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
Fenêtre
Champs du rapport
Fonctions
Opérateurs
Fenêtre de texte de formule
Description du contenu
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.
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 quelque sorte les "verbes d'action" 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.
21.4.2.2 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 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.
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
425
21.4.2.3 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.
21.4.2.4 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 421] pour avoir la liste des boutons que vous pouvez utiliser dans l'Editeur de formule.
21.4.2.5 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èreplan et de premier plan de texte, les commentaires et les mots clés dans l'Editeur de formule.
21.4.2.6 Contrôles de touche de l'Editeur de formule
L'Editeur de formule accepte les contrôles de touche suivants :
Combinaisons de clavier
Alt+B
Alt+C
Alt+F
Alt+M
Action effectuée
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.
426
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
Combinaisons de clavier
Alt+O
Alt+P
Alt+S
Alt+U
Ctrl+A
Ctrl+C
Ctrl+Fin
Ctrl+F
Ctrl+F2
Ctrl+Maj+F2
Ctrl+Orig
Ctrl+Flèche gauche
Ctrl+N
Ctrl+S
Ctrl+T
Ctrl+Maj+ Tabulation
Ctrl+Tab
Ctrl+V
Ctrl+X
Ctrl+Z
Ctrl+Maj+Z
Ctrl+Espace
Guide de l'utilisateur de SAP Crystal Reports 2011
Utilisation des formules
Action effectuée
Trie le contenu des arborescences.
Ouvre ou ferme l'arborescence d'opérateurs.
Enregistre la formule sans fermer l'Editeur de formule.
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.
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 action.
Répète une action.
Complétion automatique de mots clés : affiche la liste des fonctions disponibles.
©
2013 SAP AG ou société affiliée SAP. Tous droits réservés.
427
