Project

General

Profile

Indicateurs graphiques et paramètres » History » Revision 2

Revision 1 (Simon, 01/12/2021 10:36 AM) → Revision 2/4 (Simon, 01/12/2021 10:37 AM)

h1. Indicateurs : graphiques et paramètres 

 Il est possible de partager l'évolution des valeurs d'un indicateur depuis n'importe quelle page de l'application et même depuis un site extérieur. 

 Un graphique est visible par l'appel de la page _public/get-chart.php?id=1_ 

 Seul l'_id_ est un paramètre obligatoire. Il indique l'indicateur que nous souhaitons voir représenté. 


 h2. personnalisation d'un graphique 

 Plusieurs paramètres peuvent être passés dans le but de personnaliser le graphique. 

 Il est possible de spécifier les dimensions du graphique en passant les paramètres _width_ / _height_. 
 Ceux-ci peuvent être exprimés en pixels ('px') ou pourcentage ('%'). La valeur 'auto' peut êre passée. 

 Exemples d'URL valides : 
 <pre><code class="text"> 
 public/get-chart.php?id=1&width=100%&height=600 

 public/get-chart.php?id=1&width=auto&height=600 

 public/get-chart.php?id=1&width=800&height=600&unit=px 

 public/get-chart.php?id=1&width=800&height=600 

 public/get-chart.php?id=1&width=800&height=600&notitle=1 
 </code></pre> 


 Si aucune unité n'est fournie, le pixel sera pris comme unité par défaut. 

 Le paramètre optionnel _unit_ sert à définir une unité. Il prend la valeur 'px' ou '%'. 

 Le paramètre optionnel _notitle_, s'il prend la valeur '1' précisera à l'application de ne pas afficher le titre du graphique. 

 Le paramètre optionnel _type_ précise le type de graphique. S'il n'est pas passé, le type stocké en base de données s'applique automatiquement. Les valeurs suivantes peuvent être passées : 'line', 'area', column'. 

 Vous pouvez aussi choisir l'échelle de mesure en passant la variable _scale_. Par défaut, c'est la valeur de l'échelle racine qui s'applique (id = 1). 

 h1. Le cas des indicateurs multi-valeurs 

 Les indicateurs multi-valeurs peuvent être représentés de deux manières : 
 #    en suivant leur évolution annuelle. Les paramètres optionnels présentés au-dessus s'appliquent à ce type de représentation (à l'exception du _type_) 
 #    en détaillant chacun des postes renseignés en ciblage d'une année donnée. Dans ce deuxième cas, il est impératif de fournir l'année souhaitée en passant le paramètre _year_. Le type de représentation s'adapte. Par défaut, une représentation en 'donut' s'applique. Vous avez la possibilité de choisir parmi ces types :    'donut', 'pie', treemap'.  

 !donutchart.png! 

 !piechart.png! 

 !treemapchart.png! 

 Lorsqu'un graphique est de type 'treemap', vous avez la possibilité de passer en complément les paramètres _color1_ et _color2_ pour générer un gradient de couleur. *Seules les valeurs hexadécimales sont supportées, sans le carcatère '#' initial.* 

 Exemples d'URL valides : 
 <pre><code class="text"> 

 public/get-chart.php?id=1&type=donut&year=2019&width=100%&notitle=1 

 public/get-chart.php?id=1&type=treemap&year=2019&notitle=1&color1=E6CFF7&color2=BB93D8 
 </code></pre> 



 h1. Voir aussi 

 * [[Personnaliser les graphiques]]