GRAPHE

Note de compatibilité : A compter de 4D v14, la commande GRAPHE fonctionne uniquement avec une variable image en premier paramètre. La syntaxe obsolète utilisant une zone de graphe (4D Chart) n’est plus prise en charge.

La commande GRAPHE crée un graphe dans une variable image à partir de valeurs provenant de tableaux.

Les graphes générés par cette commande sont dessinés via le moteur de rendu SVG intégré. Ils bénéficient des fonctions d'interface associées aux variables images : menu contextuel en mode Application (permettant notamment le choix du format d'affichage), barres de défilement, etc.

Note : SVG (Scalable Vector Graphics) est un format de fichier graphique vectoriel (extension .svg). Basé sur le XML, ce format est largement répandu et peut être notamment affiché par les navigateurs Web. Pour plus d'informations, reportez-vous à http://www.w3.org.Graphics/SVG/. La commande SVG EXPORTER VERS IMAGE vous permet également de tirer parti du moteur SVG intégré.

Passez dans le paramètre graphImage le nom de la variable image devant afficher le graphe dans le formulaire.

Le second paramètre définit le type de graphe à utiliser. Vous disposez de deux possibilités :

• passer un paramètre graphNum de type Entier long (toutes versions de 4D) : dans ce cas, vous devez passer un nombre entre 1 et 8. Les différents types de graphes disponibles sont listés dans l'exemple présenté plus bas. Une fois le graphe créé, vous pouvez modifier son type en modifiant la valeur de graphNum et en exécutant de nouveau la commande GRAPHE. Vous pouvez par la suite modifier certaines caractéristiques du graphe en appelant la commande PARAMETRES DU GRAPHE. Voir Exemple 1.
• passer un paramètre graphParams de type Objet (versions 4D 64 bits uniquement, hormis 4D Server Windows 64 bits) : dans ce cas, vous devez passer un objet qui contient les diverses propriétés du graphe que vous souhaitez définir. Pour cela, vous pouvez utiliser les constantes placées dans le thème "Paramètre des graphes" (cf ci-dessous). Cette syntaxe vous permet de définir le type de graphe ainsi que tous ses paramètres spécifiques (légende, xmin, etc.) en un seul appel. Avec ce principe, vous pouvez sauvegarder les graphes générés en tant qu'images SVG et les afficher dans un navigateur standard tel que FireFox, Chrome, IE ou Safari (les graphes générés sont conformes au SVG standard implémenté dans les navigateurs). En outre, cette syntaxe donne accès à de nombreux paramètres, vous permettant de personnaliser, entre autres, l'espacement entre les barres, les marges, les couleurs de barres, etc. Voir Exemples 2, 3 et 4. Attention, si vous utilisez cette syntaxe, la commande PARAMETRES DU GRAPHE ne doit PAS être appelée. 

Le paramètre xCatégories définit les valeurs qui seront utilisées pour l'axe des X. Vous pouvez passer un champ de type chaîne, Heure, Date, ou un type numérique. Il doit y avoir le même nombre d'éléments de tableau dans xCatégories qu'il y en a dans chaque zValeurs.

Le paramètre zValeurs définit les valeurs à représenter graphiquement. Elles doivent être de type numérique. Vous pouvez passer jusqu'à huit ensembles de données. Les graphes en secteurs ne représentent que le premier zValeurs.

Des IDs spécifiques sont automatiquement attribués aux éléments présents dans le graphe SVG :

Lorsque vous utilisez le paramètre graphParams, vous devez passer un objet qui contient les diverses propriétés du graphe que vous souhaitez définir. Pour cela, vous pouvez utiliser les constantes suivantes, placées dans le thème "Paramètre des graphes" : 

Syntaxe avec graphNum : l'exemple suivant illustre les différents types de graphes que vous pouvez obtenir. Ce code doit être placé dans la méthode formulaire (ou une méthode objet) du formulaire contenant la variable image. A noter que, dans notre exemple, les données représentées sont constantes, ce qui n'est généralement pas le cas :

Les images suivantes représentent les graphes résultants :

• Lorsque vType est égal à 1, vous obtenez un graphe en Colonnes :
  

• Lorsque vType est égal à 2, vous obtenez un graphe en Colonnes proportionnelles :
  

• Lorsque vType est égal à 3, vous obtenez un graphe en Colonnes empilées :
  

• Lorsque vType est égal à 4, vous obtenez un graphe en Lignes :
  

• Lorsque vType est égal à 5, vous obtenez un graphe en Aires :
  

• Lorsque vType est égal à 6, vous obtenez un graphe en Points :
  

• Lorsque vType est égal à 7, vous obtenez un graphe en Secteurs :
  

• Lorsque vType est égal à 8, vous obtenez un graphe en Images :
  
  Note : Les images sont des rectangles simples par défaut.

Syntaxe avec graphParams : Avec l'exemple suivant, vous dessinez un simple graphe en lignes basé sur des valeurs de temps :

Avec les mêmes valeurs, on ajoute des paramètres personnalisés pour obtenir une vue différente :

Dans cet exemple, on personnalise divers paramètres :