7. Production de graphes pour Excel

Il est possible de générer des synoptiques de réseaux de distribution (télécom, eau...) au format Excel en utilisant le transformer GraphLayouterForExcel. Ce transformer reprend les principes de GraphLayouter avec quelques limitations qui sont décrites dans la documentation de GraphLayouterForExcel

Dans GraphLayouterForExcel les coordonnées cartésiennes utilisées pour positionner les noeuds du graphe sont remplacées par des numéros de cellule. Leur valeur est donc forcément entière, positive et limitée à la taille d'un tableau Excel. Cette gestion particulière a conduit à la création de mots-clefs spécifiques pour l'écriture des fichiers de mise en forme destinés à la production de documents Excel.

La mise en page générale du document Excel est définie dans le fichier de mise en forme, au niveau de la déclaration de l'objet graph en début de fichier.

L'exemple ci-dessous illustre les différents mots-clefs permettant d'intervenir sur la définition du document Excel.

_images/frame_excel.png

"gb_output_format": "xlsx",
"gb_graph_xlorigin": [1,1],
"gb_graph_xlinterval": [2,9],
"gb_graph_xlcellheight": 15,
"gb_graph_xlnodecellwidth": 40,
"gb_graph_xledgecellwidth": 15,
"gb_graph_xledgestepwidth": 1,
"gb_graph_xledgetextlocation": -1,
"gb_graph_xlshowgrid": true

Ces valeurs permettent de définir :

  • la position du premier noeud ou noeud racine (gb_graph_xlorigin)

  • l'intervalle horizontal entre deux noeuds successifs d'une même branche et l'intervalle vertical entre deux branches successives (gb_graph_xlinterval)

  • la hauteur des lignes (gb_graph_xlcellheight) en unité Excel.

  • la largeur des colonnes contenant des noeuds (gb_graph_xlnodecellwidth) en unité Excel

  • la largeur des autres colonnes servant à dessiner les arêtes (gb_graph_xledgecellwidth) en unité Excel

  • le nombre de colonnes servant de support au dessin horizontal d'une arête avant de dessiner la partie verticale. Ce paramètre est utilisé pour dessiner une arête entre deux noeuds situés sur des branches différentes. (gb_graph_xledgestepwidth).

  • l'emplacement du texte de l'arête (gb_graph_xledgetextlocation) en nombre de cellules. La valeur 1 indique que le texte doit être inscrit dans la première cellule dessinant l'arête (à droite du noeud source). La valeur 2 correspond à la deuxième cellule etc... Une valeur négative permet d'appliquer le même principe mais en partant du noeud destination. L'utilisation d'une valeur négative permet d'éviter l'écrasement des textes lorsque plusieurs arêtes empruntent le même chemin.

  • si la grille Excel doit être affichée ou non (gb_graph_xlshowgrid)

Remarque : la valeur de l'unité utilisée par Excel varie pour les colonnes et les lignes.