Le widget Office permet à un utilisateur de créer son indicateur à l'aide d'un tableau (Excel ou OpenOffice). Aucune compétence de développement n'est requise.
Il peut être associé aux widgets de type Feu et Jauge ainsi qu'aux widgets de type Graphique.
Il permet également de lire un fichier texte contenant les balises Hmp correspondant aux widgets de type Feu, Jauge et Graphique.
Nous fournissons pour cela le module WidgetOffice.dhop avec les fonctions initOffice et UpdateOffice. Le champ paramètres contient une chaîne hmp de paramétrage :

Open

Paramétrage du widget

Lors de la création du widget dans le Zoom des widgets, il convient de choisir le type de widget Feu, Jauge ou Graphique.

C'est dans la zone "Paramètres" qu'il faut renseigner les informations concernant le fichier Office à traiter. C'est une chaîne au format HMP :
Pour un indicateur de type Feu ou Jauge

Pour un graphique

Si c'est l'attribut <FileText> qui est utilisé, le fichier texte doit contenir les balises des widgets Feu / Jauge, ou alors les balises du widget Graphique.

Couleur de la palette

Couleurs des graphiques : 15 palettes de couleurs sont disponibles. Par défaut, c'est la palette Windows8 qui est utilisée.
  

Adresser une cellule

Les références aux cellules peuvent s'exprimer dans 3 formats :

Formule

La référence à une cellule peut être une expression. C'est le numéro de la cellule, suivi éventuellement d'un calcul.

Le numéro de la cellule est évalué par la fonction DataCompute du langage Diva. On peut donc utiliser dans la formule toutes les fonctions du langage Diva évaluable par DataCompute, ainsi que les données des enregistrements publics visibles dans le module WidgetOffice.dhop (par exemple MZ.DOS).

Par exemple :
1+10
1+month
Z-day
1+(day*2)

Quelques mots clés sont substitués lors de l'exécution :

Exemples

1. Widget Feu / Jauge
Pour le tableur ci-dessous :

<file>planmarche.xlsx
<sheet>feuil1
<min>0
<maxcell>objectif
<currentCell>e:2+month
<StateCell>2+month:10
<CurrentValueCell>f:2+month
<SpreadValueCell>2+Month:9

Dans cet exemple, on utilise une cellule nommée pour la cellule contenant la valeur maximale, l'écriture A:1 pour CurrentCell et CurrentValueCell, l'écriture L1:C1 pour StateCell et SpreadValueCell.
Il y a aussi un exemple d'utilisation de formule.
Pour une exécution au mois de mai, on obtient :

Sous la jauge, ce sont les valeurs minimales et maximales.
Sur la droite, on a le nom du widget, la valeur courante (ici, c'est CurrentValueCell colonne F qui est utilisée car le paramètre a été renseigné (valeur courante sinon colonne E)), l'objectif (valeur maximale) et l'écart (colonne I).
Enfin, la couleur de la jauge provient de la colonne J.

2. Widget Graphique
Pour le tableau ci-dessous :

<File>graphique.xlsx
<OfficeType>chart
<ChartType>bar
<verticalaxistitle>ordonnée
<horizontalaxistitle>abscisse
<AfficherLegende>1
<AbscissaRange>b:1;m:1
<SerieName>Série1
<SerieRange>b:2;m:2
<SerieName>Série 2
<SerieRange>b:3;m:3
<OrientationCell>a:8
<Palette>Windows8
On obtient :

Performance, cache

Pour ne pas charger Office ou OpenOffice pour chaque widget de chaque utilisateur, ce qui pourrait dégrader les performances du serveur et ralentir le chargement de l'interface d'accueil, le résultat de chaque widget est stocké dans un fichier texte.
Ce fichier texte est stocké dans le sous-répertoire Widget du répertoire où se trouve le fichier Office. Il porte le nom de l'identifiant unique du widget avec l'extension .txt.
Il contient éventuellement une date d'expiration. En effet, si les formules de calcul des cellules contiennent par exemple une référence au jour de la semaine, le fichier a une durée de vie d'un seul jour.
Le fichier texte est créé après le premier accès au fichier Office. Le module stocke le résultat dans le fichier texte.
A l'ouverture d'un fichier Office, le module regarde :

•  

  • s'il existe un fichier texte correspondant ;

  • si le fichier texte est encore pérenne ;

  • si le fichier texte a la même date que le fichier Office.

Dans ce cas, c'est le contenu du fichier texte qui sera utilisé.
Sinon, le module recalcule le résultat à partir du fichier Office, calcule la nouvelle date d'expiration puis stocke le résultat dans le fichier texte.

Exemple
\divalto\ « version » \Fichiers\ficjoints\Widget\graph3_office.txt

En cas de changement du paramétrage d'un widget, il convient de supprimer le fichier résultat du "cache".

Fichier texte

Le paramètre <FileText> permet d'animer le widget à partir d'un fichier texte qui contient les valeurs liées au widget. Ce fichier peut être généré par programme ou tout simplement être saisi par un utilisateur.
Les balises correspondant aux valeurs affichées par le widget sont :

Toutes les valeurs sont facultatives. Le widget s'affichera avec les valeurs disponibles.