Mesures

Les Mesures sont les indicateurs clés de performance (KPI) et les points de données qui sont calculés dynamiquement lors de l'exécution du processus. Elles permettent de puissantes capacités de rapport, d'analyse et de surveillance des processus en extrayant et en transformant les données métier de vos variables de processus.

L'interface des mesures de processus fournit un aperçu visuel de tous les KPI et métriques configurés, montrant comment les données de flux de travail sont transformées en informations métier exploitables à des fins de surveillance et de rapport.

Aperçu​

Les mesures de processus servent de pont entre vos données d'exécution de flux de travail et l'intelligence métier. Elles vous permettent de :

• Suivre les KPI en temps réel lors de l'exécution du processus
• Générer des rapports avec des métriques métier significatives
• Surveiller les performances sur les instances de processus
• Analyser les tendances et les modèles dans vos flux de travail
• Créer des tableaux de bord avec des valeurs métier calculées

Comment Fonctionnent les Mesures​

Calendrier de Calcul​

Les mesures sont calculées automatiquement aux points clés lors de l'exécution du processus :

• Démarrage du Processus : Calcul initial avec les variables de démarrage
• Avant les Tâches Utilisateur : Mise à jour avec l'état du processus actuel
• Achèvement de la Tâche : Recalculé après l'achèvement de la tâche
• Événements du Processus : Mis à jour lors des événements de minuteur, appels de service, etc.
• Fin du Processus : Calcul final pour les instances complétées

Stockage des Données​

• Les mesures sont stockées dans la base de données d'instance de processus
• Les valeurs sont indexées pour les requêtes de rapport rapides
• Les données historiques sont conservées pour l'analyse des tendances
• Les valeurs actuelles et historiques sont disponibles pour la création de rapports

Configuration des Mesures​

Ce panneau de configuration vous permet de créer des métriques métier personnalisées en définissant une étiquette descriptive, en sélectionnant le type de données approprié et en écrivant des expressions JavaScript qui calculent les valeurs de vos variables de processus.

Propriétés de Base​

Chaque mesure se compose de trois composants essentiels :

1. Étiquette​

• Objectif : Le nom/identifiant de la mesure
• Utilisation : Utilisée comme noms de colonnes dans les rapports et les tableaux de bord
• Exemple : CoûtTotal, DuréeTraitement, SatisfactionClient
• Bonne Pratique : Utilisez des conventions de nommage descriptives et cohérentes

2. Type​

Définit comment la valeur de mesure doit être traitée et stockée :

• Texte : Valeurs de texte, catégories, descriptions de statut
  • Exemple : "Approuvé", "Priorité Élevée", "Département Finance"
• Nombre : Calculs numériques, comptages, valeurs monétaires
  • Exemple : 1250.50, 45, 0.95
• Booléen : Drapeaux vrai/faux, indicateurs oui/non
  • Exemple : true, false
• Date : Horodatages, délais, jalons
  • Exemple : new Date(), "2024-12-31"
• Quelconque : Objets complexes, tableaux ou types de données mixtes
  • Exemple : {status: "active", items: [1,2,3]}

3. Champ (Expression JavaScript)​

L'expression JavaScript qui calcule la valeur de mesure à l'aide des variables de processus.

Mesures Système par Défaut​

Softyflow fournit automatiquement plusieurs mesures système pour chaque processus :

Mesures de Suivi du Processus​

• SF_last_activity_name : Nom de la dernière activité exécutée
• SF_involved_users : Tableau de tous les utilisateurs qui ont participé au processus
• SF_involved_validators : Tableau des utilisateurs qui ont validé les tâches
• SF_involved_roles : Tableau des rôles auxquels des tâches ont été assignées
• SF_observer : Tableau des rôles d'observateur
• SF_priority : Niveau de priorité actuel du processus
• SF_description : Texte de description du processus

Métadonnées d'Instance (Disponibles dans les Rapports)​

