Maîtriser les variables dans Qlik

Une variable Qlik est un conteneur nommé qui peut stocker une valeur statique ou une définition de calcul. Elle permet de centraliser une information et de la réutiliser dans le script ou dans les expressions.

Une variable est utile quand une valeur ou une logique doit être centralisée, paramétrée ou réutilisée.

SET affecte le texte situé à droite du signe égal. LET évalue d’abord l’expression, puis affecte le résultat à la variable.

Cette différence explique une grande partie des comportements surprenants avec les variables.

SET vA = 3+4;
LET vB = 3+4;

// $(vA) → 3+4
// $(vB) → 7

La dollar-sign expansion remplace $(vVariable) par le contenu de la variable avant que l’expression finale soit interprétée.

Pour déboguer une variable, demande-toi toujours : « quel texte Qlik voit-il après expansion ? ».

SET vCA = Sum(Montant);

// Expression :
$(vCA)

// Qlik interprète finalement :
Sum(Montant)

Une définition qui commence par = peut être calculée avant son expansion. Une définition sans = peut au contraire servir de morceau d’expression à injecter.

Ne mets pas = automatiquement devant toutes les variables : choisis selon l’usage recherché.

// vCA contient :
Sum(Montant)

// vCAFixe contient :
=Sum(Montant)

Une convention de nommage permet de comprendre immédiatement le rôle d’une variable. Le préfixe v est courant et lisible.

Le nom doit dire ce que contient la variable, pas seulement où elle est utilisée.

LET vAnneeCourante = Year(Today());
SET vExprCA = Sum(Montant);
LET vSeuilMarge = 0.25;

Les variables sont très utiles pour centraliser des chemins, dates, paramètres de reload ou morceaux de script.

Pour les chemins et paramètres d’environnement, centraliser évite les remplacements manuels dispersés.

LET vDateReload = Now();
SET vCheminQVD = lib://QVD/;

VENTES:
LOAD *
FROM [$(vCheminQVD)Ventes.qvd] (qvd);

Une variable peut contenir une expression complète et être réutilisée dans plusieurs visualisations.

Variables et Master Measures sont complémentaires, pas concurrentes.

SET vExprMarge =
Sum(Marge) / Sum(Montant);

// Dans une mesure :
Num($(vExprMarge), '0.0%')

Les dollar-sign expansions sont très utilisées pour injecter une valeur calculée dans un élément de Set Analysis.

Pour les chaînes et les dates, pense au format et aux guillemets attendus après expansion.

LET vAnnee = Year(Today());

Sum({
  <Annee={$(vAnnee)}>
} Montant)

Une dollar-sign expansion peut contenir directement une expression. Dans ce cas, le contenu entre parenthèses commence par = et est évalué avant injection.

Si le calcul doit ignorer les sélections, son propre Set Analysis peut être nécessaire.

Sum({
  <Annee={$(=Max(Annee))}>
} Montant)

Le résultat d’une expansion doit respecter la syntaxe attendue par l’expression finale. Les chaînes ont généralement besoin de quotes ; les dates doivent être formatées de façon compatible avec le champ.

Quand ça ne marche pas, écris à la main l’expression que tu penses obtenir et compare.

SET vPays = France;

Sum({
  <Pays={'$(vPays)'}>
} Montant)

Une variable peut utiliser des paramètres formels $1, $2, $3… et fonctionner comme un petit gabarit réutilisable.

Puissant, mais à réserver aux cas où le gain de réutilisation compense la complexité.

SET vRatio = Sum($1) / Sum($2);

// Utilisation :
$(vRatio(Marge,Montant))

Les variables peuvent aussi être créées et consultées depuis l’interface Variables de Qlik Sense. Une modification se répercute partout où la variable est utilisée.

Dans une application publiée, les possibilités d’édition dépendent du contexte et des contrôles disponibles.

La méthode la plus fiable consiste à observer ce que l’expansion produit réellement. Décompose l’expression complexe en étapes simples.

L’éditeur d’expression peut afficher un aperçu des dollar-sign expansions, ce qui aide énormément.

// Tester d'abord :
=$(vAnnee)

// Puis :
Sum({<Annee={$(vAnnee)}>} Montant)

Les erreurs les plus fréquentes viennent de SET/LET, du signe =, des quotes, du format des dates, d’une expansion calculée dans un contexte inattendu ou d’une variable devenue trop complexe.

Évite les chaînes de variables qui appellent des variables qui appellent encore d’autres variables sans nécessité.