Find

リストから、指定された条件を満たす最初のアイテムを見つけます。複雑な条件に基づいて検索を行うには、Find Customを使用してください。

入力

フィールド	定義	タイプ	必須
list	Find関数カードによる検索の対象となるリスト。	オブジェクトのリスト	TRUE
演算子	リストに対して実行される特定の比較（以下の関係演算子の表を参照）。	ドロップダウン	TRUE
パス	オブジェクトのリストを検索する場合、path（パス）は比較する値を保持しているキーの名前です。オブジェクト内にある別のオブジェクトへのパスを指定するには、ピリオドを使用します（例：「customer.id」）。 テキスト、数値、または日付と時刻のリストを検索する場合は、このフィールドは空白のままにします。	文字列	FALSE
comparison	比較対象の値	文字列	TRUE

アイテムの一致について、より多くのオプションが必要な場合は、Find Customを使用してください。リスト内で条件に一致するすべての要素を検索するには、FilterまたはFilter Customを使用してください。

出力

フィールド	定義	タイプ
アイテム	リスト内で、指定した条件を満たす最初のアイテム。	オブジェクト
インデックス	元のリストでアイテムの見つかった位置。リストの最初のアイテムは0です。一致するものが見つからなかった場合、-1を返します。	数値

関係演算子の表

演算子	ユースケース
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（リスト）は［1,22,30,4,35,46] operator（演算子）はgreater than path（パス）は空白 comparison（比較）は30	item（アイテム）は35（30より大きいリストの最初の数値）、index（インデックス）は4。

例2

条件	結果
list（リスト）は[{"name":"Bob","department":"Sales"}, {"name":"Sarah","department":"Engineering"}] operator（演算子）はequal to path（パス）はdepartment comparison（比較）はEngineering	item（アイテム）は{"name":"Sarah","department":"Engineering"} index（インデックス）は1（インデックス位置 1 にあるリストの最初のオブジェクト、departmentはEngineering）

同じチェックを行い、comparisonに「Marketing」を使用すると、一致するオブジェクトがないため結果のitemは{}、index（インデックス）は-1になります。

関連項目

リスト

関数

Workflows要素