如何編寫查詢
cli-kintone介紹如何編寫查詢來縮小條件範圍。
篩選條件
可以選擇指定記錄精簡程式--condition
。
--condition
可選條件"
必須括在(雙引號)中。
運算元/函數可以組合使用。
|
|
如果值是字串或選項項,請將值 \"
括在(轉義的雙引號)中。
|
|
算子
算子 | 例 | 說明 |
---|---|---|
= |
--condition "文字編輯方塊_0 = \"測試\"" |
在運算子之前指定的欄位代碼的值與運算符之後指定的值匹配 |
!= |
--condition "文字編輯方塊_0 != \"測試\"" |
在運算子之前指定的域代碼的值與在運算符之後指定的值不同 |
> |
--condition "数値_0 > 10" |
運算子之前指定的域代碼值大於運算子后指定的值 |
< |
--condition "数値_0 < 10" |
在運算子之前指定的域代碼的值小於在運算符之後指定的值 |
>= |
--condition "数値_0 >= 10" |
在運算子之前指定的域代碼的值大於或等於在運算符之後指定的值 |
<= |
--condition "数値_0 <= 10" |
在運算子之前指定的欄位代碼的值小於或等於在運算符之後指定的值 |
in |
--condition "下拉式選單_0 in (\"A\", \"B\")" |
在運算子之前指定的域代碼的值與運算符後面括號中列出的字串之一匹配 |
not in |
--condition "下拉式選單_0 not in (\"A\", \"B\")" |
在運算子之前指定的域代碼的值與運算符後面括號中列出的字串不匹配 |
like |
--condition "文字編輯方塊_0 like \"測試\"" |
在運算子之前指定的域代碼的值包含運算子之後指定的值 如果要確定的欄位類型是附件,則檔名和文件內容將包含在判斷中。 是否有任何符號不能在類似運算符中使用,不能 用於搜索或過濾? 看。 |
not like |
--condition "文字編輯方塊_0 not like \"測試\"" |
在運算子之前指定的域代碼的值不包括在運算符之後指定的值 是否有任何符號不能在類似運算符中使用,不能 用於搜索或過濾? 看。 |
or |
--condition "数値_0 < 10 or 数値_0 > 20" |
使用上述運算子的兩個條件表達式的邏輯 OR |
and |
--condition "数値_0 >= 10 and 数値_0 <= 20" |
使用上述運算子的兩個條件表達式的邏輯AND |
補充
- 如果要在查詢中包括表中的欄位和相關記錄中的欄位,
=
請使用 andnot in
運算元in
而不是 and!=
運算元。 - 如果要在查詢中搜索字串,則為單詞搜索。有關詳細資訊, 請參閱有關搜索關鍵字的 注意事項。
函數
函數名稱 | 例 | 說明 |
---|---|---|
LOGINUSER() |
--condition "建立人 in (LOGINUSER())" |
執行 API 的使用者 |
PRIMARY_ORGANIZATION() |
--condition "組織 in (PRIMARY_ORGANIZATION())" |
運行 API 的使用者的首選組織 如果未為運行 API 的使用者設置首選組織,則忽略該 組織 in (PRIMARY_ORGANIZATION()) 條件,並且將檢索滿足其餘精簡條件的所有記錄。 |
NOW() |
--condition "建立時間 = NOW()" |
執行 API 的日期和時間 |
TODAY() |
--condition "建立時間 = TODAY()" |
執行 API 的日期 |
YESTERDAY() |
--condition "建立時間 = YESTERDAY()" |
執行 API 的前一天 |
TOMORROW() |
--condition "日時 = TOMORROW()" |
運行 API 的第二天 |
FROM_TODAY(数字, 期間の単位) |
--condition "建立時間 < FROM_TODAY(5, DAYS)" |
自 API 執行之日起的持續時間 可以為持續時間單位指定以下字串:
|
THIS_WEEK(曜日) |
--condition "建立時間 = THIS_WEEK()" |
執行 API 的那一周 您可以透過參數指定以下值來指定星期幾:
|
LAST_WEEK(曜日) |
--condition "建立時間 = LAST_WEEK()" |
執行 API 的那一周的前一周 您可以通過指定與參數中相同的值來指定星期幾 THIS_WEEK() 。如果未指定參數,則包括前一周的所有日期。 |
NEXT_WEEK(曜日) |
--condition "日時 = NEXT_WEEK()" |
執行 API 的一周後的一周 您可以通過指定與參數中相同的值來指定星期幾 THIS_WEEK() 。如果未指定參數,則包括下周的所有日期。 |
THIS_MONTH(数値またはフォーマット文字) |
--condition "建立時間 = THIS_MONTH()" |
執行 API 的月份 您可以透過參數指定以下值來指定日期:
如果指定的日期不存在,則將在執行 API 的月份的下一個月的第一天計算。 |
LAST_MONTH(数値またはフォーマット文字) |
--condition "建立時間 = LAST_MONTH()" |
執行 API 的月份前一個月 您可以透過參數指定以下值來指定日期:
如果指定的日期不存在,則將在執行 API 的月份的下一個月的第一天計算。 |
NEXT_MONTH(数値またはフォーマット文字) |
--condition "日時 = NEXT_MONTH()" |
執行 API 的月份的次月 您可以透過參數指定以下值來指定日期:
如果指定的日期不存在,則將在執行 API 的月份的下一個月的第一天計算。 |
THIS_YEAR() |
--condition "建立時間 = THIS_YEAR()" |
執行 API 的年份 |
LAST_YEAR() |
--condition "建立時間 = LAST_YEAR()" |
執行 API 的年份的前一年 |
NEXT_YEAR() |
--condition "日時 = NEXT_YEAR()" |
執行 API 的第二年 |
每個欄位的可用運算元和函數清單、系統識別碼
詳見kintone API通用|介紹各字段的查詢方法、可用運算元和函數 的編寫方法以及系統標識符。
排序順序
可以選擇指定記錄--order-by
的排序順序。
|
|
在欄位代碼 asc
后,指定按升序排序,desc
如果指定,則按降序排序。
如果要按多個專案排序,請指定以逗號分隔的"字段代碼排序順序"。
|
|
--order-by
對可以在 中指定的欄位有限制。有關詳細資訊,
請參閱可通過排序選擇的欄位
。
逃避
如果以下欄位的值包含"
(雙引號)或反斜杠 \
(反斜杠),則需要轉義。
- 單行文字方塊
- 多行文字方塊
- 文字編輯方塊
- 核取方塊
- 選項按鈕
- 下拉式選單
- 複選
- 狀態
轉義示例
這是"
轉義包含和 \
複選框的值(欄位代碼:Checkbox
)的範例。
以下是轉義"sample"1"的示例。
|
|
以下是轉義「示例\2\」的範例。
|
|
示例查詢
有關編寫查詢的範例,
請參閱示例查詢 。
但是,--condition
必須將指定的 "
查詢括起來,並且必須 "
對值進行轉義。