Paramétrer un format indicateur ( fid )

Pour réaliser un tableau de ce type :

• On crée la requête REB, comment l'écrire ?

1) Dans la requête, on doit impérativement alimenter la liste WFResRubrique qui contiendra les données du tableau, avec : WfResRubrique.TEn doit contenir *STRUCTURE WfResRubrique.RubLib doit contenir la liste ordonnée des titres des colonnes ( ils écrasent ceux qu’on entre dans la structure dans l'étape suivante), séparés par CHR(26) WfResRubrique.Cl1 doit contenir la liste ordonnée des formats des colonnes de la forme C/n ou E/n …..séparés par CHR(26) WfResRubrique.Cl2 doit contenir la liste ordonnée des champs de WfresRubrique correspondant aux colonnes de la forme WfResRubrique.champ, séparés par CHR(26). ( C’est les champs qu’on alimente plus bas 👇 ) 2) On peut également alimenter ( c’est pas obligé 😉 ) WfResRubrique.Cl3 avec les classes permettant de colorer chaque colonne, séparés par CHR(26). WfResRubrique.Attributs doit contenir la liste des classes définissant les attributs des titres des colonnes Chaque classe utilisée doit être renseignée dans l’une des feuilles de style rattachées au FID lors de sa définition (voir étape 1 de cette page !👆 ) . WfResRubrique.Attributs contient la liste chainée des classes permettant de personnaliser les cellules. Cette liste doit être donnée de la forme : RefCol=Classe. CHR(59) est le séparateur des colonnes. Dans cet exemple, la couleur de fond de toutes les cellules de la deuxième colonne sera personnalisée. WfResRubrique.NumOrdLig donne l’ordre d’affichage des lignes du tableau. 3) On peut ensuite remplir les données du tableau dans les champs banalisés de la liste WfResRubrique ( RubNum0,1…, RubDat0,1…, RubLog0,1…, RubAlp0,1…). Dans l'étape suivante, quand on va créer la structure, on viendra faire correspondre ces champs avec les colonnes du tableur qu’ils vont venir remplir !

Les couleurs peuvent être données de la forme :

• COU_FOND_numéro de couleur Diapason (voir liste des couleurs dans « A propos »)

• COU_TEXTE_ numéro de couleur Diapason (voir liste des couleurs dans « A propos »)

• On définit la structure de notre tableau :

Une fois la requête créé, on va venir créer les différentes colonnes de notre tableau dans la structure:

• Titre : Titre de la colonne du tableau.

• Style titre : Liste de classes permettant de personnaliser les caractéristiques du titre de la colonne (couleur, police, alignement …). Le séparateur entre deux classes est l’espace. Ces classes doivent appartenir à l’une des feuilles de style référencées sur la définition du FID.

• Type : Type de la zone à afficher.

• Format : Format d’affichage de la zone à afficher.

Pour le type A(lpha) le format I(mage) est disponible.

• Champ : quelle information récupérées dans la liste WFResRubrique, alimentée à l'étape précédente, va-t-on afficher dans cette colonne ?

• Style colonne : Liste de classes permettant de personnaliser les caractéristiques des cellules de la colonne (couleur, police, alignement). Le séparateur entre deux classes est l’espace. Ces classes doivent appartenir à l’une des feuilles de style référencées sur la définition du FID.

Pour réaliser un histogramme de ce type :

• On crée la requête REB, comment l'écrire ?

Dans la requête, on doit impérativement alimenter la liste WFResRubrique qui contiendra les données du tableau, avec : On l’a vu à l’étape précédente, il va falloir venir remplir ici les champs de WfResRubrique imposés par DIAPASON dans la structure de notre histogramme ! Selon la structure de l’histogramme, on viendra donc remplir WfResRubrique Cl1, et WfResRubrique Cl2 et Cl3 si besoin. A noter que : WFResRubrique.Cl1 doit contenir la catégorie WFResRubrique.Cl2 doit contenir la classe WFResRubrique.Cl3 doit contenir la série En fonction de ce qui est pré-initialsé dans la structure, vous n’aurez pas besoin d’alimenter ces trois champs selon le type de diagramme-voir étape suivante. WfResRubrique.Attributs contient la liste des classes permettant de personnaliser la série. Les classes utilisées doivent être renseignée dans l’une des feuilles de style rattachées au FID lors de sa définition. Le séparateur entre les classes est l’espace. WfResRubrique.NumOrdLig donne l’ordre de lecture de WfResRubrique. Si WfResRubrique.Attributs n’est pas renseigné les couleurs utilisées automatiquement sont les couleurs défaut définies par le paramètre utilisateur POR-COU-DEF. On peut ensuite alimenter un champs banalisé de la liste WfResRubrique ( RubNum0,1…, RubDat0,1…, RubLog0,1…, RubAlp0,1…) avec la valeur à chaque instant à afficher dans le diagramme. Voir la structure à l'étape suivante !

• Définir la structure de l’histogramme

Une fois la requête créée, on va venir définir la structure de l’histogramme. Cette structure est imposée par DIAPASON ! On va donc devoir faire correspondre la Catégorie, la Classe, la Série et la Valeur avec les champs qu’on a alimentés dans la requête lors de l'étape précédente:

Idem pour les autres types d'histogramme !

• Liste pré initialisée dans le cas des histogrammes simples bâtons

• Liste pré initialisée dans le cas des histogrammes simples tuyaux d’orgue

• Liste pré initialisée dans le cas des histogrammes simples empilés

On vient donc alimenter ces champs “ Valeur” avec un champs banalisé de la liste WfResRubrique, qu’on va venir alimenter à l’étape suivante !

• Référence : Affichée.

• Etiquette : Etiquette à afficher devant les valeurs de catégorie, de classe, de série ou de la valeur numérique de la série.

• Style étiquette : Liste de classes permettant de personnaliser les caractéristiques des étiquettes (couleur, police, alignement). Le séparateur entre deux classes est l’espace. Ces classes doivent appartenir à l’une des feuilles de style référencées sur la définition du FID.

• Type : Type de l’étiquette à afficher.

• Format : Format d’affichage de l’étiquette.

• Champ : Saisie pour la référence « Valeur » seulement. Champ numérique de la liste WfResRubrique issu de la requête d’extraction du FID.

Pour réaliser un diagramme de ce type :

• On crée la requête REB, comment l'écrire ?

Dans la requête, on doit impérativement alimenter la liste WFResRubrique qui contiendra les données du tableau, avec : WfResRubrique.TEn doit contenir *STRUCTURE WfResRubrique.Cl1 doit contenir la liste ordonnée des valeurs en abscisse WfResRubrique.Cl2 doit contenir la liste des valeurs des séries qui sera aussi la liste des libellés pour la légende WfResRubrique.Cl3 doit contenir la liste des libellés à afficher en abscisse si différents de WfResRubrique.Cl1 . WfResRubrique.Attributs doit contenir la liste des attributs associés aux séries (une feuille de style JS par série) Données du Diagramme : WfResRubrique.Cl1 contient toujours les valeurs des catégories. WfResRubrique.Cl2 contient toujours le libellé des classes qui apparaît dans la légende. WfResRubrique.Cl3 n’est pas utilisé pour les histogrammes animés. WfResRubrique.Attributs contient la feuille de style permettant de personnaliser la classe. Si WfResRubrique.Attributs n’est pas renseigné les couleurs utilisées automatiquement sont les couleurs défaut définies par le paramètre utilisateur POR-COU-DEF. On doit ensuite alimenter un champs banalisé de la liste WfResRubrique ( RubNum0,1…, RubDat0,1…, RubLog0,1…, RubAlp0,1…) avec la valeur à chaque instant à afficher dans le diagramme. Voir la structure à l'étape suivante ! Cette requête peut s’appliquer à un Histogramme animé, une courbe animée ou un radar animé.

• Feuilles de style associées utilisées dans la requête

Feuille de style : JS_LIG_1 :

• strokeColor : COU_TEXTE_1;

  • pointColor : COU_TEXTE_1;

  • pointStrokeColor : COU_FOND_1;

• Feuille de style : JS_LIG_2 :

  • strokeColor :"rgba(151,187,205,0.5)";

  • pointColor : "rgba(151,187,205,1)";

  • pointStrokeColor : "#fff";

• Feuille de style : JS_LIG_3 :

  • strokeColor : COU_TEXTE_30;

  • pointColor : COU_TEXTE_30;

  • pointStrokeColor : COU_FOND_30;

Les couleurs peuvent être renseignées de la forme : RGB, HEXA, COU_TEXTE_xx ou COU_FOND_xx

• Définir la structure du diagramme

On va ensuite pouvoir définir la structure de notre diagramme : mais celle-ci est pré paramétrée ! En ouvrant la structure du diagramme, on constate que DIAPASON impose un structure pour chaque type (Barre, Courbe, Radar).

Chaque élément de cette structure devra être alimentée via la liste WFResRubrique de la requête qu’on va définir dans l'étape suivante, et on constate que DIAPASON nous donne déjà les champs de la rubrique à remplir, à part pour le champs Valeur, qu’il faudra alimenter nous-même ! 👌

Avec :

• Catégorie : le format d’affichage des libellés en abscisse

• Classe : le format d’affichage des libellés dans la légende

• Valeur : le format d’affichage des valeurs de l’échelle

On vient donc uniquement alimenter le champs “ Valeur” avec un champs banalisé de la liste WfResRubrique, qu’on va venir alimenter à l’étape suivante !

• Référence : Affichée.

• Type : Type de l’information à afficher.

• Format : Format d’affichage de l’information.

• Champ : Saisie pour la référence « Valeur » seulement. Champ numérique de la liste WfResRubrique issu de la requête d’extraction du FID.

Pour réaliser un diagramme de ce type :

• On crée ensuite la requête REB, comment l'écrire ?

1) Dans la requête, on doit impérativement alimenter la liste WFResRubrique qui contiendra les données du tableau, avec : WfResRubrique.Cl1: contient toujours le libellé des secteurs qui s’affiche dans la légende. WfResRubrique.Attributs: contient la feuille de style permettant de personnaliser la couleur du secteur. Si WfResRubrique.Attributs n’est pas renseigné les couleurs utilisées automatiquement sont les couleurs défaut définies par le paramètre général utilisateur POR-COU-DEF. WfResRubrique.NumOrdLig: donne l’ordre de lecture de WfResRubrique. Cette requête peut s’appliquer à un diagramme secteur Anneau, circulaire ou polaire. 2) On doit ensuite alimenter un champs banalisé de la liste WfResRubrique ( RubNum0,1…, RubDat0,1…, RubLog0,1…, RubAlp0,1…) avec la valeur à chaque instant à afficher dans le diagramme. Voir la structure à l'étape suivante !

