傳回值,或使用絕對導覽從可視化矩陣評估表達式。 視覺效果矩陣上的任何軸都可以提供篩選。 任何省略的篩選條件都會從內容推斷。 如果無法判斷任何單一值,則會傳回錯誤。
語法
LOOKUP(<expression>, <colref>, <expression>[, <colref>, <expression>]...[, <AssociatedColumnsBehavior>])
參數
| 術語 | 定義 |
|---|---|
expression |
要評估的表達式。 |
colref |
(選擇性)要篩選的數據行。 |
expression |
(選擇性)要篩選的值。 |
AssociatedColumnsBehavior |
(可選)規定如何處理相關欄位。 允許的值為 EXPLICIT (預設值)或 INFERRED。 |
返回值
套用 篩選條件之後 表達式的值。
如果沒有相符專案,則會傳回錯誤。
如果多個數據列符合篩選條件,則會傳回錯誤。
備註
AssociatedColumnsBehavior 參數控制 LOOKUP 如何處理由所提供座標功能決定的軸欄位:
EXPLICIT (預設):當參數被省略或設為
EXPLICIT時,LOOKUP 只會使用你明確提供的篩選條件。 未指定的軸欄位則是從當前上下文推斷出來的。 這是原始的 LOOKUP 行為。推斷:當設定為
INFERRED時,引擎會自動識別由所提供座標功能決定的軸列,並在評估查找前填入。 例如,如果你依年、季、月篩選,引擎可以推斷出對應這些座標的相關欄位,例如日或週。
當 INFERRED 被指定,且你提供本應推斷的欄位值時,所提供的值會與推斷值進行驗證。 如果它們互相衝突,呼叫會回傳 BLANK,就像 EXPLICIT 你提供衝突座標時回傳 BLANK 的做法一樣。
範例 1
在此範例中,LOOKUP 會擷取自行車類別的銷售總和。 第一個自變數可以是數據行或純量表達式。
Lookup Example 1 = LOOKUP(SUM([Sales Amount]), [Category], "Bikes")
Lookup Example 2 = LOOKUP([Sales Amount], [Category], "Bikes")
下列螢幕快照顯示具有兩個視覺計算的矩陣。
範例 2
在此範例中, LookupExample2 視覺效果計算會擷取會計 年度 FY2018 的銷售總和。 請注意,自未明確指定數據列之後,將會使用數據列的四分之一篩選,因此 FY2019 Q1 到 FY2019 Q4 沒有傳回任何結果,因為 FY2018 和 FY2019 Q1 的組合到 FY2019 Q4 並不存在。 LookupExample3 會明確指定季,因此不會考慮數據列上的目前季。
LookupExample2 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018")
LookupExample3 = LOOKUP([Sales Amount], [Fiscal Year], "FY2018", [Fiscal Quarter], "FY2018 Q1")
範例 3
這個例子展示了行為與 INFERRED 之間的差異EXPLICIT。 兩種視覺計算都是透過指定年份、季度及月份名稱座標,查詢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,引擎會自動識別由年份、季度及月份名稱座標功能決定的相關欄位。 由於這些座標唯一地識別某個時間點,查詢會回傳矩陣中所有列的值。