SDK & Tools

如何在cli-kintone中編寫查詢

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

如何編寫查詢

連結已複製

cli-kintone介紹如何編寫查詢來縮小條件範圍。

篩選條件

連結已複製

記錄精簡程式在--condition選項中指定。
--condition選項中指定的條件必須用"（雙引號）括起來。
運算符號/函數可以組合使用。

1

--condition "字段代碼 運算符號 値或函數"

如果值是字串或選項項，請將值 \"（逸出的雙引號）括在中。

1

--condition "Customer = \"Cybozu Corporation\""
運算符號
運算符號 例 說明
= --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 \"測試\"" 在運算子之前指定的欄位代碼的值包含運算子之後指定的值
如果要確定的欄位類型是附件，則根據檔案名和檔案內容來判斷。
對於不能與 like 運算子一起使用的符號，請參閱以下頁面：
輸入搜索關鍵詞時的注意事項 (External link)
not like --condition "單行文字方塊_0 not like \"測試\"" 在運算子之前指定的欄位代碼的值不包括在運算符之後指定的值
對於不能與 like 運算子一起使用的符號，請參閱以下頁面：
輸入搜索關鍵詞時的注意事項 (External link)
or --condition "數值_0 < 10 or 數值_0 > 20" 使用上述運算子的兩個條件表達式的邏輯 OR
and --condition "數值_0 >= 10 and 數值_0 <= 20" 使用上述運算子的兩個條件表達式的邏輯AND
補充
  • 如果要在查詢包括表欄位和相關記錄中的欄位，請使用 in 和 not in 運算元，而不是 = 和 != 運算元。
  • 如果要在查詢中搜索字串，則為單詞搜索。
    有關說明，請參閱以下頁面。
    輸入搜索關鍵詞時的注意事項 (External link)
函數
函數名稱 例 說明
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 執行之日起的持續時間
可以為期間單位指定以下字串：
  • DAYS：以日為單位
  • WEEKS：以週為單位
  • MONTHS：以月為單位
  • YEARS：以年為單位
THIS_WEEK(曜日) --condition "建立時間 = THIS_WEEK()" 執行 API 的那一周
您可以透過參數指定以下值來指定星期幾：
  • SUNDAY：星期日
  • MONDAY：星期一
  • TUESDAY：星期二
  • WEDNESDAY：星期三
  • THURSDAY：星期四
  • FRIDAY：星期五
  • SATURDAY：星期六
如果未指定參數，則包括一周中的所有日期。
LAST_WEEK(曜日) --condition "建立時間 = LAST_WEEK()" 執行 API 的那一周的前一周
您可以通過指定與參數中相同的值來指定星期幾 THIS_WEEK()。
如果未指定參數，則包括前一周的所有日期。
NEXT_WEEK(曜日) --condition "日期與時間 = NEXT_WEEK()" 執行 API 的一周後的一周
您可以通過指定與參數中相同的值來指定星期幾 THIS_WEEK()。
如果未指定參數，則包括下周的所有日期。
THIS_MONTH(數位或格式字元) --condition "建立時間 = THIS_MONTH()" 執行 API 的月份
您可以透過參數指定以下值來指定日期：
  • LAST：月底
  • 從 1 到 31 的數值：日期
如果未指定參數，則包括該月的所有日期。
如果指定的日期不存在，則將在執行 API 的月份的下一個月的第一天計算。
LAST_MONTH(數位或格式字元) --condition "建立時間 = LAST_MONTH()" 執行 API 的月份前一個月
您可以透過參數指定以下值來指定日期：
  • LAST：上個月末
  • 從 1 到 31 的數值：上個月的日期
如果未指定參數，則包括該月的所有日期。
如果指定的日期不存在，則將在執行 API 的月份的下一個月的第一天計算。
NEXT_MONTH(數位或格式字元) --condition "日期與時間 = NEXT_MONTH()" 執行 API 的月份的次月
您可以透過參數指定以下值來指定日期：
  • LAST：下個月月底
  • 從 1 到 31 的數值：下個月的日期
如果未指定參數，則包括該月的所有日期。
如果指定的日期不存在，則將在執行 API 的月份的下一個月的第一天計算。
THIS_YEAR() --condition "建立時間 = THIS_YEAR()" 執行 API 的年份
LAST_YEAR() --condition "建立時間 = LAST_YEAR()" 執行 API 的年份的前一年
NEXT_YEAR() --condition "日期與時間 = NEXT_YEAR()" 執行 API 的第二年
每個欄位的可用運算元和函數清單、系統識別碼

有關說明，請參閱以下頁面。
kintone API通用|介紹各字段的查詢方法、可用運算元和函數的編寫方法以及系統標識符 。

排序順序

連結已複製

可以選擇指定記錄--order-by 的排序順序。

1

--order-by "更新時間 asc"

如果在域代碼后指定asc，則按升序排序，如果指定desc，則按降序排序。
如果要按多個專案排序，請指定以逗號分隔的「字段代碼排序順序」。

1

--order-by "欄位代碼1 desc, 欄位代碼2 asc"

可以在--order-by中指定的欄位存在限制。
有關說明，請參閱以下頁面。
可以通過排序來選擇的欄位 (External link)

逸出

連結已複製

如果以下欄位的值包含"（雙引號）或反斜杠\（反斜杠），則需要跳脫。

  • 單行文字方塊
  • 多行文字方塊
  • 文字編輯方塊
  • 核取方塊
  • 選項按鈕
  • 下拉式選單
  • 複選
  • 狀態
跳脫示例

這是逸出包含複選框（域代碼：Checkbox）的 " 和 \ 值的示例。

以下是逸出「sample"1"」的示例。

1

--condition "Checkbox in (\"sample\\\"1\\\"\")"

以下是逸出「sample\2\」的範例。

1

--condition "Checkbox in (\"sample\\2\\\\\")"

示例查詢

連結已複製

有關編寫查詢的範例，請參閱以下頁面：
示例查詢

但是，--condition中指定的查詢必須包含在 " 中，並且必須對包含該值的"進行逸出。