SheetBridgeデータの並べ替えとフィルター

クエリパラメータ

クエリパラメータの設定画面にて、列名と値を指定し、以下の演算子（Operators）を使用することでリストをフィルターできます。

以下の例は、「user_id」列がMagicTextの「LoggedInUser>id」と一致する行を抽出します。

---

演算子（Operators）

高度なフィルタリングを行うには、以下の演算子を使用します。

演算子	説明	クエリパラメータ名	クエリパラメータの値
_eq	一致する	filter[user_id][_eq]	John
_neq	一致しない	filter[Name][_neq]	John
_contains	部分一致する	filter[Name][_contains]	John
_in	リストに含まれる	filter[Status][_in]	active,pending
_null	空である	filter[Email][_null]	true
_notnull	空ではない	filter[Email][_notnull]	true
_gt	より大きい	filter[Age][_gt]	18
_gte	以上	filter[Age][_gte]	18
_lt	未満	filter[Age][_lt]	65
_lte	以下	filter[Age][_lte]	65

_eq 演算子は、カンマ区切りの値もサポートしています（_in のように動作します）。ユーザーが filter[Status][_eq]=active,pending を渡した場合、どちらかの値に一致する行が抽出されます。

---

複数のフィルター

「+ADD ANOTHER FILTER」を使用することで、複数のフィルターを組み合わせることができます。

以下の例は、「user_id」列がMagicTextの「LoggedInUser>id」と一致し、かつ（AND）「category」列が「Instruments」と一致しない行をリストアップします。両方の条件が満たされない場合、そのレコードは読み込まれません。

並べ替え

リストフィルター内の sort クエリパラメータを使用することで、行を並べ替えることができます。並べ替えはフィルタリングが実行された後に適用され、単一または複数の列をサポートしています。

単一列の並べ替え

• 単一の列を昇順で並べ替える場合：

• 単一の列を降順で並べ替える場合（先頭に - を付けます）：

---

複数列の並べ替え

複数の列をカンマで区切ることで、複数の列による並べ替えが可能です。列は優先順位の高い順に並べ替えられます。

これは以下のように並べ替えられます。

1. name を昇順で並べ替え

2. user_id を降順で並べ替え（同じ name を持つ行に対して適用）

---

列名の解決

列名は、フィルタリングと同じヘッダーマッピングシステムを使用して解決されます。

• 正規化されたヘッダー（スペースが削除され、小文字に変換されたもの）

• 標準キー（Canonical keys）

• 大文字・小文字を区別しないラベルマッチング

以下のどのフォーマットでも使用できます。

• 元の列ラベル：?sort=Full Name

• 正規化されたヘッダー：?sort=fullname

• 標準キー：?sort=full_name

---

値の比較

並べ替えサービスは、値をスマートに比較します。

• 数値（Numeric values）：数値として並べ替えられます（例：2は10の前に来ます）

• 文字列（String values）：大文字と小文字を区別せずに並べ替えられます（例：「apple」と「Apple」は同じものとして扱われます）

• Null値（Null values）：並べ替え結果の常に最後尾に配置されます

---

他のパラメータとの組み合わせ

並べ替えはフィルタリングと組み合わせることができます。

これにより、以下が実行されます。

• 「user_id」が LoggedinUser>id と一致する行をフィルターします。

• 結果を「name」の降順で並べ替えます。

---

未知の列

シートに存在しない列を指定した場合、それは自動的に無視されます。リクエスト自体は成功しますが、その並べ替え指示は効果を持ちません。