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 mesure 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 soit également affichée sur le tableau de bord, elle doit être ajoutée aux éléments de Sélecteur de la commande de Sélecteur correspondante.

Exemple

Dans l'exemple ci-dessous, une mesure Nombre d'utilisateurs est ajoutée au sélecteur de mesures 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 .
2	Cliquez avec le bouton droit sur la table Événements et sélectionnez la Nouvelle mesure….
3	Saisissez Nombre d'utilisateurs dans le champ Nom .
4	Saisissez Métrique_nombre_d'utilisateurs dans le champ ID .
5	Saisissez dans l'éditeur : count(unique(records.User))
6	Cliquez sur OK.

Une nouvelle mesure Nombre d'utilisateurs 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 apparaissent 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 .
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 et cliquez sur OK . Voir 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 Sélecteur de métriques_metric_filtered_cases) et sélectionnez Avancé - Afficher les références…. Le panneauOutils s'ouvre et affiche tous les emplacements où le sélecteur est utilisé. Voir illustration ci-dessous.
3	Double-cliquez sur Basculer les cas filtrés par la mesure (historique) pour modifier l'expression.
4	Ajoutez les lignes suivantes après uid(Metric_percentage_of_filtered_cases_comparison) aux incidents filtrés de la mesure 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 .

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

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