Gestion des fondations de données
Utilisation des fondations de données
7
Insertion d'une formule
Très souvent, les données nécessaires à une fondation de données existent déjà dans les champs d'une base de données. Par exemple, pour créer une liste ordonnée, vous devez sélectionner et placer les champs appropriés dans un élément d'entreprise (un élément d'entreprise étant un ensemble de champs basés sur une fondation de données).
Toutefois, il est parfois nécessaire d'ajouter à un élément d'entreprise des données qui ne se trouvent pas dans les champs de données. Lorsque ce cas se présente, il est nécessaire de créer une formule. Pour calculer par exemple le nombre de jours nécessaires au traitement de chaque commande d'un client, il vous faut une formule qui détermine le nombre de jours qui s'écoulent entre la date de la commande et la date de la livraison.
Pour créer des formules dans le Gestionnaire de vues d'entreprise, utilisez l'Editeur de formule. La syntaxe et les composants de formule sont identiques
à ceux utilisés pour créer une formule dans Crystal Reports.
Exemples d'utilisation courante des formules
Il existe de nombreuses possibilités d'utilisation pour les formules. Si une manipulation de données particulière est nécessaire, elle peut être effectuée au moyen des formules.
Création des champs calculés à ajouter à votre rapport
Pour calculer le prix avec une remise de 15 %:
Exemple de syntaxe Crystal :
{Orders_Detail.Unit Price}*.85
Exemple de syntaxe Basic : formula = {Orders_Detail.Unit Price}*.85
Mise en forme du texte dans un rapport
Pour mettre en majuscules toutes les valeurs du champ contenant le nom du client :
Utilisation des vues d'entreprise 165
Gestion des fondations de données
7
Utilisation des fondations de données
Exemple de syntaxe Crystal :
UpperCase ({Customer.Customer Name})
Exemple de syntaxe Basic : formula = UCase ({Customer.Customer Name})
Extraction d'une ou de plusieurs parties d'une chaîne de texte
Pour extraire la première lettre du nom de client :
Exemple de syntaxe Crystal :
{Customer.Customer Name} [1]
Exemple de syntaxe Basic : formula = {Customer.Customer Name} (1)
Extraction des parties d'une date
Pour déterminer le mois pendant lequel une commande a été passée :
Exemple de syntaxe Crystal :
Month ({Orders.Order Date})
Exemple de syntaxe Basic : formula = Month ({Orders.Order Date})
Utilisation d'une fonction personnalisée
Pour convertir 500 $ US en dollars canadiens :
Exemple de syntaxe Crystal : cdConvertUSToCanadian (500)
Exemple de syntaxe Basic : formula = cdConvertUSToCanadian (500)
166 Utilisation des vues d'entreprise
Gestion des fondations de données
Utilisation des fondations de données
7
Syntaxe et composants de formule
Les formules sont constituées de deux parties essentielles : les composants et la syntaxe. Les composants sont les éléments à ajouter pour créer la formule, alors que la syntaxe constitue l'ensemble des règles à suivre pour l'organisation des composants.
Composants de formule
La création d'une formule dans le Gestionnaire de vues d'entreprise est similaire à la création d'une formule dans une feuille de calcul. Vous pouvez utiliser l'un des composants suivants dans votre formule :
Champs
Exemple : {clients.NOM DU CLIENT}, {clients.VENTES DE L'ANNEE
DERNIERE}
Nombres
Exemple : 1, 2, 3,1416
Texte
Exemple : "Quantité", ":", "votre texte"
Opérateurs
Exemple : + (addition), / (division), -x (négation)
Les opérateurs correspondent à des actions pouvant être utilisées dans les formules.
Fonctions
Exemple : Round (x), Trim (x)
Les fonctions effectuent des calculs tels que la moyenne, la somme ou le comptage. Toutes les fonctions disponibles sont répertoriées avec leurs arguments et sont regroupées selon leur usage.
Utilisation des vues d'entreprise 167
Gestion des fondations de données
7
Utilisation des fondations de données
Fonctions personnalisées
Exemple : cdPremierJourDuMois, cdJoursFériés
Les fonctions personnalisées permettent de partager et de réutiliser une logique de formule. Elles peuvent être stockées dans le Référentiel
BusinessObjects Enterprise, puis ajoutées à un rapport. Après les avoir ajoutées au rapport, vous pouvez les utiliser dans l'Expert Formule lors de la création de formules.
Structures de contrôle
Exemple : If" et "Select", boucles "For"
Valeurs de champs de groupe
Exemple : Average (chp, chpCond), Sum (chp, chpCond, "condition")
Les valeurs de champs de groupe permettent d'effectuer le résumé d'un groupe. Vous pouvez par exemple utiliser des valeurs de champs de groupe pour déterminer le pourcentage du total général représenté par chaque groupe.
Autres formules
Exemple : {@BénéficeBrut}, {@QUOTA}
Syntaxe de formule
La syntaxe est l'ensemble des règles utilisées pour l'écriture de formules correctes. Voici quelques règles de base :
• Placez les chaînes de texte entre guillemets.
• Placez les arguments entre parenthèses (si possible).
• Les formules référencées sont précédées du signe @.
Syntaxes Crystal et Basic
Lors de la création de formules, vous pouvez utiliser la syntaxe Crystal ou la syntaxe Basic. Presque toutes les formules écrites avec une syntaxe peuvent l'être avec l'autre syntaxe. Les rapports peuvent contenir des formules utilisant la syntaxe Basic ou la syntaxe Crystal.
168 Utilisation des vues d'entreprise
Gestion des fondations de données
Utilisation des fondations de données
7
La syntaxe Crystal est le langage de formules incorporé dans toutes les versions de Crystal Reports.
Si vous êtes familiarisé avec Microsoft Visual Basic ou d'autres versions du langage Basic, la syntaxe Basic vous sera plus familière. La syntaxe Basic est en général basée sur celle de Visual Basic, à ceci près qu'elle possède des extensions pour la prise en charge de la création de rapports.
Si vous connaissez déjà la syntaxe Crystal, vous pouvez continuer à l'utiliser et bénéficier des nouveaux opérateurs, fonctions et structures de contrôle inspirés par Microsoft Visual Basic.
Remarque :
• Vous ne pouvez pas écrire des formules de sélection de groupes et de sélection d'enregistrements à l'aide de la syntaxe Basic.
• La création de rapports n'est pas ralentie par l'utilisation de la syntaxe
Basic. Les rapports utilisant les formules en syntaxe Basic peuvent être exécutés sur tout ordinateur sur lequel Crystal Reports est exécuté.
• L'utilisation de formules en syntaxe Basic n'implique en aucune façon la diffusion de fichiers supplémentaires avec vos rapports.
Pour en savoir plus
• Pour en savoir plus sur la syntaxe Basic, voir Création de formules avec la syntaxe Basic dans l'aide en ligne de Crystal Reports.
• Pour en savoir plus sur la syntaxe Crystal, voir Création de formules avec la syntaxe Crystal dans l'aide en ligne de Crystal Reports.
Fenêtres de l'Editeur de formule
L'Editeur de formule se compose de quatre fenêtres principales situées sous sa barre d'outils.
Utilisation des vues d'entreprise 169
Gestion des fondations de données
7
Utilisation des fondations de données
Fenêtre
Champs du rapport
Fonctions
Opérateurs
Fenêtre de texte de formule
Description du contenu
Les champs de rapport contiennent tous les champs de base de données disponibles pour votre fondation de données. Ils contiennent également les formules et les groupes déjà créés pour la fondation de données.
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
à.
C'est dans cette fenêtre que vous créez votre formule. Vous pouvez
également voir votre formule dans la fenêtre de l'Explorateur de propriétés.
170 Utilisation des vues d'entreprise
Gestion des fondations de données
Utilisation des fondations de données
7
Choix de la syntaxe
La barre d'outils de l'Editeur de formule contient une liste dans laquelle vous pouvez sélectionner la syntaxe Crystal ou la syntaxe Basic pour créer votre formule. Par défaut, c'est la syntaxe Crystal qui est sélectionnée.
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. En revanche, les champs disponibles du rapport resteront identiques car ils peuvent être utilisés avec chacune des deux syntaxes.
Saisie des composants de formule
Les arborescences de champs de rapport, de fonctions et d'opérateurs situées en haut de l'Editeur de formule contiennent les principaux composants de formule. Cliquez deux fois sur un composant dans ces arborescences pour l'ajouter à la formule.
Par exemple, si en syntaxe Basic, vous cliquez deux fois sur Opérateurs >
Structures de contrôle > Do While c s Loop dans l'arborescence des opérateurs, le texte suivant apparaît dans la fenêtre de saisie de la formule, avec le curseur placé entre Do While et Loop :
Do While
Loop
Création d'une formule
Vous devez créer et définir la formule au niveau de la fondation de données afin de pouvoir l'ajouter à vos éléments d'entreprise.
Pour créer une formule
1.
Dans le menu Insertion, sélectionnez Insérer une formule.
Utilisation des vues d'entreprise 171
Gestion des fondations de données
7
Utilisation des fondations de données
Remarque :
Vous pouvez aussi cliquer avec le bouton droit de la souris sur
Formules dans l'Explorateur d'objets et sélectionner Insérer une formule.
Vous pouvez également cliquer sur l'icône Insérer une formule de la barre d'outils.
L'Editeur de formule s'affiche.
2.
Dans la barre d'outils de l'Editeur de formule, sélectionnez Syntaxe
Crystal ou Syntaxe Basic.
Pour en savoir plus sur la syntaxe à utiliser, voir
Choix de la syntaxe
page 171.
3.
Dans la deuxième liste déroulante, indiquez l'une des valeurs suivantes :
• Sélectionnez Exceptions pour les valeurs nulles afin que la formule ne tienne pas compte des valeurs nulles.
• Choisissez Zéros pour les valeurs nulles afin que la formule traite les valeurs nulles comme des valeurs égales à zéro.
4.
Entrez la formule en saisissant ses composants ou en les sélectionnant depuis les arborescences de composants.
172 Utilisation des vues d'entreprise
Gestion des fondations de données
Utilisation des fondations de données
7
5.
Cliquez sur Vérifier pour vous assurer que la formule ne contient pas d'erreur.
6.
Résolvez les erreurs de syntaxe que le Vérificateur de Formule a trouvées.
7.
Lorsque la syntaxe est correcte, cliquez sur Appliquer pour enregistrer la formule.
Lorsque vous créez un élément d'entreprise, vous disposez alors d'un certain nombre de formules enregistrées dans la fondation de données.
Mise à jour d'une formule à l'aide de l'Explorateur de propriétés
L'Explorateur de propriétés affiche toutes les propriétés qui peuvent être modifiées pour la formule sélectionnée dans l'Explorateur d'objets.
•
Nom
Nom de la formule.
•
Description
Description que vous avez saisie pour la formule.
•
Type de champ
Type du champ de données.
•
Syntaxe de la formule
Indique si la formule a été créée à partir de la syntaxe Crystal ou de la syntaxe Basic.
•
Texte de la formule
Contenu de votre formule.
•
Droits
Droits des utilisateurs et groupes d'utilisateurs associés à la formule. Pour mettre les droits à jour, sélectionnez la cellule Droits, puis cliquez sur le bouton "...". Dans la boîte de dialogue Modifier les droits, vous pouvez spécifier si les utilisateurs ou les groupes d'utilisateurs peuvent ou non visualiser les données du champ. Ce droit est explicitement accordé ou refusé.
Utilisation des vues d'entreprise 173
Gestion des fondations de données
7
Utilisation des fondations de données
Définition des droits d'accès à une formule
En modifiant les droits d'accès des utilisateurs ou groupes à une formule dans une fondation de données, vous vous assurez que seuls ces utilisateurs ou groupes ont accès à cette formule dans la fondation de données. Ainsi, lorsqu'un utilisateur crée un élément d'entreprise, il ne peut afficher et ajouter que les formules auxquelles il a accès.
Remarque :
Pour pouvoir modifier les paramètres de sécurité d'une formule, vous devez d'abord enregistrer la fondation de données dans le Référentiel
BusinessObjects Enterprise.
Les droits d'accès aux objets Business Views dépendent des droits d'accès aux dossiers correspondants. Lorsque vous définissez un droit particulier sur un dossier, tous les objets de ce dossier héritent de ce droit. De la même manière, tous les objets d'une fondation de données héritent des mêmes droits d'accès que ceux définis au niveau fondation de données. Ainsi, si un utilisateur n'est pas autorisé à modifier les droits définis pour une fondation de données, il ne pourra pas modifier ceux spécifiés pour une formule. Pour en savoir plus sur l'héritage des droits, voir
Utilisation de l'héritage à votre avantage
page 282.
Pour appliquer des paramètres de sécurité à une formule
1.
Dans l'Explorateur d'objets, cliquez avec le bouton droit de la souris sur la formule à laquelle vous souhaitez appliquer des paramètres de sécurité et sélectionnez Modifier les droits.
Conseil :
Vous pouvez aussi sélectionner la cellule des droits dans l'Explorateur de propriétés, puis cliquer sur le bouton "...". Ou sélectionner Modifier les droits dans le menu Edition.
La boîte de dialogue Modifier les droits apparaît.
174 Utilisation des vues d'entreprise
Gestion des fondations de données
Utilisation des fondations de données
7
2.
Attribuez le droit à un utilisateur ou groupe d'utilisateurs en activant la case à cocher appropriée dans la colonne suivante :
• Visualiser les données du champ
Ce droit détermine si un utilisateur ou groupe peut voir la formule et les données qui lui sont associées. Vous pouvez accorder ou refuser ce droit de manière explicite.
Remarque :
•
• Lorsque la case à cocher en regard du droit est désactivée, le droit est refusé à l'utilisateur ou au groupe d'utilisateurs ; lorsque la case
à cocher est activée, le droit est attribué à l'utilisateur ou au groupe d'utilisateurs ; lorsque la case à cocher est ombrée, le droit est hérité.
Notez également que, même si un droit apparaît comme étant attribué, il peut être refusé une fois l'héritage pris en compte.
Cliquez sur le bouton Aperçu pour afficher les paramètres de sécurité finaux de la formule avec l'héritage appliqué. Le
Gestionnaire de vues d'entreprise résout le résultat net des paramètres de sécurité actuels et affiche les droits nets.
3.
Pour ajouter un autre utilisateur ou groupe d'utilisateurs, cliquez sur Ajouter des utilisateurs ou Ajouter des groupes.
4.
Définissez les droits du nouvel utilisateur ou nouveau groupe.
5.
Cliquez sur OK.
Utilisation des vues d'entreprise 175
