Les fonctions utiles de Qlik

Qlik possède énormément de fonctions. Pour choisir une expression, commence par préciser ce que tu souhaites obtenir : transformer une valeur, résumer des enregistrements, consulter une autre ligne du tableau ou calculer sur plusieurs résultats successifs. Ces quatre besoins correspondent notamment aux fonctions scalaires, aux agrégations, aux fonctions inter-enregistrements et aux fonctions Range. Cette grille de lecture s’inspire des familles décrites par Henric Cronström (HIC), mais le parcours proposé ici part de situations concrètes rencontrées dans les applications Qlik.

Une expression courte et lisible est presque toujours préférable à une construction compliquée équivalente.

Above() évalue une expression sur une ligne située au-dessus de la ligne courante dans le segment de colonne. Sans offset, elle regarde la ligne précédente.

Above() dépend de l’ordre des lignes. Ne confonds pas ordre d’affichage et calendrier : si une période disparaît après une sélection, Above() se reporte sur la ligne visible qui la précède, même si les deux dates ne se suivent pas. Le tri et les valeurs dimensionnelles affichées font donc partie du calcul.

Below() est le pendant d’Above() : il évalue l’expression sur une ligne située sous la ligne courante.

Comme Above(), Below() travaille sur les segments de colonne et dépend du tri.

RangeSum() additionne une plage de valeurs. Associée à Above(), elle permet de construire très simplement un cumul glissant ou progressif.

RangeSum() traite les valeurs non numériques comme 0, ce qui est souvent plus pratique qu’une addition classique.

RangeAvg() calcule la moyenne d’une plage. Avec Above(), on obtient une moyenne mobile sur les dernières périodes.

La taille de fenêtre peut être remplacée par une variable pour rendre le calcul paramétrable.

RowNo() renvoie le numéro de la ligne courante dans le segment de colonne. Avec TOTAL, la numérotation porte sur la colonne entière.

Les fonctions inter-record peuvent désactiver certains tris par mesure ; vérifiez toujours l’ordre final.

Before() et After() jouent horizontalement un rôle comparable à Above() et Below(), mais ils sont destinés aux tableaux croisés dynamiques.

N’utilisez pas Before()/After() dans un tableau simple : utilisez Above()/Below() selon la structure.

If() teste une condition et renvoie la valeur prévue pour le cas vrai. Si la condition est fausse, il renvoie la valeur alternative lorsqu’elle est fournie ; sinon, le résultat est NULL.

Quand vous commencez à imbriquer quatre ou cinq If(), demandez-vous s’il existe une solution plus claire.

Match() cherche une correspondance exacte et renvoie sa position dans la liste. MixMatch() fait une comparaison insensible à la casse. WildMatch() ajoute les jokers * et ? et ignore aussi la casse.

WildMatch() est extrêmement pratique pour éviter une longue série de comparaisons OR.

Pick() renvoie le nième élément d’une liste. Son intérêt devient évident lorsqu’on lui fournit le résultat numérique d’un Match().

Pick() ne cherche rien lui-même : il choisit selon un numéro.

En combinant Match() et Pick(), on obtient une structure de correspondance très lisible : Match() détermine le numéro et Pick() renvoie la valeur associée.

Pour un mapping massif et stable, préférez néanmoins une table de mapping dans le script.

Alt() renvoie le premier paramètre ayant une représentation numérique valide, puis la valeur de secours finale. Coalesce() renvoie le premier paramètre qui n’est pas NULL.

Coalesce() évite souvent des If(IsNull(...)) imbriqués.

Class() affecte une valeur numérique à un intervalle. C’est parfait pour créer rapidement des tranches d’âge, de montant, de délai ou de volume.

Pour des tranches métier irrégulières, une logique spécifique ou une table dédiée sera plus appropriée.

Dual() associe une représentation texte à une valeur numérique. Qlik affiche le texte mais peut trier ou calculer avec la valeur numérique.

Beaucoup de valeurs Qlik, notamment certaines dates et résultats de Class(), exploitent déjà le principe des valeurs duales.

Only() renvoie une valeur lorsqu’il n’existe qu’une seule valeur possible dans le contexte d’agrégation. S’il en existe plusieurs, le résultat est NULL.

Only() est aussi un bon révélateur d’un contexte plus large que prévu.

