跳至主要內容
Administrator Guide
上次更新時間 :2023-06-23
地點

地點

指定要從 SELECT 子句中的相關業務物件 (RBO) 中篩選的欄位。Workday 會先計算條件運算式中括號中的運算式。使用
AND
OR
邏輯運算子來分隔 Workday 查詢語言 (WQL) 中的條件運算式。

語法

WHERE ON relatedBusinessObject1 relatedBusinessObjectField1 = value1 AND relatedBusinessObjectField2 IN (instance1, instance2) OR relatedBusinessObjectField3 IN (inst_refId = referenceID) WHERE ON relatedBusinessObject2 relatedBusinessObjectField1 = value1
省略 RBO 欄位的大括號 { } 表示法。

引數

引數
說明
relatedBusinessObject1
您要篩選結果的欄位的 RBO。
relatedBusinessObjectfield1
,
relatedBusinessObjectfield2
, ...
relatedBusinessObjectfieldN
您要篩選結果的相關業務物件的欄位。
value1
,
value2
, ...
valueN
您要比對的欄位值。
instance1
,
instance2
, ...
instanceN
您要比對的欄位值的 Workday ID。
Workday 無法執行包含無效 ID 格式的查詢。
inst_refId
條件運算式中欄位的參照 ID 類型。
referenceID
您要比對的欄位值的參考 ID。
您可以依參考 ID (含或不含雙引號) 進行篩選。
範例︰
  • (inst_refId = "referenceID")
  • (inst_refId = referenceID)

比較運算子

運算子
欄位資料類型相容性
說明
=
布林運算子
日期
數值
文字
相等。
>
日期
數值
大於。
>=
日期
數值
大於或等於。
<
日期
數值
小於。
<=
日期
數值
小於或等於。
!=
布林運算子
日期
數值
文字
不相等。
contains
文字
比較值是欄位值的子集。
不區分大小寫。
範例︰ 類別中包含「AT」。
not contains
文字
此比較值不是欄位值的子集。
不區分大小寫。
範例︰ 「Cat」中不包含「Dog」。
endswith
文字
比較值是欄位值的子集。欄位值的最後一個字元與比較值的最後一個字元相符。
不區分大小寫。
範例︰ CAT 以「AT」結尾
in
實例
文字
「」欄位符合條件的 1 或多個可能值。
is empty
布林運算子
日期
實例
數值
文字
欄位沒有值。
is not empty
布林運算子
日期
實例
數值
文字
欄位有值。
not in
實例
文字
「」欄位與任何條件的可能值都不相符。
startswith
文字
比較值是欄位值的子集。欄位值的第一個字元與比較值的第一個字元相符。
不區分大小寫。
範例︰ 開頭為 CA。

日期與時間格式

WQL 支援採用協調世界時間 (UTC) 或太平洋標準時間 (PST) 的日期和日期時間。
日期與時間
格式
日期
YYYY-MM-DD
時間 (24 小時制)
HH:MM:SS
日期時間 (含時區)
太平洋標準時間︰YYYY-MM-DD HH:MM:SS
UTC︰YYYY-MM-DD HH:MM:SSZ

範例

「allWorkers」
資料來源和
地點
「RBO」傳回符合以下條件的員工的結果︰
  • 超過 50 歲。
  • 工作超過 23 小時。
SELECT worker, location{addresses}, age FROM allWorkers WHERE ON location addresses is NOT EMPTY WHERE defaultWeeklyHours > 23 AND age > 50
allWorkers
資料來源及
地點
傳回結果,以及依下列員工的
受扶養
人 RBO,其員工︰
  • 薪資是由 Workday ID 指定的貨幣。
  • 受扶養人的姓氏以字母 N 開頭。
  • 年齡超過 50 歲。
  • 地點位於 2 個特定城市。
SELECT worker, location{addresses}, dependents{legalName_LastName}, age FROM allWorkers WHERE ON location addresses is NOT EMPTY AND currency in (9e996ffdd3e14da0ba7275d5400bafd4) WHERE ON dependents legalName_LastName startswith "N" WHERE age > 50 OR location in (043e71ed793b1054de6213435945000c, d13a7c46a06443c4a33c09afbdf72c73)

限制

WHERE ON 子句必須放在 WHERE 子句之前。