Calculer une dimension numérique

Qu'est-ce qu'une dimension Calculer un nombre ?

Ce type de dimension enrichit votre carte avec des données, comme toute autre dimension. Mais la valeur sur une carte n'est pas choisie manuellement dans le dialogue d'édition de la carte, elle est le résultat d'un calcul impliquant des valeurs fournies par d'autres dimensions de votre carte.

Exemple

Disons que vous avez une dimension numérique appelée Budget, et que vous aimeriez calculer Budget avec taxe. La formule pourrait être la suivante (pour 21% de TVA) :

D'où viennent les nombres bruts ?

Il y a deux sources de nombres bruts utilisables dans des expressions plus larges :

1. Les dimensions Suivre n'importe quel nombre fournissent un nombre direct encodé sur les cartes elles-mêmes

   

2. Les dimensions avec des nombres associés aux valeurs. D'abord, vous devez activer l'option sur la dimension elle-même et la sauvegarder (CTRL-S) :

   

   Ensuite, vous pouvez associer des nombres aux valeurs :

   

Le langage d'expression

Le langage d'expression utilise Elo, qui peut être utilisé pour calculer n'importe quel nombre souhaité. Dans ces expressions :

• _ désigne la carte courante, sur laquelle la valeur calculée s'applique,
• _.xxx désigne la valeur de la carte le long de la dimension dont le nom est xxx (au format snake_case ; si votre dimension s'appelle Temps passé, la variable est temps_passe)
• _.xxx.id désigne l'identifiant de la valeur, pour les dimensions avec une liste de valeurs définies sur les cartes (utilisez simplement _.xxx pour les nombres, dates et texte libre)
• _.xxx.semantics désigne la valeur sémantique, pour les dimensions avec des nombres associés aux valeurs (deuxième cas de la section précédente)

Comment trouver les codes des dimensions ?

Dans l'éditeur de formules, appuyer sur _. devrait vous fournir une suggestion montrant la liste des dimensions :

Pour une dimension particulière, vous trouverez le code à utiliser dans les formules dans le panneau Général lors de son édition :

Comment écrire de la logique en fonction des valeurs d'autres dimensions ?

Disons que vous voulez écrire une logique complexe pour votre pourcentage de taxe en fonction du type de produit, suivi dans une autre dimension :

Les identifiants des valeurs de dimension que vous pouvez référencer dans une telle formule se trouvent dans le panneau Valeurs des détails de la dimension :

Où obtenir de l'aide ?

Écrire des formules est toujours un peu difficile pour les non-techniciens. Rejoignez notre communauté Klarocardistas pour obtenir de l'aide immédiate.

Aller plus loin

• À partir de Klaro Cards 0.259.0, Klaro Cards utilise Elo qui est simple, propre et puissant. La documentation en ligne vaut certainement la peine d'être lue.
• Pour les instances professionnelles sur des versions antérieures, Klaro Cards utilise encore le langage Livescript.