CalcDim - fonction de graphique

Lorsqu'elle est utilisée dans une expression dimension, la fonction CalcDim() remplace l'interprétation automatique du moteur quant au mode gestion en interne de l'expression. Spécifiquement, la fonction empêche la création d'un nouveau champ interne dans le modèle de données. Au lieu de cela, les sélections effectuées dans l'application sont traitées comme des sélections dans les champs applicables du modèle de données d'origine.

Cette fonction ne peut pas être utilisée dans lescript de chargement. En outre, une bonne pratique, pour préserver les performances du système, consiste à charger les champs utilisés dans la dimension calculée sous forme de champs logiques via le script de chargement lorsque cela est possible. CalcDim() offre un moyen de contrôler le comportement du moteur dans les scénarios dans lesquels il n'est pas possible de charger le champ calculé à partir du script.

Dans Qlik Sense, l'expression de dimension est réalisée par défaut comme un champ à la volée, c'est-à-dire comme un champ réel, apparent dans la barre de sélection actuelle, avec une création à la demande. Les sélections sont appliquées et déduites de ce champ, comme pour tout champ logique du script.

Une expression encapsulée dans CalcDim() se comportera de la même manière que toutes les expressions de dimension calculée dans QlikView, c'est-à-dire en mappant de manière ad hoc les valeurs calculées aux valeurs de champ sources sous-jacentes. Tous les calculs de champ à la volée peuvent être transférés dans des dimensions calculées à l'aide de la fonction CalcDim(). En effet, la dimension calculée doit remplir moins de conditions basées sur le modèle de données que le calcul de champ à la volée correspondant. Cette transformation peut être souhaitable afin de garantir un comportement similaire pour toutes les dimensions calculées lorsque le modèle de données peut empêcher l'utilisation d'un calcul de champ à la volée dans certains cas, mais pas dans d'autres.

Champs calculés

CalcDim(expr)

double

Arguments
Argument	Description
expr	Expression utilisée comme dimension ou comme segment dans une expression de dimension.

Cas d'utilisation de CalcDim

CalcDim() s'avère utile lorsque vous avez besoin de plus de contrôle sur la façon dont le moteur Qlik traite les champs que vous invoquez dans une expression de dimension.

Par défaut, Qlik Sense décide automatiquement de créer et de référencer des champs internes dans le modèle de données lorsque vous utilisez une expression de dimension personnalisée. Qlik Sense crée et utilise ces champs internes chaque fois que cela est possible. Lorsque cela n'est pas possible, l'expression est traitée en référence aux champs du modèle de données existant sur lesquels elle s'appuie.

Selon votre cas d'utilisation, ce traitement automatique n'est pas toujours souhaitable. Par exemple, si vous utilisez une variable dans une expression de dimension, la création automatique de nouveaux champs peut devenir problématique. Dans ce cas, utilisez CalcDim() pour forcer le traitement de l'expression sans cette méthode.

Voici quelques cas d'utilisation courants :

Vous avez migré le contenu de QlikView vers Qlik Sense et vous souhaitez conserver la méthode de traitement de QlikView pour les dimensions calculées.
Vous souhaitez simplifier le comportement de sélection dans votre application. Par exemple, vous préférez afficher les sélections des champs sous forme de sélections dans des champs du modèle de données d'origine, plutôt que sous forme de sélections dans de nouveaux champs.
Votre cas d'utilisation nécessite une expression ad hoc pour des raisons de cohérence et de performances. Par exemple, si votre expression de dimension contient des paramètres de visualisation dynamique contrôlables par l'utilisateur tels qu'un formatage contrôlable, des valeurs limites ou des périodes.

Exemples de fonction
Exemple	Résultat
=CalcDim(if(Year < 2023, 'Older', Year))	Une sélection dans une visualisation qui utilise cette dimension sera traitée et affichée comme une sélection dans la valeur du champ Year associée provenant du modèle de données. Inversement, supposons que vous n'encapsuliez pas l'expression dans CalcDim(). Dans ce cas, elle se présentera comme suit : =if(Year < 2023, 'Older', Year) Une sélection dans l'expression ci-dessus sera traitée et affichée comme une sélection dans le champ interne =if(Year < 2023, 'Older', Year), qui ne figure pas dans le modèle de données.

