Filter(フィルター)
リストにフィルタリングを行い、指定された条件を満たすアイテムのみを含めるようにします。複雑な条件に基づいてフィルタリングを行うには、Filter Customを使用してください。
入力
フィールド | 定義 | タイプ | 必須 |
---|---|---|---|
list | Filter関数カードによる検索の対象となるリスト。 | オブジェクトのリスト | TRUE |
演算子 | リストに対して実行される特定の比較(以下の関係演算子の表を参照)。 | ドロップダウン | TRUE |
パス |
オブジェクトのリストを検索する場合、path(パス)は比較する値を保持しているキーの名前です。オブジェクト内にある別のオブジェクトへのパスを指定するには、ピリオドを使用します(例:「customer.id」)。
スプレッドシートでは、列の指定に完全なpath(パス)値が必要です。たとえば、Statusというラベルのついた列では、path(パス)値はColumns.1-Statusになります。 テキスト、数値、または日付と時刻のリストを検索する場合は、このフィールドは空白のままにします。 |
文字列 | FALSE |
comparison | 比較対象の値 | 文字列 | TRUE |
必ず入力リストと比較のタイプを設定して、比較の実行方法を指定します。たとえば、greater than演算子は、数値の場合は数値に基づいて比較を行いますが、テキストの場合はアルファベット順に基づいて比較を行います。したがって、80 > 9という数値の比較はtrueを返しますが、"80" > "9"というテキストの比較はfalseを返します。
出力
フィールド | 定義 | タイプ |
---|---|---|
list | 指定した条件を満たすアイテムのみを含む新しいリスト。 | オブジェクト |
関係演算子の表
演算子 |
ユースケース |
---|---|
equal to | 2つのテキスト、数値、日付、またはtrue/falseを比較し、同じ値かどうかを調べます。 |
not equal(次と等しくない) | 2つのテキスト、数値、日付、またはtrue/falseを比較し、異なる値かどうかを調べます。オブジェクトを比較するには、doesn't have key(キーがない)の代わりにこのオプションを使用します。 |
greater than or equal(次より大きいか等しい) | 2つのテキスト、数値、または日付を比較し、最初のものが2番目のものと等しい、またはより大きいかどうかを調べます。 |
less than or equal | 2つのテキスト、数値、または日付を比較し、最初のものが2番目のものと等しい、またはより小さいかどうかを調べます。 |
greater than | 2つのテキスト、数値、または日付を比較し、最初のものが2番目のものより大きいかどうかを調べます。 |
less than | 2つのテキスト、数値、または日付を比較し、最初のものが2番目のものより小さいかどうかを調べます。 |
a multiple of(次の倍数) | 2つの数値を比較し、value aがvalue bの正確な倍数かどうかを調べます。たとえば、12、0、-4はすべて4の倍数ですが、2、3、7は倍数ではありません。 |
in(の) | 2つのテキストを比較し、value aがvalue bの一部かどうかを調べます。たとえば、「test」は「this is a test」に含まれますが、「i」は「team」に含まれません。 |
not in(次にない) |
2つのテキストを比較し、value aがvalue bに含まれていないかどうかを調べます。 |
has key(キーがある) |
value aがオブジェクトで、value bがテキストのとき、そのオブジェクトに指定された名前のキーが存在するかどうかを調べます。たとえば、value aが{"test":123}で、value bが「test」なら、trueを返します。 |
doesn't have key(キーがない) |
value aがオブジェクトで、value bがテキストのとき、そのオブジェクトに指定された名前のキーが存在しないかどうかを調べます。 |
is empty(空である) |
value aが空かどうかを調べます。value bは無視されます。何を「空」と定義するかはタイプによって異なります。注:テキストとオブジェクトでのみ正しく動作します。数値、日付、T/Fは空と見なされます。 |
is not empty(空でない) |
value aが空でないかどうかを調べます。注:テキストとオブジェクトでのみ正しく動作します。数値、日付、T/Fは空と見なされます。 |
例1
条件 |
結果 |
---|---|
list(リスト)は operator(演算子)はgreater than path(パス)は空白 comparison(比較)は3 |
list(リスト)は[4,5,6] (list of numbers greater than 3) |
例2
条件 |
結果 |
---|---|
list(リスト)は operator(演算子)はequal to path(パス)はgender comparison(比較)はfemale |
list(リスト)は[{"name":"Sarah","gender":"female"}] (list of objects where gender is female) |