篩選條件

你的資料庫中通常包含大量資料，因此在檢索資料時建議套用篩選條件。Ragic API 篩選工具具有特殊格式。

你可以使用參數 "where" 來為搜尋加入篩選條件，如下所示：

curl --get -d "where=2000123,eq,Alphabet Inc." \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

參數是逗號分隔格式，至少包含 3 個參數：

• 1. 你想要篩選的欄位 ID。
• 2. 用於指定篩選操作的整數形式的運算符號。運算符號列表如下。
• 3. 你想要篩選欄位的值。請記住，如果你的值可能包含逗號字元，請對其進行 URL 編碼或使用 %2C 以避免衝突。

你可以用帶有多個篩選條件的查詢，如下所示：

curl --get -d "where=2000123,eq,Alphabet Inc." \
-d "where=2000127,eq,Jeff Kuo" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

以下是支援的運算符號列表：

請注意：

1. 當你按日期或日期時間篩選時，需要使用以下格式：yyyy/MM/dd 或 yyyy/MM/dd HH:mm

。

2. 如果你想篩選空值，不需要填寫第三個參數，例如，"where=2000127,eq,"。

3. 對於同一欄位的 OR 篩選，可以透過加入多個 where 查詢來實現。例如，要檢索欄位 ID 1000001 為 Ratshotel 或 Claflin 的資料，可以使用 "where=1000001,eq,Ratshotel&where=1000001,eq,Claflin"。

有些系統欄位具有特殊的欄位 ID，你可以在查詢中使用。常見的系統欄位如下：

你還可以使用 全文檢索 作為查詢篩選條件。只需在參數 fts 中提供查詢詞，就會回傳符合的結果。

curl --get -d "fts=Alphabet" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

也可以套用共通篩選。只需設定如下 ID。

curl --get -d "filterId=YOUR_SHARED_VIEW_ID" \
-H "Authorization:Basic YOUR_API_KEY_GOES_HERE" \
-d api \
https://www.ragic.com/demo/sales/1

你可以透過點擊共通篩選 URL 取得 ID。