Fabrique HTML

Last modified by Aurelie Bertrand on 2024/05/15 09:10


💡 Il est recommandé d'avoir des notions de HTML pour créer une fabrique HTML.

Le flux Fabrique de documents HTML 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.

Lorsque vous créez une nouvelle fabrique HTML comme décrit dans la rubrique Créer un flux, la fenêtre Propriétés du flux s'affiche et vous permet de la configurer.

1698154311894-719.png
Il faut tout d'abord créer le modèle puis configurer les paramètres.

Le modèle peut être enregistré avec le flux ou dans un fichier modèle sur un serveur de fichiers qui pourra être réutilisé par la suite.

Créer le modèle de fabrique HTML

Pour créer le modèle :

  1. Dans la section Modèle, cliquez sur le bouton Éditer Bouton_éditer.
    ➡ Une fenêtre Fabrique HTML s'affiche.
    Fenetre_fabrique_HTML

La partie droite contient le modèle. Cliquez sur le bouton Source si vous souhaitez visualiser/éditer le code HTML.
La partie gauche permet d'effectuer la sélection et définir les paramètres d'impression.
Les 2 premiers onglets permettent de visualiser les flux disponibles de 2 façons différentes :

  • Portefeuille : cet onglet permet de visualiser les flux tel qu’ils sont listés dans le rôle sélectionné dans la liste déroulante.
  • Tableau de bord : cet onglet permet de visualiser la liste de vos flux tels qu’ils sont organisés dans votre tableau de bord. Toutes les pages sont représentées, ainsi que les flux et les légendes qu’elles contiennent.

Vous pouvez afficher un aperçu du flux sélectionné via un clic-droit puis Aperçu du flux.
Aperçu flux

  1. Sélectionnez un flux à ajouter au modèle dans l'un des deux onglets.
  2. Positionnez-vous à l'emplacement souhaité dans le modèle et cliquez sur le bouton Bouton_insérer_flux .
    ➡ Le flux est ajouté au modèle sous la forme d'un rectangle avec comme contenu : le nom du flux, son identifiant du type digdash_id= xxx et les dimensions de l'image représentant le flux (hormis les tableaux) dans le document HTML généré. Les tableaux eux sont conservés dans leur format html et s'adapteront donc à leur conteneur.
    Flux_ajouté
  3. Procédez de même pour les autres flux que vous souhaitez ajouter.
  4. En plus des flux, vous pouvez insérer :
    • la légende,
    • le résumé des filtres,
    • une zone commentaires qui contiendra les commentaires publiés dans le tableau de bord:
      cliquez sur le bouton correspondant et paramétrez l'élément et son style dans la boite qui s'affiche.
  5. Vous pouvez ajouter du texte, des images, liens, etc, et mettre en forme comme vous le souhaitez à l'aide de la barre d'outils.
  6. Vous pouvez également créer des sections : positionnez-vous à l'emplacement souhaité dans le modèle et cliquez sur le bouton Buton_section_HTML.
    Le nombre de sections maximum est défini dans l'onglet Paramètres.
  7. Dans l'onglet Paramètres, définissez les options et marges d'impression. À noter qu'il est possible de masquer les flux sans valeurs en décochant la case Afficher les flux sans valeurs.
  8. Cliquez sur bouton Bouton_aperçu pour obtenir un aperçu sous la forme d'un fichier HTML téléchargé automatiquement.

Une fois le modèle terminé, vous pouvez l'enregistrer :

  • Avec le flux : cliquez sur OK en bas à droite de la fenêtre Fabrique HTML.
  • Dans un fichier modèle : dans l'onglet Paramètres, cochez la case Sélection d'un serveur de fichiers puis entrez le Nom du fichier modèle et sélectionnez un Serveur de documents. Cliquez ensuite sur OK en bas à droite de la fenêtre Fabrique HTML.
    ➡ La boite se ferme et le fichier est renseigné dans la section Modèle de la fenêtre Propriétés du flux.

Avant d'aller plus loin dans le paramétrage, vous pouvez enregistrer la fabrique de documents : 

  • Dans la section Général, entrez le Nom de la Fabrique HTML et cliquez sur Appliquer.

💡 En cas de problème d'affichage des entêtes et pieds de page lors de la conversion en PDF, utilisez des balises header et footer.

Modifier les paramètres de la fabrique HTML

Une fois le modèle fabrique HTML créé, un ensemble de paramètres peut être modifié.

Consultez la page Modifier les paramètres de la fabrique de document pour une description complète.

Éditer les propriétés générales de la fabrique HTML

Avant de sauvegarder la fabrique HTML, son Nom doit être renseigné dans  la section Général.

D'autres propriétés sont disponibles. Consultez la page Éditer les propriétés générales d'une fabrique pour plus de détails.

Exemple

La fabrique HTML peut être utilisée pour créer une newsletter intégrant vos flux comme illustré ci-dessous.

Exemple_fabrique_newsletter
Cette fabrique HTML permet de générer le document HTML suivant :

Exempple_newsletter_générée