絶対ナビゲーションを使用して、値を返すか、ビジュアル マトリックスから式を評価します。 フィルターは、ビジュアル マトリックス上の任意の軸に対して提供できます。 省略されたフィルターは、コンテキストから推論されます。 1 つの値を特定できない場合は、エラーが返されます。
構文
LOOKUP(<expression>, <colref>, <expression>[, <colref>, <expression>]...[, <AssociatedColumnsBehavior>])
パラメーター
| 任期 | 定義 |
|---|---|
expression |
評価する式。 |
colref |
(省略可能)フィルター処理する列。 |
expression |
(省略可能)フィルター処理する値。 |
AssociatedColumnsBehavior |
(省略可能)関連付けられている列の処理方法を指定します。 使用できる値は、 EXPLICIT (既定値) または INFERREDです。 |
戻り値
フィルターが適用された後の 式 の値。
一致するものがない場合は、エラーが返されます。
複数の行がフィルターと一致する場合は、エラーが返されます。
解説
AssociatedColumnsBehavior パラメーターは、指定された座標によって機能的に決定される軸列を LOOKUP が処理する方法を制御します。
EXPLICIT (既定値): パラメーターを省略するか、
EXPLICITに設定すると、LOOKUP では明示的に指定したフィルターのみが使用されます。 指定されていない軸列は、現在のコンテキストから推論されます。 これは元の LOOKUP 動作です。INFERRED:
INFERREDに設定すると、エンジンは指定された座標によって機能的に決定される軸列を識別し、参照を評価する前に自動的に埋めます。 たとえば、Year、Quarter、Month でフィルター処理する場合、エンジンはそれらの座標に対応する曜日や週などの関連する列を推論できます。
INFERREDを指定し、推論された列の値を指定すると、指定された値が推論された値に対して検証されます。 競合する場合、競合する座標を指定したときにBLANKEXPLICITが返すのと同様に、呼び出しはBLANKを返します。
例 1
この例では、LOOKUP は Bikes カテゴリの売上の合計を取得します。 最初の引数には、列またはスカラー式を指定できます。
Lookup Example 1 = LOOKUP(SUM([Sales Amount]), [Category], "Bikes")
Lookup Example 2 = LOOKUP([Sales Amount], [Category], "Bikes")
次のスクリーンショットは、2 つの視覚的計算を含むマトリックスを示しています。
例 2
この例では、 LookupExample2 ビジュアル計算によって、 2018 年度の売上の合計が取得されます。 2018年度と2019年度の第1四半期と2019年度の組み合わせが存在しないため、行の四半期フィルターが明示的に指定されていないため、2019年第1四半期から2019年度第4四半期の結果は返されないことに注意してください。 LookupExample3 では 四半期が明示的に指定されているため、行の現在の四半期は考慮されません。
LookupExample2 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018")
LookupExample3 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018", [Fiscal Quarter], "FY2018 Q1")
例 3
この例では、 EXPLICIT 動作と INFERRED 動作の違いを示します。 どちらのビジュアル計算でも、年、四半期、月名の座標を指定して、2025 年 1 月の売上の合計を調べます。
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)
EXPLICITでは、現在のコンテキストが指定した座標 (2025 年 1 月の行) と一致する行でのみ値が返されます。 他のすべての行で、現在の行のコンテキストが指定したフィルターと競合するため、参照は BLANK を返します。
INFERREDを使用すると、エンジンは、Year、Quarter、Month Name の座標によって機能的に決定される関連する列を自動的に識別します。 これらの座標は特定の時点を一意に識別するため、ルックアップはマトリックス内のすべての行の値を返します。
