Partager via

Conseils et exemples

  • Article

Formule de mesure

Définissez la formule de mesure sous forme de texte. Il peut s’agir d’opérations prédéfinies.

Les opérations individuelles sont divisées en deux groupes de base :

  • Opérations d’agrégation : l’entrée de l’opération d’agrégation est un ensemble de valeurs pour lesquelles la valeur résultante sera calculée (par exemple, moyenne, maximum, etc.)

  • Opérations scalaires : l’entrée de l’opération scalaire est une ou plusieurs valeurs pour lesquelles la valeur résultante sera calculée (par exemple, valeur absolue du nombre, obtention d’une partie de la taxe, etc.)

Les opérations peuvent utiliser des constantes, peuvent être combinées en utilisant les opérateurs unaires ou binaires (par exemple, addition, soustraction, etc.) ou imbriquées.

Les opérations scalaires comprennent également les opérations d’obtention d’une valeur, soit directement disponible sous la forme d’un attribut, soit sous la forme de statistiques dérivées (durée de l’événement).

Certaines opérations prennent également en charge la spécification du contexte pour lequel l’opération est évaluée. Ceci est important pour les opérations d’agrégation qui peuvent agréger des valeurs, par exemple, uniquement pour une activité spécifique ou pour toutes les activités ou tous les événements. Le contexte implicite résultant du contexte de mesure ou du contexte d’opération parent est également pris en charge.

Une formule de mesure peut renvoyer l’un des types de données pris en charge. Les types de données pour des formules spécifiques sont définis dans cet article à côté de la définition de la syntaxe de la formule.

Opérations d’agrégation

Les opérations d’agrégation sont la base de chaque mesure. Les opérations d’agrégation utilisées les plus couramment sont :

  • COUNT : renvoie le nombre de valeurs agrégées (incl. COUNTIF, COUNTUNIQUE).
  • SUM : renvoie la somme des valeurs agrégées (incl. SUMIF).
  • AVG : renvoie la moyenne des valeurs agrégées
  • MIN : renvoie le minimum des valeurs agrégées.
  • MAX : renvoie le maximum des valeurs agrégées.

Le paramètre volontaire des opérations d’agrégation sera le contexte de l’opération et l’opération scalaire de modification de la valeur d’entrée. La liste complète des contextes de calcul pris en charge est décrite dans Contexte de calcul.

Opérations scalaires

Le but des opérations scalaires est d’obtenir une valeur et sa transformation à l’état souhaité. Les opérations actuellement prises en charge peuvent être divisées en plusieurs types :

  • Mathématique : comprend des opérations pour obtenir la valeur absolue d’un nombre, les arrondis, etc.
  • Date et heure : comprend des opérations pour travailler avec la date (obtenir une partie de la date, additionner des dates, etc.)
  • Chaîne : comprend des opérations pour travailler avec des données de chaîne (obtention d’une sous-chaîne, fractionnement de chaînes, etc).
  • Statistique : comprend des opérations pour obtenir différentes statistiques (nombre d’instances, temps d’attente des instances, etc.)
  • Autre : comprend d’autres opérations, par exemple, opérations d’accès à l’événement, à l’instance, aux statistiques dérivées, etc.

Noms d’attribut

Si un nom d’attribut est utilisé comme paramètre pour l’opération, il existe trois façons de le référencer :

  • Utilisez le nom de l’attribut directement(par exemple, Resource).

  • Utilisez l’opération GETVALUE("nom d’attribut") (par exemple, GETVALUE("Resource")).

  • Utilisez directement le nom d’attribut raccourci (par exemple, attribute "Resource ID" pourrait être référencé comme ResourceID).

La seconde forme est utilisée lorsque le nom de l’attribut ne respecte pas la convention de dénomination. La convention de dénomination des attributs est définie comme suit :

  • Le nom de l’attribut doit commencer par une lettre ou un trait de soulignement.

  • Le nom de l’attribut ne peut contenir que des caractères des classes standard Unicode suivantes : lettre (Lu, Ll, Lt, Lm, Lo ou Nl), caractère de combinaison (Mn ou Mc), caractère de chiffre décimal (Nd), caractère de liaison (Pc ), ou caractère de formatage (Cf).

    Pour plus d’informations sur les classes de caractères Unicode, consultez la Norme Unicode version 3.0, section 4.5.

Le troisième formulaire est facultativement utilisé lorsque le nom de l’attribut respecte la convention de dénomination, mais contient également des espaces. Au lieu d’utiliser la seconde forme GETVALUE("attribute name"), il est possible de supprimer les espaces et d’utiliser la version raccourcie du nom d’attribut, attributename. Les deux formulaires sont équivalents.

Exemples de noms d’attributs VALIDES

  • DocumentCategory

  • DocCat

  • DocCat23

Exemples de noms d’attributs NON VALIDES

  • Document.Category

  • Document Category

  • 23DocCat

Exemples de formules de mesure

Pour calculer la durée relative d’activité dans une carte :

AVG (DURATION()) / AVG (VIEWCASES, DURATION())