Expressions
Expressions
Les fonctionnalités d’expressions de ProcessMind permettent de générer du texte enrichi et du contenu dynamique dans vos dashboards. En utilisant les expressions, vous pouvez créer des visualisations plus engageantes et informatives, adaptées à vos données. Puisque le contenu peut évoluer selon les interactions utilisateur ou les mises à jour des données, les expressions offrent un moyen puissant de garder vos dashboards pertinents et utiles. Ce guide présente des exemples et notations possibles pour utiliser les expressions de façon efficace.
Principes de base
Pour une utilisation simple, les expressions permettent d’intégrer directement vos métriques et attributs dans le texte. Cela permet de générer du contenu dynamique qui s’actualise automatiquement lorsque vos données évoluent.
Exemple 1 : Nombre de cas actifs vs nombre total de cas
Je souhaite afficher le nombre de cas actifs par rapport au nombre total de cas. L’expression à utiliser :
Nombre de cas affichés : ${metric} / Nombre total de cas : ${total}
${metric} correspond à la valeur actuelle de la métrique, ${total} au nombre total de cas.
Exemple 2 : Nombre de cas non inclus
Je souhaite afficher le nombre de cas soustraits du total :
Nombre de cas non inclus : ${total - metric}
Où ${metric} correspond à la valeur actuelle de la métrique et ${total} au nombre total de cas.
Exemple 3 : Pourcentage de cas via fonction
Je veux afficher le pourcentage de cas affichés par rapport au total :
Pourcentage de cas affichés : ${formatPercentage(metric)}
${metric} est la métrique actuelle définie sur les cas.
Fonctions disponibles
ProcessMind prend en charge un ensemble de fonctions utilisables dans les expressions pour effectuer des calculs, du formatage et des recherches dynamiques. Vous pouvez combiner ces fonctions avec vos métriques et attributs pour générer des textes plus avancés.
| Fonction | Description | Exemple |
|---|---|---|
round(value, decimals?) | Arrondit un nombre à l’entier le plus proche ou au nombre de décimales choisi. | ${round(metric, 2)} → 123.46 |
power(base, exponent) | Élève un nombre à une puissance (identique à pow). | ${power(2, 3)} → 8 |
pow(base, exponent) | Alias de power. | ${pow(metric, 2)} |
sqrt(value) | Retourne la racine carrée d’un nombre. | ${sqrt(metric)} |
abs(value) | Retourne la valeur absolue (supprime le signe négatif). | ${abs(metric)} |
ceil(value) | Arrondit un nombre à l’entier supérieur. | ${ceil(3.2)} → 4 |
floor(value) | Arrondit un nombre à l’entier inférieur. | ${floor(3.8)} → 3 |
exp(value) | Retourne le nombre d’Euler e à la puissance indiquée. | ${exp(1)} → 2.718... |
log(value) | Retourne le logarithme naturel (base e). | ${log(metric)} |
mod(dividend, divisor) | Retourne le reste de la division. | ${mod(10, 3)} → 1 |
formatDate(date, format?) | Formate une date en chaîne lisible. Accepte des formats personnalisés. | ${formatDate(created_at, "YYYY-MM-DD")} |
formatDuration(ms) | Convertit une durée en millisecondes en texte lisible. | ${formatDuration(metric)} → 3d 4h 5m |
formatPercentage(value) | Formate un nombre décimal en pourcentage. | ${formatPercentage(metric)} → 75% |
getVariable(name) | Récupère la valeur d’une variable utilisateur. | ${getVariable("Case Id")} |
Astuce : Les fonctions peuvent être imbriquées ou combinées avec des calculs.
Exemple :
${formatPercentage(round(metric / total, 2))}
Cela permet de calculer un ratio, l’arrondir à deux décimales et le formater en pourcentage.
Pour aller plus loin
La flexibilité des expressions, combinant métriques, attributs, opérateurs et fonctions, vous permet de créer des dashboards qui vont au-delà des simples chiffres : ils racontent une histoire. Grâce aux expressions, vous construisez du texte dynamique ainsi que des calculs qui s’adaptent instantanément lorsque vos utilisateurs filtrent ou explorent les données.
Qu’il s’agisse d’afficher des pourcentages, de mettre en avant des KPIs ou d’optimiser la lisibilité des valeurs, les expressions rendent vos dashboards plus efficaces, actionnables et visuels — sans avoir à coder.
Utilisez ces possibilités pour guider vos utilisateurs, révéler des tendances et faciliter la compréhension des data. Avec un peu de créativité, vos dashboards deviennent de véritables récits interactifs qui favorisent une prise de décision éclairée.