RECHERCHE

S’applique à :Colonne calculéeTable calculéeMesurerCalcul visuel

Retourne la valeur ou évalue l’expression de la matrice visuelle à l’aide de la navigation absolue. Les filtres peuvent être fournis pour n’importe quel axe sur la matrice visuelle. Tous les filtres omis sont déduits du contexte. Si aucune valeur unique ne peut être déterminée, une erreur est retournée.

Syntaxe

LOOKUP(<expression>, <colref>, <expression>[, <colref>, <expression>]...[, <AssociatedColumnsBehavior>])

Paramètres

Valeur retournée

Valeur de l’expression après l’application des filtres.

S’il n’y a pas de correspondance, une erreur est retournée.

Si plusieurs lignes correspondent aux filtres, une erreur est retournée.

Remarques

Le paramètre AssociatedColumnsBehavior contrôle la façon dont LOOKUP gère les colonnes d’axe qui sont déterminées fonctionnellement par les coordonnées fournies :

• EXPLICIT (valeur par défaut) : lorsque le paramètre est omis ou défini sur EXPLICIT, LOOKUP utilise uniquement les filtres que vous fournissez explicitement. Les colonnes d’axe non spécifiées sont déduites du contexte actuel. Il s’agit du comportement de recherche d’origine.

• INFERRED : Lorsqu’il est défini INFERREDsur , le moteur identifie les colonnes d’axe qui sont déterminées fonctionnellement par les coordonnées fournies et les remplit automatiquement avant d’évaluer la recherche. Par exemple, si vous filtrez par année, trimestre et mois, le moteur peut déduire des colonnes associées telles que le jour ou la semaine qui correspondent à ces coordonnées.

Quand INFERRED elle est spécifiée et que vous fournissez une valeur pour une colonne qui aurait été déduite, la valeur fournie est validée par rapport à la valeur déduite. S’ils sont en conflit, l’appel retourne BLANK, similaire à la façon dont EXPLICITBLANK vous fournissez des coordonnées en conflit.

Exemple 1

Dans cet exemple, LOOKUP récupère la somme des ventes pour la catégorie Vélos. Le premier argument peut être une colonne ou une expression scalaire.

Lookup Example 1 = LOOKUP(SUM([Sales Amount]),  [Category], "Bikes")
Lookup Example 2 = LOOKUP([Sales Amount], [Category], "Bikes")

La capture d’écran ci-dessous montre la matrice avec deux calculs visuels.

Exemple 2

Dans cet exemple, le calcul visuel LookupExample2 récupère la somme des ventes pour l’exercice fiscal FY2018. Notez que le filtre de trimestre de la ligne sera utilisé depuis son non spécifié explicitement, ce qui n’entraîne aucun retour de résultats pour FY2019 Q1 à FY2019 Q4 depuis la combinaison de FY2018 et FY2019 Q1 à FY2019 Q4 n’existe pas. LookupExample3 spécifie explicitement le trimestre afin de ne pas tenir compte du trimestre actuel sur la ligne.

LookupExample2 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018")
LookupExample3 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018", [Fiscal Quarter], "FY2018 Q1")

Exemple 3

Cet exemple illustre la différence entre EXPLICIT et INFERRED le comportement. Les deux calculs visuels recherchent la somme des ventes pour janvier 2025 en spécifiant les coordonnées Year, Quarter et Month Name.

Jan 2025 Sales (Explicit) = LOOKUP([Sum of Sales], [Year], 2025, [Quarter], "Q1", [Month Name], "January", EXPLICIT)
Jan 2025 Sales (Inferred) = LOOKUP([Sum of Sales], [Year], 2025, [Quarter], "Q1", [Month Name], "January", INFERRED)

Avec EXPLICIT, la recherche retourne une valeur uniquement sur la ligne où le contexte actuel correspond aux coordonnées spécifiées (la ligne de janvier 2025). Sur toutes les autres lignes, la recherche retourne BLANK , car le contexte de la ligne actuelle est en conflit avec les filtres spécifiés.

Avec INFERRED, le moteur identifie automatiquement les colonnes associées qui sont déterminées par les coordonnées Year, Quarter et Month Name. Étant donné que ces coordonnées identifient de façon unique un point dans le temps, la recherche retourne la valeur sur toutes les lignes de la matrice.

Contenu connexe

• LOOKUPWITHTOTALS