Exemple 1 – Comparaison simple

Vue d'ensemble

Dans cet exemple, vous allez effectuer les opérations suivantes :

Ajouter une table inline et charger des données dans une application.
Créer une table pour visualiser les données et effectuer des calculs.
Effectuer des sélections dans la table pour observer la différence de comportement.

Ouvrez l'Éditeur de chargement de données et ajoutez le script de chargement suivant à une nouvelle section.

Le script de chargement charge une table inline. Cette table comprend deux champs : un champ pour le prénom de la personne et un champ pour son nom de famille.

Script de chargement

Names:

Load * inline [
FirstName,LastName
John,Doe
Amanda,Honda
Amalia,Craig
Cart,Lynch
];

Création de table

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

FirstName
LastName

Ensuite, ajoutez chacune des expressions suivantes sous forme de dimensions dans la table :

=FirstName & ' ' & LastName
=CalcDim(FirstName & ' ' & LastName)

La table devrait ressembler à ce qui suit.

Table Qlik Sense avec des exemples de résultats
FirstName	LastName	=FirstName & ' ' & LastName	=CalcDim(FirstName & ' ' & LastName)
John	Doe	John Doe	John Doe
Amanda	Honda	Amanda Honda	Amanda Honda
Amalia	Craig	Amalia Craig	Amalia Craig
Cart	Lynch	Cart Lynch	Cart Lynch

Comparaison : réalisation de sélections

Dans la colonne =FirstName & ' ' & LastName de la table, sélectionnez la valeur John Doe. Notez que, dans la barre d'outils de sélection, la valeur est sélectionnée sous forme de valeur d'un champ nommé =FirstName&' '&LastName.

Effacez la sélection.

Dans la colonne =CalcDim(FirstName & ' ' & LastName) de la table, sélectionnez la valeur John Doe. Dans la barre d'outils de sélection, la valeur est sélectionnée sous forme de valeurs provenant de deux champs différents : FirstName et LastName.

Ces deux expressions présentent les mêmes informations : une concaténation des champs FirstName et LastName. La différence réside dans le fait que sans CalcDim(), un champ synthétique est créé pour stocker le calcul. Avec CalcDim(), les champs d'origine du modèle de données sont utilisés comme base pour la dimension calculée.

Exemple 2 – Cas d'utilisation pratique pour modifier le comportement par défaut

Vue d'ensemble

Dans cet exemple, nous créons des expressions de dimension dynamiques faisant référence à une variable plutôt que des références à des valeurs statiques.

Dans cet exemple, vous allez effectuer les opérations suivantes :

Ajouter une table inline et chargez des données dans une application.
Créez une variable pour stocker dynamiquement une valeur.
Créer une table pour visualiser les données et effectuer des calculs.
Effectuer des sélections dans la table pour observer la différence de comportement.

Ouvrez l'Éditeur de chargement de données et ajoutez le script de chargement suivant à une nouvelle section.

Le script de chargement charge une table inline. Cette table comprend un champ de date et un champ calculé, Year, qui est dérivé des dates brutes.

Script de chargement

SET DateFormat='MM/DD/YYYY';
						
Transactions:

Load *,

RowNo() as ID,
Year(date) as Year
;

Load * Inline
[
date,amount
'1/19/2022',37.23
'2/28/2022',88.27
'3/16/2022',53.80
'4/1/2022',82.06
'5/16/2022',87.21
'6/26/2022',45.89
'7/9/2022',36.23
'8/2/2022',76.11
'9/26/2022',84.21
'10/29/2022',67.67
'1/1/2023',100.49
'2/24/2023',99.47
'3/6/2023',50.02
'4/10/2023',2.05
'5/20/2023',75.64
'6/25/2023',98.11
'7/19/2023',30.00
'9/27/2023',76.11
'10/26/2023',43.21
'11/12/2023',135.41
'1/15/2024',67.24
];

Création de variable

Chargez les données et ouvrez une feuille. Créez une variable nommée vCutoffYear et donnez-lui la Définition suivante : 2023

Création de table

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

