Ajouter une fabrique HTML

Modifié par Aurelie Bertrand le 2024/02/19 10:39

Introduction

Le flux Fabrique de documents construit des fichiers HTML intégrant des graphiques générés par DigDash Enterprise.
Le fichier HTML en sortie est complètement statique, c'est à dire indépendant de l'environnement DigDash. Il peut donc être visualisé hors connexion, ou dans un réseau isolé de celui du serveur DigDash. Cela permet, par exemple, d'intégrer ce fichier HTML dans le corps d'un mail.
La fabrique HTML peut avoir comme destination le tableau de bord, mais aussi tout type d'appareil de sortie : mail ou serveur de documents.

Un document en langage HTML contenant des pointeurs vers des graphiques sert de modèle.
Lors de la synchronisation de la fabrique les pointeurs sont remplacés par le contenu des graphiques convertis en image.
Ce modèle est géré entièrement par l'utilisateur. Une syntaxe à base d'attributs HTML simples permet de caractériser des éléments HTML comme support de graphiques.

Votre première fabrique de documents

Pour créer votre première fabrique, dans la barre d'outils en haut de la fenêtre principale, ouvrez le menu Flux puis sélectionnez Fabrique HTML :

Capture d’écran 2022-09-01 à 15.54.00.png

La fenêtre "Propriété du flux" s'ouvre.
Cliquez sur l'icône d'accès à l'éditeur HTML :

Capture d’écran 2022-09-01 à 15.55.22.png

Copiez-collez le code html de votre modèle dans l'onglet source.

Utilisez la liste de graphiques de gauche pour sélectionner un graphique.
Dans le menu accessible par clic-droit sur le flux, cliquez sur "Copier dans un bloc HTML" :

Capture d’écran 2022-09-01 à 15.56.19.png

Le presse-papier est alors rempli avec du code html ressemblant à ceci :

<div class="ddflow">
   <div class="ddflowborder">
    [...]
   </div>
   <p>digdash_id=f9678483</p>
   <p>digdash_width=300</p>
   <p>digdash_height=200</p>
</div>
  • ddflow : classe css permettant à la fabrique de savoir où insérer un graphique.
  • digdash_id : identifiant du graphique
  • digdash_width / digdash_height : pour tous les graphiques (hormis les tableaux) ces attributs permettent de fixer les dimensions de l'image représentant le graphique. Les tableaux eux sont conservés dans leur format html, donc s'adapteront à leur conteneur.

Exemple :

<div class="ddflow">
    <div class="ddflowborder">
    [...]
    </div>
    <p>digdash_id=f9678483</p>
    <p>digdash_width=300</p>
    <p>digdash_height=200</p>
</div>

Copiez ce code dans votre modèle.
L'onglet aperçu affiche immédiatement (sans le rendu final du graphique) l'encart réservé au graphique.

Vous pouvez alors sauvegarder votre fabrique et lancer un aperçu pour visualiser le rendu final.

À partir du patch 2023R1_p20240208, les graphiques sans valeurs sont masqués.

N'importe quel balise html peut accueillir des graphiques via la class css ddflow. Le div n'est qu'un exemple de conteneur.