• Feuille de style associée : JS_SEC_1

color : COU_FOND_1

• Définir la structure de l’histogramme

En ouvrant la structure du diagramme, on va donc constater que DIAPASON impose un structure pour chaque type de diagramme (Anneau, Circulaire, Polaire).

Chaque élément de cette structure devra être alimentée via la liste WFResRubrique de la requête qu’on va définir dans l'étape suivante, et on constate que DIAPASON nous donne déjà les champs de la rubrique à remplir, à part pour le champs Valeur, qu’il faudra alimenter nous-même avec la valeur correspondante qu’on a créée à l'étape précédente dans la liste WfResRubrique ! 👌

Avec :

• Catégorie : le format d’affichage des libellés dans la légende

• Valeur : le format d’affichage des valeurs de l’échelle (cas polaire)

• Référence : Affichée.

• Type : Type de l’information à afficher.

• Format : Format d’affichage de l’information.

• Champ: Saisie pour la référence « Valeur » seulement. Champ numérique de la liste WfResRubrique issu de la requête d’extraction du FID.

Pour réaliser un histogramme de ce type :

• On crée ensuite la requête REB, comment l'écrire ?

1) Dans la requête, on doit impérativement alimenter la liste WFResRubrique qui contiendra les données du tableau, avec : WfResRubrique.Cl1 : contient la valeur du minimum. WfResRubrique.Cl2 : contient la valeur du maximum. WfResRubrique.Cl3 : contient le libellé de la jauge. WfResRubrique.Attributs contient la feuille de style permettant de personnaliser les couleurs de la jauge. 2) On doit également alimenter un champs banalisé de la liste WfResRubrique ( RubNum0,1…, RubDat0,1…, RubLog0,1…, RubAlp0,1…) avec la valeur à afficher dans la jauge. Voir la structure à l'étape suivante !

