Calcul

TABLE DES MATIÈRES

• Comment fonctionne la mesure de calcul ?
• Avancé
  • Texte manquant
  • Afficher le résultat du calcul
  • Expressions mathématiques approuvées
• Exemples de composants de calcul avancés
  • Exemple : référence à un élément de liste basé sur une option déroulante dans un calcul
  • Exemple : référence à un élément de liste dans un calcul
  • Exemple : référence à différents éléments d'une liste dans un calcul en fonction de l'unité organisationnelle
  • Exemple : calcul d'une valeur en fonction d'autres valeurs de mesure

Comment fonctionne la mesure de calcul ?

Le calcul permet de créer des calculs sur le canevas. La formule de calcul est créée à l'aide d'une syntaxe similaire à celle d'Excel. Les différentes mesures sont désignées par le nom du système. Un calcul peut inclure :

• Valeurs numériques.
• Résultats cumulés.
• Résultats d'autres calculs.
• Valeurs dynamiques basées sur le choix du journaliste dans un menu déroulant.

Exemple de valeurs dynamiques : si un menu déroulant contient une liste de combinaisons énergétiques, chacune avec un facteur d'émission, lorsque le déclarant effectue une sélection dans le menu déroulant, les valeurs de l'option choisie seront incluses dans le calcul. 

Calcul dans le générateur de mesures.

Lorsqu'il est fait référence à une autre mesure dans la formule de calcul, les variables sont mises en évidence en  bleu clair
. Lorsque vous cliquez dessus, le Canvas met en évidence les mesures connectées en jaune.

Variables mises en évidence lorsqu'elles sont mentionnées et connectées. 

À droite du générateur de mesures, dans les paramètres, vous trouverez les options suivantes :

• Nom
• Unité - À partir d'une liste ou de votre unité personnalisée
• Format des nombres - Nombre ou Général
• Sélectionner le nombre de décimales à afficher - Le nombre de décimales qui seront affichées au rapporteur
• Utilisez un séparateur de milliers - Voir l'exemple ci-dessous.
  • non coché - Le nombre s'affichera sous la forme 2000.
  • coché - Le nombre s'affichera sous la forme 2 000 (SWE) ou 2 000 (ENG)
• Formule de calcul
• Texte manquant
• Description
• Afficher le résultat - Souhaitez-vous que ce soit un calcul masqué ? Dans ce cas, les données seront accessibles dans Analytics, mais ne seront pas affichées au rapporteur.

Exemple 1.

Dans cet exemple, quatre nombres font partie de deux calculs (remarquez comment ils sont combinés entre parenthèses). La somme des deux nombres est ensuite calculée en haut. Consultez l'image du haut pour voir le générateur de mesures et la vidéo du bas pour voir à quoi cela ressemble pour le journaliste.

Remarque : les calculs n'afficheront aucun résultat tant que toutes les données requises n'auront pas été saisies.

Avancé

Texte manquant

Tant que tous les chiffres requis dans le canevas n'auront pas été communiqués, la mesure Calculation affichera ce texte. Le texte par défaut est « - ».

Afficher le résultat du calcul

Lorsque cette option est activée, le calcul s'affiche pour le Reporter dans le canevas. Il est activé par défaut.

Cela peut être le cas si des calculs intermédiaires sont nécessaires dans le canevas et/ou les exportations de données, mais ne doivent pas être affichés pour le Reporter.

Exemple 2.

Dans cet exemple, quatre nombres font partie de deux calculs (remarquez comment ils sont combinés entre parenthèses). Le résultat total des deux calculs est ensuite calculé dans le calcul en haut.

Quatre entrées numériques, trois calculs. 

L'enquête qui en résulte :

Notez que les calculs n'afficheront aucun résultat tant que toutes les données requises n'auront pas été saisies.

Expressions mathématiques approuvées

À l'exception de l' ordinaire +/-*

