Métriques

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. Par exemple, vous pouvez créer une mesure pour calculer le nombre de factures , ou une mesure pour calculer le montant moyen. Ces métriques peuvent ensuite être réutilisées à différents endroits, tels que des graphiques ou des expressions agrégées.

Métriques vs Expressions

Les expressions et les métriques ont toutes deux un objectif spécifique et fonctionnent différemment. Les expressions créent une valeur par enregistrement. Les métriques n’ont pas de valeur en elles-mêmes. Une métrique doit être utilisée à un endroit où les enregistrements sont accessibles, par exemple agréger des expressions, des graphiques et des panneaux HTML.

La même mesure peut être utilisée à de nombreux endroits, tandis que les expressions sont adaptées à un objectif spécifique.

Les métriques peuvent également être utilisées dans les calculs d’autres métriques.

Remarque : pour utiliser une mesure dans une expression, elle doit être précédée de la fonction metric . L'utilisation de cette fonction est nécessaire pour évaluer la métrique.

Création d'une mesure

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

Étape	Action
1	Ouvrez l'application dans votre environnement de développement et accédez à l'onglet Données (Data) .
2	Dans la liste des éléments de table, cliquez avec le bouton droit sur la table pour laquelle vous souhaitez créer une mesure et sélectionnez Nouvelle mesure....
3	Saisissez l'expression pour définir la mesure dans l'éditeur d' expressions .
4	Validez le résultat dans le panneau des résultats à droite.
5	Cliquez sur OK.

La nouvelle mesure est créée dans la liste des éléments de la table et identifiée par le icône.

Utilisation de la métrique dans un graphique

Suivez ces étapes pour utiliser la mesure dans un graphique.

Étape	Action
1	Accédez à l'onglet Tableaux de bord (Dashboards) et créez un tableau de bord basé sur la table dans laquelle le contrôle de métrique est présent.
2	Accédez à l'onglet Graphique .
3	Sélectionnez l'attribut que vous souhaitez afficher dans le graphique dans la liste déroulante Lignes .
4	Sélectionnez la métrique dans la liste déroulante Métrique (Metric).

Consultez l'illustration ci-dessous pour voir un exemple.

Dans l'exemple, l'attribut Type de facture est utilisé pour le graphique et la mesure Montant moyen (Metric Average) qui calcule le revenu total généré en moyenne par une facture. La taille de la barre est égale au nombre de montants moyens par catégorie.

Utilisation d'une métrique dans un graphique hérité

Suivez ces étapes pour utiliser la mesure dans un graphique hérité.

Étape	Action
1	Accédez à l'onglet Tableaux de bord (Dashboards) et créez un tableau de bord basé sur la table dans laquelle le contrôle de métrique est présent.
2	Accédez à l'onglet Graphique .
3	Faites glisser l'attribut que vous souhaitez afficher dans le graphique vers le niveau Lignes .
4	Remplacez la Taille par Expression.
5	Cliquez sur `expression` et saisissez une expression pour utiliser la mesure que vous avez créée. Par exemple `metric(Metric_Average_Amount)`.
6	Cliquez sur OK.