Widgets

À quoi ça sert

Un widget est un graphique de l'organisation : chiffre d'affaires, nombre de tâches ouvertes, activité commerciale… Ces graphiques forment le catalogue « Widgets » dans lequel vous puisez pour composer un tableau composé. Un même widget peut se retrouver sur plusieurs tableaux composés, les vôtres comme ceux qu'on partage avec vous.

Chaque widget interroge directement les données de votre organisation : il ne passe pas par Metabase, à la différence des tableaux de bord déclarés par un administrateur (voir Consulter un tableau de bord).

Concepts clés

Widget ou graphique — un graphique du catalogue, identifié par un titre et un résumé.
Auteur — la personne qui a créé le graphique. Elle seule, avec un administrateur du module KPI, peut le modifier.
Partage d'un graphique — privé, restreint à des groupes, ou ouvert à toute l'organisation. Indépendant du partage du tableau composé qui l'affiche : un graphique peut être plus restreint que le tableau sur lequel il est posé, auquel cas certains lecteurs du tableau voient une tuile restreinte à sa place.
Type de rendu — la façon dont le graphique s'affiche : tableau, barres, courbe, aire, camembert, nombre, jauge, entonnoir, et une dizaine d'autres.
Couleurs — les couleurs des séries d'un graphique. Elles appartiennent au graphique : les changer les change partout où il est posé.
Lien au clic — une destination de Deltia, ou une adresse web, vers laquelle un clic sur un élément du graphique renvoie, ses variables étant remplacées par les valeurs de la ligne cliquée. Laissé vide, le graphique n'est pas cliquable.
Format d'une colonne — comment se lit une colonne du résultat : nombre brut, pourcentage, montant dans une devise, avec préfixe ou suffixe.
Graphique personnel — un widget dont la requête compare l'adresse e-mail de qui le regarde à une donnée du résultat : chaque lecteur voit alors ses propres chiffres, jamais ceux d'un collègue. Demandez ce genre de graphique à l'assistant IA, par exemple « mes tâches » ou « mes factures », ou écrivez-le dans la requête (voir « Règles de la requête » en Référence).
Aperçu — le graphique tel qu'il s'affichera, à la taille réelle d'une tuile de tableau composé, à gauche du volet des réglages.
Version — chaque fois que la requête ou le rendu d'un widget change, depuis ses réglages ou via l'assistant IA, la version précédente est conservée plutôt que perdue. Un administrateur du module KPI peut la consulter et la restaurer. Voir Administration des tableaux composés et des widgets.

Comment faire

Voir Ajouter un graphique.

Deux façons d'ouvrir les réglages d'un graphique :

Sur un tableau composé, en mode d'édition, cliquez sur l'icône de réglages de sa tuile.
Ou, dans le panneau « Widgets disponibles » (voir Ajouter un graphique), cliquez sur le nom d'un graphique que vous pouvez modifier : ses réglages s'ouvrent directement, sans le poser sur le tableau.

Une fois les réglages ouverts, ajustez le titre, le résumé, la requête, le type de rendu, les options de la section « Rendu », les couleurs des séries, le lien au clic ou la section « Format des colonnes », puis cliquez sur « Enregistrer ». L'aperçu se met à jour à chaque sortie de champ de la requête.

L'icône de réglages d'une tuile s'affiche sur tous les widgets de votre tableau, quel qu'en soit l'auteur, sauf sur un graphique désactivé par un administrateur. Dans le panneau « Widgets disponibles », en revanche, seul le nom d'un graphique que vous pouvez modifier est cliquable ; sur les autres, le nom reste un texte simple — le bouton d'ajout, lui, reste disponible pour tous les graphiques du panneau. Dans les deux cas, vous ne pouvez enregistrer une modification que sur un graphique dont vous êtes l'auteur ; un administrateur du module KPI peut modifier n'importe lequel. Sur un graphique d'un autre auteur, la section « Partage » reste masquée et l'enregistrement est refusé.

Vérifier l'aperçu

Dans les réglages ouverts, regardez l'aperçu à gauche du volet.
Sous « Taille sur un tableau de bord », choisissez « Petite tuile », « Tuile moyenne » ou « Grande tuile » (moyenne par défaut).

