A partir de la version Aruba, vu les possibilités graphiques offertes par l'éditeur de rapports, ce qui suit ne s'applique plus. Tous les graphiques ont été regroupés dans l'éditeur de rapports.
Mercator 6.0 permet la gestion des graphiques de type :
- tarte
- colonnes (empilables)
- lignes
Ces graphes sont disponibles dans les signalétiques et dans les documents libres.
Dans les signalétiques, un graphe est ajouté, en mode "Outils / Ecrans / Signalétiques / Paramétrage", via un clic droit suivi de "Add chart".
Dans les documents libres, une sortie de type "graphique" est sélectionnée via le déroulant de sélection de type de sortie "Document / Fichier / Graphique".
Conception de la requête SQL sous-jacente
Chaque graphique est entièrement déterminé par la requête SQL qui le pilote. Cette requête SQL doit obligatoirement répondre aux exigences suivantes :
- Graphique de type "tarte" : la première colonne produite par la requête doit être de type "caractères" et contenir le libellé de chacun des secteurs de la tarte. La seconde colonne doit être de type numérique et contenir la valeur déterminant la taille des secteurs.
- Graphique de type "colonnes" : ce type de graphique est multi-series. Les données des différentes séries seront "empilées" par valeur d'abscisse. La première colonne produite par la requête doit être de type "caractères" et contenir le libellé des valeurs d'abscisse. Les colonnes 2 et suivantes correspondent respectivement aux séries de données 1 et suivantes. Elles reprennent les valeurs en ordonnées pour chacune des séries.
- Graphique de type "lignes" : ce type de graphique est multi-series. Les données de chaque série feront l'objet d'une courbe. La première colonne produite par la requête doit être de type "caractères" et contenir le libellé des valeurs d'abscisse. Les colonnes 2 et suivantes correspondent respectivement aux séries de données 1 et suivantes. Elles reprennent les valeurs en ordonnées pour chacune des séries.
Utilisation des graphiques
Mercator 6.0 contient un éditeur de graphiques. Il est accessible par le menu "Fenêtres". Les graphiques générés par le biais des documents libres sont envoyés vers cet éditeur de graphiques. Les fonctionnalités des graphiques incrustés dans un signalétique répondent toutefois aux mêmes fonctionnalités.
La partie "grise" de l'écran sous le graphique répond au clic-droit de la souris. Ceci permet de déclencher un menu contextuel, dont les fonctions s'appliqueront au graphique :
- mode souris : ceci permet de déterminer le comportement du clic-gauche de la souris sur le graphique même
- mise en page (comprend une prévisualisation)
- imprimer
- copier : dans le but de pouvoir coller directement l'image du graphique dans une autre application
- exporter : création d'un fichier JPEG, BMP ou TIFF contenant le graphique
- sauvegarder : création d'un fichier MCH (Mercator Chart) permettant de rouvrir ultérieurement le graphique dans l'éditeur de graphique et d'en modifier les propriétés. Ce type de fichier permet aussi l'envoi par mail d'un graphique à un destinataire qui l'ouvrira dans son éditeur de graphique inclus dans Mercator.
- Propriétés : accès aux propriétés générales du graphique
Gestion des couleurs
Le bouton "palette de couleurs" permet de déterminer les couleurs qui seront utilisées pour la génération du graphique. Par défaut, la liste des couleurs n'en contient qu'une seule (gris). Le bouton "baguette magique" permet de créer de façon automatique une palette de couleurs.
Modules
Dans le sous-menu " Outils/ Écrans Signalétiques/ Paramétrage ", il est possible d'associer aux graphiques un module qui va modifier leurs paramètres lors de leur exécution.
Pour ce faire, il faut ouvrir l'écran des propriétés du graphique en faisant un clic-droit dessus et cliquer sur le bouton à droite du bouton SQL.
Ci-dessous se trouvent quelques exemples de ce type de script qui peuvent bien évidement être combinés.
Il est à noter que si le code dépasse un certain nombre de lignes, il faut changer dans la table "CTL" le type du champ "gridscript" et le mettre à "Mémo". Attention, cette modification dans une version client-serveur de Mercator entraine la perte des informations contenues dans ce champ.
- Déplacer la légende :
legend0=.LegendCollection.GetAt(0)
legend0.MarginX = 15.00
legend0.MarginY = 5.00
Les valeurs mentionnées correspondent à un pourcentage.
Ce code permet de placer la légende à gauche.
- Supprimer la légende :
.LegendCollection.RemoveAll
- Modifier la police de la légende :
legend0=.LegendCollection.GetAt(0)
legend0.TextEx.Font.Italic = .F.
legend0.TextEx.Font.Name = "Arial"
legend0.TextEx.Font.Size = 8
legend0.TextEx.Font.Strikethrough = .F.
legend0.TextEx.Font.Underline = .F.
- Ajouter un titre à la légende :
legend0=.LegendCollection.GetAt(0)
legend0.Header = "MON TITRE"
legend0.HeaderTextEx.Font.Italic = .F.
legend0.HeaderTextEx.Font.Name = "Arial"
legend0.HeaderTextEx.Font.Size = 8
legend0.HeaderTextEx.Font.Strikethrough = .F.
legend0.HeaderTextEx.Font.Underline = .F.
- Modifier l'inclinaison du graphique :
.Get3DView.Rotation = 300.00
.Get3DView.Elevation = 10.00
Les valeurs par défaut sont 270.00 pour la rotation et 0.00 pour l'élévation.
- Modifier le zoom de la vue :
.Get3DView.Zoom = 80.00
La valeur mentionnée correspond à un pourcentage (par défaut : 100).
- Ajouter un titre sur les axes :
&& sur l'ordonnée
C0LeftAxis = .Axes(0)
C0LeftAxis.Title = "MON TITRE"
C0LeftAxis.TitleTextEx.Font.Italic = .F.
C0LeftAxis.TitleTextEx.Font.Name = "Arial"
C0LeftAxis.TitleTextEx.Font.Size = 14
C0LeftAxis.TitleTextEx.Font.Strikethrough = .F.
C0LeftAxis.TitleTextEx.Font.Underline = .F.
&& sur l'abscisse
C0CategoriesAxis = .Axes(4)
C0CategoriesAxis.Title = "MON TITRE"
C0CategoriesAxis.TitleTextEx.Font.Italic = .F.
C0CategoriesAxis.TitleTextEx.Font.Name = "Arial"
C0CategoriesAxis.TitleTextEx.Font.Size = 14
C0CategoriesAxis.TitleTextEx.Font.Strikethrough = .F.
C0CategoriesAxis.TitleTextEx.Font.Underline = .F.
- Ajouter un titre au graphique :
.LabelCollection.RemoveAll
.LabelCollection.Add
.LabelCollection.GetAt(0).Text = "Mon Titre"
.LabelCollection.GetAt(0).OriginOffsetY = 45.00
.LabelCollection.GetAt(0).OriginOffsetX = 0.00
.LabelCollection.GetAt(0).TextEx.Font.Charset = 1
.LabelCollection.GetAt(0).TextEx.Font.Italic = .F.
.LabelCollection.GetAt(0).TextEx.Font.Name = "Arial"
.LabelCollection.GetAt(0).TextEx.Font.Size = 16
.LabelCollection.GetAt(0).TextEx.Font.Strikethrough = .F.
.LabelCollection.GetAt(0).TextEx.Font.Underline = .T.
Pour déplacer le titre verticalement, il faut modifier le paramètre "OriginOffsetY".