Exemple : ajout de mesures à AppOne

Introduction

Les métriques sont utilisées pour définir un calcul une seule fois et le réutiliser dans l’ensemble de l’application. Ceci est particulièrement utile dans les endroits où il est possible d'avoir une étendue d'enregistrements différente. En outre, les métriques peuvent être utilisées pour effectuer le calcul pour différentes agrégations

Par exemple, vous pouvez définir une mesure pour calculer le montant moyen. Cette mesure peut ensuite être réutilisée à différents endroits, par exemple dans la taille des graphiques ou dans des expressions agrégées.

Ajouter des mesures

Dans AppOne, une métrique nouvellement créée doit être ajoutée à deux endroits avant d'être disponible pour l'utilisateur final.

Chaque métrique est ajoutée à une expression de sélecteur de commutateur et, selon l'endroit où la métrique doit être disponible, vous devez modifier l'expression de commutateur correspondante dans l'un des niveaux suivants :

• Incidents
• Events
• Balises
• Dates d’échéance
• Events_with_reference_models
• Cas_avec_référence_modèles

Pour que la mesure s'affiche également sur le tableau de bord, elle doit être ajoutée aux éléments Sélecteur de la commande Sélecteur correspondante.

Exemple

Dans l’exemple ci-dessous, une métrique Nombre d’utilisateurs (Number of users ) est ajoutée au sélecteur de métriques du tableau de bord Processus – Processus – Analyse .

Voir illustration ci-dessous.

Étape 1 Créer la mesure

Suivez les étapes suivantes pour créer une mesure.

Étape	Action
1	Ouvrez AppOne dans votre environnement de développement et accédez à l'onglet Données (Data) .
2	Cliquez avec le bouton droit sur la table Événements (Events) et sélectionnez Nouvelle mesure… (New metric…).
3	Saisissez Nombre d'utilisateurs (Number of users ) dans le champ Nom (Name ).
4	Entrez Metric_number_of_users dans le champ ID .
5	Saisissez dans l'éditeur : count(unique(records.User))
6	Cliquez sur OK.

Une nouvelle mesure Nombre d'utilisateurs (Number of users) est créée.

Étape 2 Ajouter la mesure à la commande de sélecteur

Suivez ces étapes pour l'ajouter à la commande de sélecteur dans le tableau de bord.

Étape	Action
1	Accédez à l'onglet Tableaux de bord (Dashboards).
2	Localisez le menu Processus et cliquez sur le graphique Quelles activités se produisent dans quels cas ? . Voir illustration ci-dessous.
3	Accédez à l'onglet Graphique .
4	Double-cliquez sur la mesure Metric(Selector_metric_filtered_cases) selector dans les commandes d'en-tête du graphique. Remarque : vous pouvez localiser ce sélecteur en le recherchant dans l'onglet Données (Data) .
5	Cliquez avec le bouton droit sur le champ Éléments du sélecteur et sélectionnez Ajouter....
6	Sélectionnez la mesure Nombre d'utilisateurs (Number of users) et cliquez sur OK. Voir l'illustration ci-dessous.

Le sélecteur contient maintenant la nouvelle mesure en option.

Étape 3 Ajouter la métrique au commutateur correspondant

Les commutateurs sont des expressions utilisées pour déterminer l'attribut ou la mesure sélectionné(e). La nouvelle métrique doit également être ajoutée aux commutateurs de métriques. Suivez ces étapes pour ajouter la métrique au commutateur de métrique correspondant.

Étape	Action
1	Accédez à l'onglet Données (Data).
2	Cliquez avec le bouton droit sur Metric Selector_metric_filtered_cases) et sélectionnez Avancé - Afficher les références…. Le panneauOutils (Tools) s'ouvre et affiche tous les emplacements où le sélecteur est utilisé. Voir l'illustration ci-dessous.
3	Double-cliquez sur Basculer les cas filtrés par métrique (historique) pour modifier l’expression.
4	Ajoutez les lignes suivantes après le uid(Metric_percentage_of_filtered_cases_comparison) aux cas filtrés de la métrique Basculer (historique): , uid(Metric_number_of_users) , uid(Metric_number_of_users). Voir illustration ci-dessous.
5	Répétez les étapes 3 et 4 pour tous les sélecteurs répertoriés dans le panneau Outils (Tools).

La nouvelle métrique est ajoutée aux commutateurs pertinents.

Le sélecteur des tableaux de bord Activités ( Activities ) et Analyse (Analysis) dans le menu Processus (Process) contient désormais une mesure supplémentaire. Voir l'illustration ci-dessous.