• Feuille de style associée : ISJS_JAU (défaut)

gaugeColor: COU_FOND_9;

• levelColorsGradient: true;

• levelColors: ["#a9d70b", "#f9c802", "#ff0000"];

• startAnimationType: "<>";

• startAnimationTime : 0

• Définir la structure de l’histogramme

En ouvrant la structure de la jauge, on va donc constater que DIAPASON impose une structure.

Chaque élément de cette structure devra être alimentée via la liste WFResRubrique définie dans l'étape précédente.

On remplit donc :

• Minimum ➡️ WfResRubrique.Cl1

• Maximum ➡️ WfResRubrique.Cl2

• Libellé ➡️ WfResRubrique.Cl3

• Valeur ➡️ ? Il s’agit du champs banalisé qu’on a définit dans la liste WfResRubrique pour y mettre la valeur de la jauge !

Ces correspondances peuvent être forcées par l’application de définition de structure. Elle est pré initialisée et seule la modification est possible.

• Référence : Affichée.

• Champ : A remplir comme montré sur la capture ci-dessus pour Minimum, Maximum et Libelle. Pour Valeur, on peut choisir nous même un des champs banalisés de la la liste WfResRubrique, qu’on va venir alimenter dans le requête dans l'étape suivante.

Pour réaliser un flux de ce type :

