TUTORIEL · QLIK SENSE

Maîtriser les variables dans Qlik

SET, LET, dollar-sign expansion, expressions, paramètres et Set Analysis : comprendre enfin ce que Qlik évalue réellement.

Références Qlik

Ce tutoriel s’appuie sur la documentation officielle Qlik. Les exemples et explications SOSQLIK sont reformulés dans une progression pratique, du premier SET aux expansions paramétrées.

Qlik Help — Using variables in expressions Qlik Help — Examples of using a variable in an expression Qlik Help — Let Qlik Help — Dollar-sign expansion using an expression Qlik Help — Dollar-sign expansion using parameters

BIENVENUE

À quoi sert une variable ?

Fondamentaux

Premier exemple

VariableSET vSociete = 'SOSQLIK';Utilisation : $(vSociete)

À quoi ça sert ?

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.

👶 L’idée simple

Au lieu d’écrire la même valeur ou la même expression partout, on lui donne un nom. Si elle change, on la modifie à un seul endroit.

✓ Avantages

Évite les répétitions
Facilite la maintenance
Permet des expressions dynamiques

△ Points de vigilance

Une variable mal nommée rend le code opaque
Une expansion mal maîtrisée peut produire une expression invalide

1 / 15

CHAPITRE 1

SET ou LET ?

Essentiel

Exemple Qlik Sense

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

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

À quoi ça sert ?

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

👶 À retenir

SET garde la recette. LET calcule la recette et garde le résultat.

SET vA = 3+4garde le texte3+4

→

LET vB = 3+4évalue d'abord7

✓ Avantages

SET est idéal pour conserver une expression
LET est idéal pour figer un résultat calculé

△ Points de vigilance

Confondre les deux produit souvent des résultats inattendus

2 / 15

CHAPITRE 2

Comprendre $(vVariable)

Essentiel

Exemple Qlik Sense

SET vCA = Sum(Montant);

// Expression :
$(vCA)

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

À quoi ça sert ?

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

👶 Imagine un copier-coller

Qlik remplace d’abord $(vCA) par son contenu, puis analyse l’expression obtenue.

1$(vCA)appel de la variable

→

2Sum(Montant)texte injecté

→

3RésultatQlik évalue l'expression

✓ Avantages

Permet de construire des expressions réutilisables
Très puissant avec le Set Analysis

△ Points de vigilance

Les guillemets et parenthèses doivent rester valides après expansion

3 / 15

CHAPITRE 3

Variable avec ou sans =

Intermédiaire

Exemple Qlik Sense

// vCA contient :
Sum(Montant)

// vCAFixe contient :
=Sum(Montant)

À quoi ça sert ?

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.

👶 Différence importante

Sum(Montant) peut être injecté comme expression. =Sum(Montant) représente une variable calculée : son résultat peut être développé avant le calcul de l’objet.

✓ Avantages

Permet de distinguer expression à injecter et valeur calculée

△ Points de vigilance

Deux définitions presque identiques peuvent donner des résultats très différents

4 / 15

CHAPITRE 4

Bien nommer ses variables

Bonnes pratiques

Exemple Qlik Sense

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

À quoi ça sert ?

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

On peut aller plus loin avec des conventions simples : vDateMax, vAnneeCourante, vExprCA, vCouleurAlerte, vSeuilMarge.

✓ Avantages

Expressions plus lisibles
Maintenance plus rapide

△ Points de vigilance

Des conventions trop complexes peuvent devenir contre-productives

5 / 15

CHAPITRE 5

Variables dans le script

Intermédiaire

Exemple Qlik Sense

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

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

À quoi ça sert ?

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

Une variable calculée avec LET pendant le reload conserve la valeur obtenue à ce moment-là.

✓ Avantages

Scripts plus portables
Paramètres regroupés

△ Points de vigilance

Une variable de chemin erronée peut bloquer plusieurs chargements

6 / 15

CHAPITRE 6

Réutiliser une expression

Intermédiaire

Exemple Qlik Sense

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

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

À quoi ça sert ?

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

C’est pratique pour une expression technique, mais pour un indicateur métier partagé dans l’interface, une Master Measure reste souvent plus visible et gouvernable.

✓ Avantages

