Fonctions Mesure calculée avancés

Modifié par Aurelie Bertrand le 2024/11/26 10:41

❗La fiche résolution est susceptible de ne pas fonctionner selon la version utilisée. Le cas échéant, veuillez contacter le support en décrivant ce qui ne fonctionne pas.

Il est possible de réaliser des mesures calculées avancées en utilisant des fonctions javascripts.
Nous pouvons exécuter des tests "if" par exemple, ou des boucles "for".
Mais il y a aussi des fonction digdash permettant d'explorer des dimensions.

Vérifier le contenu de la mesure calculée avec les logs

Il est possible d'afficher une ligne dans les logs digdash grâce à la fonction :

Packages.com.digdash.utils.MessageStack.getInstance().addText("Je suis dans les logs !!! ");

Exemple :

1600944409879-673.png

Rendu dans les logs lors de l'affichage de cette mesure dans un graphique : 

1600944499398-123.png

Cela peut vous permettre de vérifier les différentes étapes de calcul de votre mesure calculée.

Connaitre les dimensions filtrées

  • Exemple:
for (var i = 0; i < this.selection.dimsToFilter.length; i++)
{
      var dimId = this.selection.dimsToFilter[i].dim.id;
      Packages.com.digdash.utils.MessageStack.getInstance().addText("Nom dimension: " + dimId);
}
  • Résultat:
    Nom dimension: Date
    Nom dimension: Produit
    Nom dimension: Régions
  • Usage:

Peut être utile lorsqu’on veut renvoyer une valeur différente si une ou plusieurs dimensions sont filtrées. Nous pourrions ainsi tester la valeur de dimId est renvoyé une mesure différente en fonction.

A partir de la version 2022R1, il est possible d'utiliser un objet spécifique (filters) contenant la liste des dimensions filtrées.

  • Exemple:
var filter = filters[dimId];
var hierarchy = filter.hierarchy;
var level = filter.level;
var mode = filter.mode;

//filtre de type liste
var members = filter.selectedMembers;

//filtre de type intervalle
var min = filter.min;
var max = filter.max;

//filtre de type Ensemble
var setId = filter.setId;

//filtre de type Règle
var operators = filter.operators;
var values = filter.values;
  • Usage:

Il est préférable d'utiliser cette version de scripts, elle permet une optimisation des calculs des mesures.

Connaitre les dimensions explorées

  • Exemple:
for (var i = 0; i < this.selection.dimsToExplore.length; i++)
{
      var dimId = this.selection.dimsToExplore[i].dim.id;
      Packages.com.digdash.utils.MessageStack.getInstance().addText("Nom dimension: " + dimId);
}
  • Résultat:

Nom dimension: Date
Nom dimension: Produit
Nom dimension: Régions

  • Usage:

Peut être utile lorsqu’on veut renvoyer une valeur différente si une ou plusieurs dimensions sont explorées dans le graphique.

A partir de la version 2022R1, il est possible d'utiliser un objet spécifique (dimsExplorer) contenant la liste des dimensions explorées dans le graphique.

  • Exemple:
var dimExplorer = dimsExplorer[dimId];
var hierarchy = dimExplorer.hPos;
var level = dimExplorer.lPos;
  • Usage:

Il est préférable d'utiliser cette version de scripts, elle permet une optimisation des calculs des mesures.

Le double passage

  • Exemple:
// needSecondPass : DO NOT REMOVE THIS LINE
if (phase == 0)
{
// do something
}
else
{
// do something
}
  • Résultat:

Oblige à passer à deux reprise dans la mesure calculée

  • Usage:

Peut être utile pour enregistrer des valeurs la 1ère fois (dans un tableau par exemple) puis dans un second temps renvoyer des résultats suivant les valeurs dans ce tableau.

Objet Global

  • Exemple:
if (!_global.count)
{
 _global.count = 1;
}
else
{
 _global.count = _global.count + 1;
}
return _global.count;
  • Résultat:

1
2
3
… (suivant le nombre de valeur à représenter dans la visualisation)

  • Usage:

Permet de sauver des valeurs dans des variables au cours de l'exécution d’une mesure calculée

Cumul sur n’importe quel axe

Exemple :  Exploration de numéros de semaine (NUM_WEEK) et de dates (DAY_DT), nous souhaitons cumuler le CA sur chacune des semaines.
! Attention ! La date doit être ordonnée de manière croissante dans la source

// needSecondPass : DO NOT REMOVE THIS LINE
var section = NUM_WEEK(dmember) + "";
var key = DAY_DT(dmember) + "";
var val = CA TTC [N](NO_AGG);
if (phase == 0)
{
function add(accumulator, a)
 {
     return accumulator + a;
 }
if (!_global.vals)
 {
  _global.vals = {};
  _global.run = {};
 }
if (!_global.vals[section])
 {
  _global.vals[section] = {};
  _global.run[section] = new Array();
  _global.run[section].push(0);
 }
if (!_global.vals[section][key])
 {
  _global.vals[section][key] = _global.run[section].reduce(add) + val;
  _global.run[section].push(val);
 }
Packages.com.digdash.utils.MessageStack.getInstance().addText("***PHASE0 _global.vals[" + section + "][" + key + "]: " + _global.vals[section][key] + " val: " + val);
}
else
{
Packages.com.digdash.utils.MessageStack.getInstance().addText("***PHASE1 _global.vals[" + section + "][" + key + "]: " + _global.vals[section][key]);
return _global.vals[section][key];
}