• On crée la requête REB, comment l'écrire ?

Dans la requête, on doit impérativement alimenter la liste WFResRubrique qui contiendra les données du flux, avec pour chaque étape du flux : WfResRubrique.NumOrgLig : contient le numéro d’ordre de la flèche dans le flux. WfResRubrique.Cl1 : contient toujours la référence de l’étape correspondante dans le modèle. on utilise les champs banalisés de la liste WfResRubrique (WfResRubrique.RubAlp0,1,2) pour définir, pour chaque étape du flux, le contenu du texte qui est sur la flèche, du texte au dessus de la flèche, et du texte en dessous de la flèche

• Feuilles de Style Personnalisée :

De type RUB : HTML_FLU : Gestion du texte

Définie lors de définition d’un FID zone « Prop. Générales ». Elle donne les caractéristiques du texte du diagramme (voir § 5.8.6.1).

• De type JS : JS_FL_1 è Gestion du dessin

  • couleurFleche : COU_FOND_34 ;

  • couleurFlecheFin : COU_FOND_37 ;

  • couleurBordure : cou_fond_34 ;

  • Définie lors de la définition de la structure (action accessible depuis la définition du FID), elle donne le caractéristique d’une flèche lorsqu’elle est sélectionnée (voir § 5.8.6.2).

• Définir la structure du flux

Ensuite on va pouvoir définir la structure du flux: on va créer une ligne par étape !

Pour chaque étape, on va récupérer ici les champs banalisés de la liste WfResRubrique qu’on a alimentés dans l'étape précédente pour définir le contenu du texte qui est sur la flèche, du texte au dessus de la flèche, et du texte en dessous de la flèche.

• Référence : Saisie. Doit être unique.

• Type flèche : Défini la forme de la flèche :

• Champ texte flèche : Champ contenant le texte à afficher dans la flèche. Lien avec un champ de WFResRubrique.

• Style texte flèche : Classe définissant le style du texte. La classe doit être définie dans l’une des feuilles de style référencée sur le FID.

• Champ texte avant : Champ contenant le texte à afficher avant (Flux Horizontal) ou en haut (Flux Vertical). Lien avec un champ de WFResRubrique.

• Style texte avant : Classe définissant le style du texte. La classe doit être définie dans l’une des feuilles de style référencée sur le FID.

• Champ texte après : Champ contenant le texte à afficher après (Flux Horizontal) ou en bas (Flux Vertical). Lien avec un champ de WFResRubrique.

• Style texte après : Classe définissant le style du texte. La classe doit être définie dans l’une des feuilles de style référencée sur le FID.

• Longueur : Longueur en pixels de la flèche.

• Champ état flèche : Champ l’état de la flèche : sélectionnée ou pas. Lien avec un champ de WFResRubrique.

• Style état sél. : Non obligatoire. Lien avec une feuille de style de type JS qui donne les effets de couleur de la flèche lorsqu’elle est sélectionnée.

• Style état non sél. : Non obligatoire. Lien avec une feuille de style de type JS qui donne les effets de couleur de la flèche lorsqu’elle n’est pas sélectionnée.

Nous allons définir une rubrique sur le portail qui permet d’afficher des informations.

On crée une rubrique de type « Graphique » à laquelle on attache un format indicateur de type « libre » (zone html).

Dans la règle d’extraction d’un format indicateur de type libre, on renseigne la table WfFicTransfert.

Pour récupérer les données de la table IsDiaMes, on utilise la fonction DIALOG « INI-MESSAGES ».

On récupère les messages du portail dans la liste WfResRubrique lors de l’appel de la fonction :

On parcourt ensuite la liste WfResRubrique pour alimenter la liste WfFicTransfert.

On récupère :

• L’objet du message dans le champ RubAlp0 de WfResRubrique 

• Le texte du message dans le champ RubAlp1 de WfResRubrique 

• La date de début du message dans le champ RubDat0 de WfResRubrique 

• La date de fin du message dans le champ RubDat1 de WfResRubrique 

• L’heure de début du message dans le champ RubNum0 de WfResRubrique 

• L’heure de début du message dans le champ RubNum1 de WfResRubrique 

• Le numéro du message dans le champ RubNum2 de WfResRubrique 

Dans la boucle, on met en forme l’objet et le texte du message.

Une fois la rubrique insérée dans un portail DIAPASON, on obtient le résultat suivant :