Une formule complexe écrite une seule fois

△ Points de vigilance

Moins visible pour l’utilisateur qu’un Master Item

7 / 15

CHAPITRE 7

Variables et Set Analysis

Avancé

Exemple Qlik Sense

LET vAnnee = Year(Today());

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

À quoi ça sert ?

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

👶 Ordre de lecture

Qlik calcule d’abord l’expansion, injecte son résultat, puis interprète le Set Analysis.

1vAnnee2026

→

2$(vAnnee)injection dans le Set

→

3Sum({<Annee={2026}>} Montant)expression finale

✓ Avantages

Set Analysis dynamique
Centralisation des périodes

△ Points de vigilance

Les erreurs de quoting sont fréquentes

8 / 15

CHAPITRE 8

$(=expression)

Avancé

Exemple Qlik Sense

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

À quoi ça sert ?

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

C’est utile pour rechercher dynamiquement la dernière année, le dernier mois ou une valeur dépendant des sélections.

✓ Avantages

Très dynamique
Évite certaines variables intermédiaires

△ Points de vigilance

Peut devenir difficile à lire si on imbrique trop de logique

9 / 15

CHAPITRE 9

Chaînes, nombres et dates

Avancé

Exemple Qlik Sense

SET vPays = France;

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

À quoi ça sert ?

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.

Le piège n’est pas la variable elle-même : c’est souvent le texte final produit après expansion.

✓ Avantages

Permet des filtres dynamiques très précis

△ Points de vigilance

Formats locaux et quotes peuvent créer des erreurs subtiles

10 / 15

CHAPITRE 10

Variables avec paramètres

Expert

Exemple Qlik Sense

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

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

À quoi ça sert ?

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

Lors de l’expansion, les paramètres réels remplacent les paramètres formels avant que le résultat soit interprété.

✓ Avantages

Évite de dupliquer des expressions similaires
Permet de créer des gabarits

△ Points de vigilance

Plus difficile à déboguer pour un débutant

11 / 15

CHAPITRE 11

Variables côté interface

Intermédiaire

Exemple Qlik Sense

vSeuil100000→ utilisé dans plusieurs expressions et conditions

À quoi ça sert ?

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.

Elles peuvent servir à piloter une mesure, un seuil, un affichage ou une interaction utilisateur selon les objets et contrôles disponibles.

✓ Avantages

Paramétrage central
Interactions possibles

△ Points de vigilance

Il faut documenter les variables importantes

12 / 15

CHAPITRE 12

Déboguer une variable

Très utile

Exemple Qlik Sense

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

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

À quoi ça sert ?

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

👶 Méthode SOSQLIK

1. Affiche la variable seule. 2. Vérifie son contenu. 3. Remplace mentalement $(v...). 4. Teste l’expression finale sans variable. 5. Réintroduis la variable.

✓ Avantages

Trouve rapidement les erreurs de syntaxe
Évite de modifier au hasard

△ Points de vigilance

Les expressions très imbriquées demandent parfois plusieurs tests

13 / 15

CHAPITRE 13

Les pièges classiques

À connaître

Exemple Qlik Sense

Question réflexeQue voit Qlik après expansion ?→ souvent la meilleure piste de diagnostic

À quoi ça sert ?

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.

Une variable n’est pas automatiquement une bonne abstraction. Si personne ne comprend ce qu’elle injecte, elle complique l’application au lieu de la simplifier.

✓ Avantages

Une convention simple rend les variables très efficaces

△ Points de vigilance

Une architecture de variables excessive devient une dette technique

14 / 15

CHAPITRE 14

Ma méthode recommandée

À retenir

Exemple Qlik Sense

Règle SOSQLIKCentraliser ce qui doit l’être→ sans cacher inutilement la logique

À quoi ça sert ?

Utilise les variables pour les paramètres, valeurs globales et expressions techniques réellement réutilisées. Donne-leur un nom explicite et documente celles qui structurent l’application.

Avant d’introduire une variable, demande-toi si une Master Measure, un champ calculé dans le script ou une simple expression locale serait plus lisible.

✓ Avantages

Applications plus maintenables
Paramétrage cohérent

△ Points de vigilance

Demande une discipline de nommage et de documentation

15 / 15