• Expression pour l'équation exponentielle pow(a, b) -  (par exemple, pow(3, 2) = 3² = 9) pow(a, b) -  (par exemple, pow(3, 2) = 3² = 9) 
• Expression pour la racine carrée sqrt(a)  -  (par exemple, sqrt(9) = 3)
• Expression permettant de renvoyer le plus petit nombre min(a, b, ...) parmi tous les nombres donnés (par exemple, min(10, 20, 15) = 10).
• Expression permettant de renvoyer le plus grand nombre max(a, b, ...) parmi tous les nombres donnés  - (par exemple, max(10, 20, 15) = 20)

Exemples de composants de calcul avancés

Exemple 3 : Référence à un élément de liste basé sur une option déroulante dans un calcul

Si vous souhaitez faire référence à un facteur qui change en fonction du choix du rapporteur dans une liste déroulante, le mot-clé data est utilisé.

Voir l'exemple ci-dessous, où le nom système de la mesure déroulante est EnergyMix et la valeur de l'élément de liste est {"factor_scope_2": 329.19} :

EnergyMix.data.factor_scope_2

Exemple 4 : Référence à un élément de liste dans un calcul

Il est recommandé de stocker les facteurs utilisés dans un calcul dans une liste pouvant évoluer au fil du temps à l'aide de la date de début de validité. Cette liste doit être conservée en un seul endroit et ne doit pas être reproduite dans plusieurs calculs portant sur plusieurs mesures. Pour faire référence à un élément de liste, il est possible d'utiliser un mot-clé spécial pgLists. En savoir plus sur la gestion des listes.

Voir l'exemple ci-dessous, où le PrettyID de la liste est energy_list, le PrettyID de l'élément de liste est water_item et la valeur de l'élément de liste est {"factor_scope_1": 23} :

pgLists.énergie_liste.eau_élément.facteur_portée_1

Exemple 5 : Référence à différents éléments d'une liste dans un calcul en fonction de l'unité organisationnelle

Si vous souhaitez faire référence à différents éléments de liste dans un calcul en fonction de l'unité organisationnelle pour laquelle vous établissez votre rapport, vous devez utiliser le même identifiant Pretty Id pour les éléments de liste que pour l'unité organisationnelle correspondante.

Si l'identifiant Pretty Id de l'unité organisationnelle est « Stockholm », l'identifiant Pretty Id de l'élément correspondant de la liste doit également être « Stockholm ». Si le Pretty Id de la liste est energy_list et que la valeur de l'élément de la liste est {"factor_heating_scope_2": 232}, le code dans la mesure doit être :

(listValue("energy_list",orgUnitPrettyId)).facteur_chauffage_portée_2

Exemple 6 : Référence à un nombre qui autorise des données manquantes

Lorsque vous faites référence à un nombre dans un calcul qui autorise les données manquantes, vous devez faire un choix. Le calcul ne pourra pas produire de résultat si l'une des variables d'entrée est marquée comme manquante par le déclarant. Cela peut être le comportement souhaité, par exemple dans un calcul qui va calculer une moyenne, vous ne voudrez peut-être pas inclure la valeur si elle est marquée comme manquante. En revanche, si le calcul doit additionner deux nombres, la valeur par défaut peut être 0.

Par défaut, le calcul ne pourra pas produire de résultat si le nombre measure_missing est marqué comme manquant.

mesure_manquante + 10

Pour définir une valeur par défaut (0) si le nombre est marqué comme manquant, vous pouvez mettre à jour l'expression afin d'utiliser la fonction getValue et fournir une valeur par défaut. Cela peut être utile si le calcul est basé sur une mesure conditionnelle qui n'a pas toujours une valeur. La formule peut être utilisée comme suit :

getValue(mesure_manquante, 0) + 10

(a la valeur (mesure_manquante) ? mesure_manquante : autre_contrôle) * 100

Exemple 7 : calcul d'une valeur en fonction d'autres valeurs de mesure

Si vous souhaitez attribuer une valeur à un calcul en fonction de la valeur d'autres mesures, vous pouvez utiliser l'exemple ci-dessous comme modèle.

mesure_1 == 'DBOui' ou mesure_2 == 'DBNon' ? 1 : 0