Tant que la requête ne renvoie aucune donnée, l'aperçu affiche « L'aperçu s'affichera ici dès que la requête renverra des données. ». Une requête refusée affiche son erreur à la place du graphique.

Ouvrir les réglages en pleine page

Dans le volet des réglages d'un widget existant, cliquez sur le bouton d'agrandissement.

Les réglages s'ouvrent sur une page dédiée, avec les modifications en cours conservées. Fermer le volet alors que des modifications ne sont pas enregistrées demande une confirmation. Supprimer le widget depuis la pleine page ramène à l'accueil du module KPI.

Ouvrez les réglages du widget.
Cliquez sur « Supprimer ».
Confirmez : « {titre} sera retiré de tous les tableaux de bord qui l'utilisent. Cette action est définitive. »

Le widget disparaît de tous les tableaux composés où il était posé, y compris ceux d'autres propriétaires, et du catalogue. La suppression est réservée à l'auteur du widget ou à un administrateur du module KPI, et elle est irréversible — à la différence de la désactivation, qui reste réversible et n'efface rien. Voir Administration des tableaux composés et des widgets.

Ouvrez les réglages du widget.
Dans « Partage », choisissez « Privé », « Groupes choisis » (uniquement parmi vos propres groupes) ou « Toute l'organisation ».
Cliquez sur « Enregistrer ».

Un partage plus étroit que celui d'un tableau composé sur lequel le graphique est posé rend sa tuile restreinte pour les lecteurs qui n'y ont plus droit.

Référence

Types de rendu disponibles

Tableau, barres, courbe, aire, camembert, barres horizontales, nombre, nuage de points, combiné, cascade, entonnoir, treemap, progression, tendance, visualisation détaillée, jauge, Sankey, tableau croisé dynamique.

Les types proposés se limitent à ceux compatibles avec les colonnes que la requête renvoie : pour un widget existant, et pour une création dès que l'aperçu a tourné.

Options de la section « Rendu »

Seules les options du type choisi s'affichent. Les types tableau, nombre, entonnoir, treemap, progression, visualisation détaillée, jauge et Sankey n'ont pas de section « Rendu ».

Option	Types concernés
« Afficher la légende »	Barres, barres horizontales, aire, courbe, combiné, camembert
« Afficher les valeurs sur le graphique »	Barres, barres horizontales, aire, courbe, combiné, cascade
« Afficher le total »	Camembert, cascade
« Étiquettes des tranches » (« Aucune », « Valeurs », « Pourcentages », « Valeurs et pourcentages »), « Décimales des pourcentages », « Regrouper les tranches sous (%) »	Camembert
« Empilement » (« Côte à côte », « Empilé », « Empilé à 100 % »)	Barres, barres horizontales, aire
« Titre de l'axe des catégories », « Titre de l'axe des valeurs », « Graduations des catégories », « Graduations des valeurs », « Échelle » (« Linéaire », « Logarithmique »), « Minimum », « Maximum »	Barres, barres horizontales, aire, courbe, combiné, cascade, nuage de points
« Objectif », « Libellé de l'objectif »	Barres, barres horizontales, aire, courbe, combiné, cascade
« Total par ligne », « Total par colonne »	Tableau croisé dynamique
« Une hausse est une mauvaise nouvelle »	Tendance

Format des colonnes

La section « Format des colonnes » n'apparaît qu'en modification d'un widget existant. Pour chaque colonne, elle propose :

Réglage	Effet
« Nom affiché »	Le nom de la colonne à l'écran
« Type »	« Nombre brut » (aucune mise en forme), « Nombre », « Pourcentage » ou « Montant »
« Décimales »	De 0 à 6
« Devise »	Code de trois lettres, pour un montant ; EUR par défaut
« Multiplier par », « Préfixe », « Suffixe »	S'ajoutent à n'importe quel type

Règles de la requête

La requête doit lire un jeu de données prévu pour les KPI (kpi_read) et porter les deux paramètres {{organization_id}} et {{group_ids}} : c'est ce qui la borne à votre organisation et à vos groupes. Pour un graphique personnel, comparez {{current_user_email}} à une colonne contenant une adresse e-mail : il vaut l'adresse de qui regarde le graphique, qui reste donc partageable.

Catégories sans valeur

