Expression Editor

Expression Editor

L’Expression Editor est l’outil intégré de ProcessMind pour écrire des expressions. Il s’ouvre partout où des expressions sont utilisées, notamment pour les attributs de jeu de données, les filtres de jeu de données et les définitions de métriques. Son fonctionnement reste toujours le même : écrivez, validez, puis prévisualisez avant d’enregistrer.

Où l’ouvrir

Ouvert depuis	Élément modifié
Dataset → Attributs → cellule Mappage / Expression	un attribut calculé
Dataset → Général → Filtre global du jeu de données → Ajouter une expression de filtre…	un filtre de lignes appliqué avant le Process Mining
Paramètres du graphique → Expression de la métrique → Utiliser une expression de métrique…	une expression de métrique évaluée pour chaque ligne
Paramètres du graphique → Métriques secondaires → Expression…	une expression de métrique secondaire
Paramètres du graphique → puce Texte / Html	texte du graphique : texte littéral et HTML avec des ${ ... }expressions
Paramètres du graphique → Paramètres de la norme → ƒ → expression Début / Fin	une limite de norme définie à partir des constantes de Paramètres du processus

Le titre de la boîte de dialogue indique l’élément que vous modifiez, par exemple Edit Expression: {attribute name} ou Expression de filtre de lignes.

Écrire une expression

• La saisie applique une coloration syntaxique au fur et à mesure : les fonctions, les attributs, les constantes, les propriétés de cas et les références de lignes ont chacun leur propre couleur, tandis que les erreurs d’analyse sont soulignées en rouge.
• Appuyez sur Ctrl/Cmd+Espace pour ouvrir les suggestions, qui ne s’affichent pas automatiquement. Entrée ou Tabulation applique l’élément sélectionné, et Échap ferme la liste.
• Survolez un jeton pour afficher sa documentation : les fonctions présentent leur signature, leur description et un exemple, tandis que les attributs indiquent leur type.
• Dans un appel de fonction, l’aide à la signature indique le paramètre que vous êtes en train de renseigner.
• Les boutons Annuler et Rétablir se trouvent dans l’en-tête. Les raccourcis correspondants sont Ctrl/Cmd+Z, Maj+Ctrl/Cmd+Z et Ctrl/Cmd+Y.

Le panneau de référence

Le panneau Sélectionnez des éléments pour créer votre expression répertorie tout ce que vous pouvez utiliser, regroupé par sections :

• Attributs : les attributs de votre jeu de données. Cliquez sur un attribut pour l’insérer.
• Constantes : les constantes communes au processus, définies dans Paramètres du processus.
• Fonctions : regroupées par catégorie, elles disposent chacune d’une info-bulle présentant leur signature, leur description et un exemple. Un clic insère le nom de la fonction et ses parenthèses.
• Propriétés de cas et Références de lignes : cliquez sur une référence de ligne pour insérer previous. et commencer à créer une comparaison avec la ligne précédente.

Le champ de recherche trouve les noms, les signatures, les descriptions et les exemples. Il comprend également l’intention : saisissez « days between » ou « sum with condition » pour afficher les fonctions correspondantes. L’icône d’aide dans l’en-tête ouvre la documentation du langage d’expression.

Aperçu

Pour les attributs et les métriques, l’éditeur affiche un aperçu en temps réel Valeurs les plus fréquentes, qui se met à jour pendant la saisie : les résultats les plus fréquents avec leur nombre d’occurrences, ainsi que les intervalles null et other, jusqu’à 20 valeurs. Pendant le chargement de l’aperçu, le message Aperçu de l’expression en cours… s’affiche ; en cas d’erreur, le message Corrigez l’expression pour afficher un aperçu apparaît. Les filtres de lignes ne prennent pas en charge l’aperçu, et l’éditeur l’indique à la place.

Modèles de texte des graphiques

Le texte des graphiques (graphiques de texte, KPI, jauges et cadres HTML) est un modèle : le texte littéral reste tel qu’il est écrit et chaque ${ ... }segment est évalué. L’éditeur valide chaque segment et le met en évidence pendant la saisie. Texte, Html, les expressions de métriques et les expressions de normes s’appliquent uniquement lorsque vous fermez l’éditeur avec Enregistrer ; Annuler abandonne le brouillon. Le texte simple des graphiques et le HTML ne peuvent pas être évalués ligne par ligne. L’éditeur affiche donc Aperçu indisponible pour le texte du graphique à la place de l’aperçu de la valeur.

Les expressions de normes sont évaluées à partir des constantes de Paramètres du processus (par exemple slaTargetDays * 86400000). L’éditeur propose donc des constantes et des fonctions, mais aucun attribut du jeu de données à cet endroit.

Validation et enregistrement

La validation s’effectue en continu pendant la modification. La ligne d’état au bas de la boîte de dialogue affiche soit une coche verte L’expression est valide, soit une erreur rouge telle que Erreur à la position 12 : ‘)’ attendu, mais … obtenu. Les erreurs courantes comprennent les fonctions ou variables inconnues, un nombre incorrect d’arguments, les chaînes non fermées et les incompatibilités de types.

Enregistrer reste désactivé tant que l’expression n’est pas valide ou que des restrictions de filtre de lignes s’appliquent. Effacer le champ puis enregistrer supprime l’expression. Appuyez sur Ctrl/Cmd+Entrée pour enregistrer au clavier, ou sur Annuler pour fermer sans enregistrer.

Ouvrir les expressions associées dans des onglets

Les expressions peuvent faire référence à d’autres attributs calculés. Pour en examiner un pendant la modification, utilisez Ctrl/Cmd+clic sur la référence de l’attribut dans votre expression. Elle s’ouvre alors dans son propre onglet en lecture seule. La barre d’onglets apparaît dès qu’un deuxième onglet existe, et l’aperçu suit l’onglet que vous consultez.

Filtres de lignes : autorisés et bloqués

Un filtre de lignes s’applique à chaque ligne d’événement brute lors du chargement des données, avant le Process Mining. Seules les lignes pour lesquelles l’expression est vraie sont conservées ; les résultats faux, vides ou nuls sont supprimés. Ce contexte limite les éléments que vous pouvez utiliser :

• Autorisé : les propres valeurs de la ligne, c’est-à-dire les attributs du jeu de données et les alias de colonnes intégrés (caseid, time, activity, cost, user, start_time et co2).
• Bloqué : tout ce qui nécessite un contexte au niveau du cas ou entre plusieurs lignes, notamment les propriétés de cas, les agrégats de cas et les fonctions de fenêtre, les références de lignes (previous.), les recherches d’activités telles que first() et les expressions followedBy.

Si vous utilisez un élément bloqué, le bouton Enregistrer est désactivé et le message suivant s’affiche : « Les filtres de lignes peuvent utiliser uniquement les données brutes des lignes. Supprimez les propriétés de cas, les agrégats de cas, les références de lignes, les recherches d’activités ou les expressions de type followed-by. »

Sujets associés

• Langage d’expression : la référence complète des fonctions.
• Introduction aux expressions : notions de syntaxe et exemples.
• Attributs calculés : attributs créés à partir d’expressions.
• Utiliser les filtres : filtrer les Dashboards et le graphe de processus.
• Graphiques de processus : emplacement de configuration des expressions de métriques.