date
Year
amount

Ensuite, ajoutez chacune des expressions suivantes sous forme de dimensions dans la table :

=if(Year < $(vCutoffYear), 'Older', Year)
=CalcDim(if(Year < $(vCutoffYear), 'Older', Year))

La table devrait ressembler à ce qui suit.

Table Qlik Sense avec des exemples de résultats
date	Year	amount	if(Year < $(vCutoffYear), 'Older', Year)	=CalcDim(if(Year < $(vCutoffYear), 'Older', Year))
1/19/2022	2022	37.23	Older	Older
2/28/2022	2022	88.27	Older	Older
3/16/2022	2022	53.80	Older	Older
4/1/2022	2022	82.06	Older	Older
5/16/2022	2022	87.21	Older	Older
6/26/2022	2022	45.89	Older	Older
7/9/2022	2022	36.23	Older	Older
8/2/2022	2022	76.11	Older	Older
9/26/2022	2022	84.21	Older	Older
10/29/2022	2022	67.67	Older	Older
1/1/2023	2023	100.49	2023	2023
2/24/2023	2023	99.47	2023	2023
3/6/2023	2023	50.02	2023	2023
4/10/2023	2023	2.05	2023	2023
5/20/2023	2023	75.64	2023	2023
6/25/2023	2023	98.11	2023	2023
7/19/2023	2023	30.00	2023	2023
9/27/2023	2023	76.11	2023	2023
10/26/2023	2023	43.21	2023	2023
11/12/2023	2023	135.41	2023	2023
1/15/2024	2024	67.24	2024	2024

Comparaisons, partie 1 : comportement sans CalcDim()

Dans la table ci-dessus, il n'existe pas de différence entre les deux colonnes de dimensions calculées.

Dans la colonne if(Year < $(vCutoffYear), 'Older', Year) de la table, sélectionnez la valeur 2023. Notez que, dans la barre d'outils de sélection, la valeur est sélectionnée sous forme de valeur d'un champ nommé =if(Year<2023,'Older',Year).

Ensuite, remplacez la Définition de la variable vCutoffYear par 2024. Notez que, même si la zone de sélection =if(Year<2023,'Older',Year) est identique et conserve la valeur sélectionnée 2023, les données de la table ont changé. La valeur 2023 a été remplacée par la valeur Older. Si vous sélectionnez Older dans la colonne if(Year < $(vCutoffYear), 'Older', Year), la sélection Older s'effectue dans un nouveau champ : =if(Year<2024,'Older',Year).

En fait, un nouveau champ est créé en interne pour chaque valeur de la variable vCutoffYear. Lorsque vous travaillez avec des sélections simultanées et changeantes, ce comportement n'est pas forcément souhaitable et peut compliquer l'interprétation des données.

Comparaisons, partie 2 : comportement avec CalcDim()

Maintenant que vous avez vu le comportement de l'expression lorsqu'elle n'est pas encapsulée dans CalcDim(), effacez toutes les sélections dans l'application. Réinitialisez la variable vCutoffYear à la valeur 2023.

Dans la colonne =CalcDim(if(Year < $(vCutoffYear), 'Older', Year)) de la table, sélectionnez la valeur 2023. Notez que, dans la barre d'outils de sélection, la valeur est sélectionnée sous forme de valeur du champ sous-jacent, Year.

Ensuite, remplacez la Définition de la variable vCutoffYear par 2024. Le champ de sélection Year est identique et conserve la valeur sélectionnée 2023, et les données de la table ont changé, comme indiqué sans CalcDim(). Toutefois, si vous sélectionnez maintenant Older dans la colonne =CalcDim(if(Year < $(vCutoffYear), 'Older', Year)), la valeur 2024 est sélectionnée dans Year.

Toutes les sélections que vous effectuez dans une dimension calculée encapsulée dans CalcDim() seront reflétées comme des sélections dans les champs sous-jacents référencés à partir du modèle de données d'origine. Cela peut simplifier l'interprétation des données et éviter l'apparition d'expressions complexes et encombrées dans la barre d'outils de sélection lorsque les utilisateurs consultent le contenu analytique.

En savoir plus

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici