Où est enregistrée la disposition de mon dashboard Heedify ?

Dans le Profil Analytics de l'Entité, sous dashboardLayout.tabs. Il stocke chaque onglet, les instances de widgets de chaque onglet, ainsi que la position et la taille de chaque widget. Il est propre à chaque Entité et survit aux réinitialisations de disposition par défaut.

Fonctionnement des dashboards

Cette page explique les mécanismes derrière le dashboard Analytics — comment les onglets et les widgets sont structurés, où la disposition est stockée, et comment les données des widgets sont récupérées et rafraîchies. Pour le catalogue des types de widgets et des sources de données, voir Analytics. Pour les cibles SLA et les seuils, voir Profil Analytics.

Anatomie d’un dashboard

Chaque Entité dispose de son propre dashboard, stocké à l’intérieur du Profil Analytics de cette Entité :

Profil Analytics (un par Entité)
├─ reportConfig            ← cibles SLA, seuils (voir Profil Analytics)
└─ dashboardLayout
   └─ tabs
      ├─ Dashboard        (système)      → widgets + positions
      ├─ Liste des appels (système)      → (tableau d'appels intégré)
      └─ <votre onglet>   (personnalisé) → widgets + positions

Chaque onglet contient un ensemble d’instances de widgets et leurs positions à l’écran (x, y, largeur, hauteur sur la grille).

Onglets

Il existe trois types d’onglets :

Type	Exemples	Supprimable ?
Système	Dashboard, Liste des appels	Non — toujours présents
Préconfiguré	Niveau de service & SLA, Abandons & Qualité, Flux/Files/Agents, Volume & Tendances	Oui
Personnalisé	Tout ce que vous construisez	Oui

Ce qui se passe quand vous…

Créez un onglet — Heedify ajoute une nouvelle entrée d’onglet à dashboardLayout.tabs (avec un id généré). Choisissez un onglet vierge ou un modèle préconfiguré.
Renommez un onglet — met à jour le nom d’affichage de l’onglet sur place.
Réordonnez les onglets — l’ordre de la barre d’onglets est l’ordre stocké ; réarranger le modifie.
Supprimez un onglet — supprime l’onglet et toutes les instances de widgets qu’il contient, puis vous ramène à l’onglet Dashboard. Cette action est irréversible une fois enregistrée.

Les onglets système (Dashboard, Liste des appels) ne peuvent pas être supprimés ; les onglets préconfigurés et personnalisés sont persistés par Entité et préservés lors de la réinitialisation des dispositions par défaut.

Instances de widgets

Lorsque vous ajoutez un widget à un onglet, vous créez une instance de widget — une copie configurée d’un widget du catalogue. Chaque instance stocke :

Propriété	Signification
Type de widget	De quel widget du catalogue il s’agit (métrique, graphique, tableau…)
Source de données	La requête prédéfinie qui l’alimente
Nom	Le titre affiché dans l’en-tête du widget
Onglet	À quel onglet il appartient
Activé	S’il récupère les données et les affiche
Filtres	Filtres globaux du dashboard, ou une période personnalisée + overrides flux/file/agent
Intervalle de rafraîchissement	Fréquence de refetch (secondes)
Position	x, y, largeur, hauteur sur la grille

Le même widget du catalogue peut être ajouté plusieurs fois avec des filtres différents — par ex. « Total appels — 7 derniers jours » à côté de « Total appels — 30 derniers jours ».

Modifier et enregistrer la disposition

Le dashboard a un mode visualisation et un mode édition :

Cliquez sur Modifier la disposition pour entrer en mode édition.
Ajoutez des widgets, glissez pour déplacer/redimensionner, créez ou renommez des onglets, modifiez la configuration des widgets.
Cliquez sur Enregistrer la disposition pour persister.

Les modifications effectuées en mode édition restent locales jusqu’à ce que vous cliquiez sur Enregistrer la disposition. Enregistrer la disposition réécrit l’intégralité du dashboardLayout dans le Profil Analytics de l’Entité. Quitter le mode édition sans enregistrer abandonne les modifications.

Pour éviter d’écraser des modifications concurrentes, Heedify relit le profil courant avant d’écrire votre disposition mise à jour.

D’où proviennent les données des widgets

La plupart des widgets sont liés à une source de données — une requête prédéfinie (voir Données analytics disponibles) exécutée sur analytics.heedify.io, le backend de reporting Heedify. Le déroulement à chaque chargement :

Le dashboard collecte chaque widget visible et activé sur l’onglet actif.
Pour chaque widget, il construit les filtres de la requête — soit les filtres globaux du dashboard (plage de dates, fuseau horaire, flux/file/agent), soit la période et les filtres personnalisés du widget lorsque Utiliser les filtres globaux du dashboard est désactivé.
Toutes ces requêtes de widgets sont envoyées en une seule requête groupée vers le backend de reporting (plus rapide qu’un appel par widget).
Le backend exécute chaque requête prédéfinie sur l’historique d’appels du tenant et retourne les lignes.
Chaque widget transforme ses lignes dans la forme appropriée (valeur de métrique, série de graphique ou tableau) et les affiche.

Les résultats sont mis en cache brièvement (environ une minute) par combinaison de filtres, de sorte que changer d’onglet ou déplacer légèrement un widget ne relance pas des requêtes identiques. Chaque widget refait ensuite la requête selon son propre intervalle de rafraîchissement.

Widgets qui n’exécutent pas de requête

Quelques widgets (et les seuils de couleur des métriques) lisent des valeurs configurées directement depuis le reportConfig du Profil Analytics de l’Entité — par exemple la cible SLA ou les seuils d’attente/conversation/abandon — au lieu d’interroger l’historique d’appels. Ceux-ci se mettent à jour dès que vous les modifiez dans le Profil Analytics, sans aucune requête historique.

Historique vs temps réel

Surface	Source de données	Nature
Dashboards Analytics (cette page)	requêtes prédéfinies analytics.heedify.io	Historique, agrégé, en cache ~1 min
Onglet Liste des appels	Enregistrements d’appels historiques	Liste par appel pour la période
Dashboard Temps Réel	Événements file/agent en direct	En direct, séparé d’Analytics
Seuils de métrique / SLA	`reportConfig` du Profil Analytics	Valeurs configurées

Le dashboard Analytics est du reporting historique. Pour l’état en direct des files et des agents, utilisez le Dashboard Temps Réel.

FAQ

Q : Où est enregistrée la disposition de mon dashboard ? R : Dans le Profil Analytics de l’Entité, sous dashboardLayout.tabs — chaque onglet, ses instances de widgets, et la position/taille de chaque widget. Propre à chaque Entité, et préservé lors des réinitialisations de disposition par défaut.

Q : Pourquoi ma modification de dashboard n’a-t-elle pas été conservée ? R : Les modifications de disposition restent locales jusqu’à ce que vous cliquiez sur Enregistrer la disposition. Enregistrer la disposition réécrit l’ensemble de la disposition dans le profil ; quitter le mode édition sans enregistrer abandonne les modifications.

Q : Combien de temps les données de reporting sont-elles conservées ? R : Les données de reporting sont conservées 365 jours par défaut. Contactez sales@heedify.io si vous avez besoin d’une durée de conservation plus longue.

Works with : Microsoft Teams, analytics.heedify.io, Analytics, Profil Analytics, Dashboard Temps Réel.