• SF_status : Statut de l'instance de processus (en cours d'exécution, terminé, erreur)
• SF_name : Nom de l'instance de processus
• SF_createdAt : Horodatage de démarrage du processus
• SF_updatedAt : Horodatage de la dernière mise à jour
• SF_createdBy : Informations sur l'initiateur du processus

Utilisation des Mesures dans les Rapports​

Cette vue de configuration du rapport démontre comment les mesures de processus deviennent disponibles en tant que colonnes de rapport, permettant aux utilisateurs de sélectionner, filtrer, trier et visualiser des métriques personnalisées aux côtés des données générées par le système pour une analyse complète.

Configuration des Colonnes de Rapport​

Les mesures deviennent disponibles en tant que colonnes dans vos rapports. Lors de la configuration des colonnes de rapport :

1. Mesures Personnalisées : Toutes les mesures de processus apparaissent en tant que colonnes sélectionnables
2. Mesures Système : Les mesures intégrées sont automatiquement disponibles
3. Types de Données : Les types de colonnes correspondent à la configuration du type de mesure
4. Filtrage : Les mesures peuvent être utilisées pour le filtrage et le tri des rapports

Bonnes Pratiques​

Conception des Mesures​

1. Noms Significatifs : Utilisez des étiquettes descriptives que les utilisateurs métier comprennent
2. Nommage Cohérent : Suivez les conventions de nommage dans tous les processus
3. Types Appropriés : Choisissez le type de données correct pour chaque mesure
4. Considérations de Performance : Évitez les calculs trop complexes

Rédaction d'Expressions​

1. Gestion des Erreurs : Utilisez la logique conditionnelle pour gérer les valeurs null/undefined
2. Sécurité des Types : Assurez-vous que les calculs correspondent au type de données attendu
3. Lisibilité : Gardez les expressions claires et bien documentées
4. Tests : Testez les expressions avec divers scénarios de données

Intégration des Rapports​

1. Sélection de Colonnes : Incluez les mesures pertinentes pour vos besoins d'analyse
2. Stratégie de Filtrage : Utilisez les mesures pour un filtrage de données efficace
3. Planification d'Agrégation : Considérez comment les mesures seront groupées et résumées
4. Optimisation des Performances : Soyez conscient de la complexité des requêtes avec de nombreuses mesures

Dépannage​

Problèmes Courants​

Erreurs d'Expression​

• Symptôme : La mesure affiche une valeur vide
• Cause : Erreur d'expression JavaScript ou variable undefined
• Solution : Vérifiez les noms des variables et ajoutez des vérifications null

// Problème : La variable peut être undefined
{
  {
    customer.name;
  }
}

// Solution : Ajouter une vérification null
{
  {
    customer ? customer.name : "Unknown";
  }
}

Incompatibilités de Types​

• Symptôme : Valeurs inattendues dans les rapports
• Cause : L'expression retourne un type différent de celui configuré
• Solution : Assurez-vous que le résultat de l'expression correspond au type de mesure

// Problème : Chaîne retournée pour le type Nombre
{
  {
    status === "active" ? "Yes" : "No";
  }
}

// Solution : Retourner une valeur numérique
{
  {
    status === "active" ? 1 : 0;
  }
}

Problèmes de Performance​

• Symptôme : Génération de rapport lente
• Cause : Calculs de mesure complexes
• Solution : Simplifiez les expressions ou pré-calculez les valeurs

Conseils de Débogage​

1. Tester les Variables : Vérifiez que les variables de processus contiennent les données attendues
2. Simplifier les Expressions : Commencez par des expressions simples et augmentez progressivement la complexité
3. Vérifier les Types : Assurez-vous que les types de mesure correspondent aux résultats de l'expression
4. Surveiller les Performances : Surveillez le temps de calcul dans les journaux de processus

Les mesures de processus sont des outils puissants qui transforment vos données de flux de travail en informations métier exploitables. En configurant et en utilisant correctement les mesures, vous pouvez créer des solutions de rapport complètes qui fournissent des informations approfondies sur vos processus métier et leurs performances.