Min() et Max() trouvent les extrema numériques. FirstSortedValue() permet de récupérer une valeur associée à un ordre de tri, par exemple le produit correspondant au plus gros chiffre d’affaires.

En cas d’ex æquo, FirstSortedValue() peut renvoyer NULL selon le contexte : testez les égalités.

Rank() renvoie le rang d’une expression parmi les lignes d’un segment de colonne. Il permet de créer des classements dynamiques qui réagissent aux sélections.

Comme les autres fonctions inter-record, le contexte et la segmentation du graphique sont essentiels.

Concat() agrège plusieurs valeurs textuelles dans une seule chaîne avec un séparateur. Avec DISTINCT, on peut éliminer les doublons.

Une liste très longue devient vite illisible : pensez à limiter son usage à des ensembles raisonnables.

Num(), Date() et Timestamp() servent principalement à formater la représentation d’une valeur numérique ou temporelle sans changer la logique métier sous-jacente.

Ne confondez pas formatage et interprétation : Date#() et Num#() servent à interpréter du texte, Date() et Num() à formater une valeur.

Les fonctions de date Qlik permettent d’éviter beaucoup de calculs manuels. MonthStart() ramène au début du mois, AddMonths() décale une date et InMonth() teste l’appartenance à un mois relatif.

Pour les applications complexes, un calendrier maître bien construit reste préférable à une multiplication de calculs de dates.

Ces fonctions permettent d’interroger les sélections de l’utilisateur. GetSelectedCount() compte les valeurs sélectionnées d’un champ ; GetFieldSelections() en fournit une représentation textuelle.

Évitez de faire dépendre toute la logique métier de l’interface des sélections ; utilisez-les surtout pour améliorer l’expérience.

Quand un tableau regroupe plusieurs interventions par service, une mesure comme Sum(Montant) doit produire un seul résultat par service. C’est le rôle des agrégations telles que Sum(), Count(), Avg(), Min(), Max(), Only() et Concat(). Cette distinction entre niveaux de calcul est également développée par HIC.

HIC rappelle qu’une expression de mesure doit généralement aboutir à une seule valeur pour chaque cellule du graphique.

Avant de compter, décide ce que représente ton indicateur : des lignes d’activité ou des objets métier distincts. Count(Champ) compte les occurrences non NULL du champ, tandis que Count(DISTINCT Champ) ne retient qu’une occurrence par valeur. HIC rappelle notamment la vigilance nécessaire sur les champs clés.

Si TicketID est une clé partagée par plusieurs tables, Count(TicketID) peut compter des occurrences à un grain différent de celui attendu. Pour compter des tickets uniques, utilise DISTINCT ; pour compter des interventions, compte un identifiant propre à la table des interventions.

La moyenne doit toujours être rattachée à une unité de calcul. Avg(Montant) mesure la moyenne des montants présents sur les lignes ; une moyenne mensuelle du chiffre d’affaires demande d’abord de regrouper ces lignes par mois. HIC illustre également cette différence de granularité.

Utilise un identifiant de période unique (par exemple AnnéeMois) plutôt que le seul nom du mois. Les mois sans données ne sont pas inclus automatiquement : décide si tu veux les compter comme des mois à zéro.

Une transformation indépendante des sélections peut généralement être préparée dans le script. En revanche, une mesure qui dépend du contexte choisi par l’utilisateur doit rester dynamique. C’est un principe de conception également exposé par HIC.

La documentation Qlik recommande également de pré-calculer dans le script les mesures possibles au niveau de granularité le plus bas.

Une moyenne mobile calculée sur trois lignes n’est pas nécessairement une moyenne sur trois périodes calendaires consécutives. Si le tableau masque une période, Above() ne la reconstitue pas. Ce comportement est notamment décrit dans les travaux de HIC.

Pour une véritable fenêtre calendaire, construis une dimension temporelle complète, contrôle les options d’affichage des périodes sans activité et vérifie le comportement sous sélection. Ne remplace pas systématiquement les périodes absentes par zéro : cela dépend de la mesure métier.

Le bon réflexe est de partir du besoin : ligne précédente → Above(); cumul → RangeSum(Above()); choix par index → Pick(); correspondance → Match/WildMatch(); valeur de secours → Coalesce/Alt; tranche → Class(); ordre métier → Dual().

Ce tutoriel est une boîte à outils : revenez-y selon le problème rencontré plutôt que d’essayer de mémoriser toutes les fonctions.