Caractéristiques

Casse

Le contenu des fichiers de mise en forme est sensible à la casse. Attention de respecter la distinction entre minuscules et majuscules.


Types de base

Les chaînes de caractères doivent être protégées par des doubles-cotes "".

"gb_label_string": "Salut !"

Numériques : ne pas saisir de doubles-cotes autour des valeurs numériques.

"gb_label_size": 8

Booléen : true ou false

"gb_xlbold": true
"gb_xlbold": true

Les tableaux sont composés d'une liste d'éléments séparés par des virgules. La liste est protégée par des crochets [].

"gb_frame_internalmargin":[1.5,0.8,5,0.8]

Couleurs

Les couleurs peuvent être définies de trois manières différentes :

  • par code hexadecimal de #000000 (noir) à #FFFFFF (blanc)

  • par % de saturation RGB (style FME) : 0,0,0 (noir) à 1,1,1 (blanc)

  • par nom de couleur : Liste des couleurs disponibles

Les trois définitions ci-dessous sont équivalentes :

"gb_color":"#800080"
"gb_color":"0.5019,0,0.5019"
"gb_color":"purple"

Encodage

Les layout files doivent être encodés en UTF-8.


Chemins

Les chemins vers les fichiers (images, librairies vectorielles) peuvent être définis de manière absolue ou bien relative par rapport au répertoire de travail. L'emplacement du répertoire de travail varie en fonction du mode d'exécution du projet : FME Desktop, FME Server, Ligne de commande .bat ou .sh, GTF... Il correspond à l'emplacement du projet .fmw lorsque celui-ci est lancé dans FME-Workbench.

Il est possible de vérifier l'emplacement du répertoire de travail en consultant le fichier de log du projet FME.

FME Configuration: Current working folder is C:\git\graphbuilder\samples\school

Sous Windows, les délimiteurs de répertoires "" doivent être doublés ou bien remplacés par des "/".
Exemple : Si le répertoire de travail est C:\data, les quatre notations ci-dessous peuvent être utilisées :

"gb_image_dir": "C:\\data\\biology"
"gb_image_dir": "C:/data/biology"
"gb_image_dir": ".\\biology"
"gb_image_dir": "./biology"

Nous recommandons l'utilisation du délimiteur "/" qui fonctionne sur toutes les plateformes.


Commentaires

Il n'est pas possible d'insérer des commentaires dans les fichiers de mise en forme.


Attributs

Il est possible d'attribuer à un mot-clef la valeur d'un attribut d'une entité du graphe en entourant le nom de l'attribut par deux doubles accolades : {{ et }}. Il est nécessaire de respecter la casse de l'attribut. Exemple :

"gb_label_string": "{{name}}"

Attributs de format FME

Il est possible d'ajouter dans la définition des objets graph, style et layout des mots clefs supplémentaires non décrits dans cette documentation et non utilisés par les Transformers de l'extension GraphBuilder pour FME.

Ces mots-clefs vont être transformés en attribut de format de l'entité FME sortant du Transformer GraphLayouter et peuvent ainsi influer sensiblement sur la représentation finale.

L'exemple ci-dessous montre l'utilisation des attributs de format autocad_entity et autocad_block_name pour générer une entité de type "autocad_insert" qui pourra être exploitée par le writer Autocad DWG de FME pour créer des blocks dans le fichier final au lieu d'un simple point.

        "layout":[{
            "gb_layout_type":"point",
            "gb_color":"#E6BCBC",
            "autocad_entity":"autocad_insert",
            "autocad_block_name":"E_P03"
        },

Note : l'usage des attributs de format n'est d'aucun intérêt dans les fichiers de mise en forme destinés au Transformer GraphLayouterForExcel.

Pour en savoir plus, consultez la documentation des Writers de FME