Sur un graphique groupé par un champ (barres, camembert, courbe…), les lignes dont ce champ est vide, non renseigné ou ne contient que des espaces sont regroupées dans une seule catégorie « Non renseigné », plutôt que d'apparaître chacune sous sa propre étiquette.

Limites

Limite	Valeur
Titre d'un widget	255 caractères maximum
Résumé d'un widget	1000 caractères maximum
Création ou réécriture de widgets	60 par heure et 200 par jour pour un même utilisateur, 600 par jour pour l'organisation entière

La limite de création ou réécriture compte une création aboutie par l'assistant IA, et une modification enregistrée seulement si elle change la requête ou le type de rendu. Un renommage, un changement de couleurs, d'options ou de format ne compte pas, pas plus qu'un graphique créé avec « Nouveau graphique » depuis l'administration.

Qui peut quoi

Action	Qui
Ajouter un widget existant à un tableau composé	Toute personne pouvant modifier ce tableau
Enregistrer une modification sur un widget	L'auteur du widget, ou un administrateur du module KPI
Créer un nouveau widget	Un administrateur du module KPI, ou l'assistant IA si votre organisation l'autorise
Désactiver un widget ou restaurer une version antérieure	Un administrateur du module KPI uniquement
Supprimer un widget	L'auteur du widget, ou un administrateur du module KPI

Messages

Message	Situation
« Les widgets KPI ne sont pas activés pour votre organisation »	Le module n'a pas activé les tableaux composés
« Votre organisation réserve la création de widgets KPI à certains groupes »	Vous n'appartenez à aucun des groupes autorisés à créer des widgets
« Seuls l'auteur du graphique et un administrateur du module KPI peuvent le modifier »	Vous tentez de modifier un widget dont vous n'êtes pas l'auteur
« Ce graphique a été retiré de la circulation par un administrateur : il ne peut plus être modifié. »	Le widget a été désactivé
« Vous ne pouvez partager un graphique qu'avec vos propres groupes »	Le partage choisi désigne un groupe auquel vous n'appartenez pas
« Vous avez atteint la limite de graphiques générés. Réessayez dans {retrySeconds} secondes. »	Vous avez atteint la limite de création ou réécriture de widgets
« La requête n'a ramené aucune donnée pour cette organisation : … »	La requête ne renvoie aucune donnée ; le widget n'est pas enregistré
« Le graphique a été modifié. Rafraîchissez la page et réessayez. »	Le widget a été modifié ailleurs pendant que vous l'éditiez
« Le lien de ce graphique n'est pas valide : la requête ne renvoie pas toutes les variables qu'il utilise, ou la colonne choisie ne correspond à aucun filtre de la liste ciblée. »	Le lien au clic cite une colonne absente du résultat, ou une colonne sans filtre correspondant sur la liste visée
« Le lien doit commencer par « / » (une page de Deltia) ou par « https:// ». »	Le lien au clic saisi ne pointe ni vers une page de Deltia, ni vers une adresse sécurisée

Questions fréquentes

Puis-je créer un widget moi-même ? Cela dépend des réglages de votre organisation : voir Administration des tableaux composés et des widgets. Vous pouvez dans tous les cas demander un graphique à l'assistant IA, s'il est activé pour votre organisation.

Pourquoi un graphique de mon tableau affiche-t-il un message à la place des données ? Le graphique n'est pas disponible pour votre compte, le plus souvent parce que son partage est plus restreint que celui du tableau. Un graphique désactivé par un administrateur, lui, disparaît du tableau pour ses lecteurs. Voir Tableaux composés.

Une modification de couleur affecte-t-elle les autres tableaux qui utilisent ce widget ? Oui. Les couleurs appartiennent au graphique, pas au tableau : les changer les change partout où il est posé.

Puis-je faire en sorte qu'un clic sur mon graphique ouvre une autre page de Deltia ? Oui, en configurant un lien au clic dans les réglages du widget. Le clic ouvre alors, dans un nouvel onglet, la liste correspondante (tâches, factures, fiches CRM, contrats, produits du catalogue…), filtrée sur la valeur cliquée.

Puis-je afficher un widget ailleurs que sur un tableau composé ? Oui, un graphique que vous pouvez lire peut aussi apparaître seul sur la page d'accueil, comme widget « Carte KPI ». Voir Page d'accueil.