レコード抽出
指定した条件に合致するレコードのみを抽出し、データフローの後続の処理に引き継ぎます。不要なデータを早い段階で除外することで、データフロー全体の処理効率を向上させます。
特徴
- 必要なデータの選別
指定した条件に合致するレコードだけを抽出し、後続の処理対象データを最適化します。 - 直感的な条件指定と高度な数式対応
kintone 標準の絞り込みと同様な「標準」フィルターのほか、複雑な条件式を記述できる「数式」フィルターをサポートしています。「標準」「数式」のどちらも条件値として契機パラメーターを指定することができます。 - テーブル内データの抽出
レコード単位だけでなく、テーブル内の特定の行のみを抽出・整理することが可能です。
機能
設定項目詳細
| 設定大項目 | 設定小項目 | 説明 | ルール |
|---|---|---|---|
| ノード設定 | タイトル | フロー編集画面および実行ログ等に表示されるノード名です。 | 任意の名称を入力します。（初期値はプロセッサー名が入ります） |
| ノード設定 | 説明 | ノードの補足説明です。 | 任意で入力します。（初期値は既定のプロセッサー補足説明が入ります） |
| フィルター形式 | 標準 / 数式 | レコードを抽出する条件の記述方法を選択します。 | 必須（デフォルト：標準） |
| 条件 | フィルター条件 | レコードを絞り込む条件（対象フィールド、演算子、比較値）を指定します。 | フィルター形式が「標準」の場合は必須 |
| 条件 | すべての条件を満たす（AND）/ いずれかの条件を満たす（OR） | 複数条件を指定した場合の組み合わせ方法を選択します。 | フィルター形式が「標準」の場合は必須（デフォルト：すべての条件を満たす） |
| 数式 | フィルター数式 | レコードの抽出条件を数式で指定します。計算結果が真（TRUE）となるレコードのみが抽出されます。 | フィルター形式が「数式」の場合は必須 |
| ソート | ソート条件 | 抽出されたレコードの並び順（キーとするフィールド、昇順/降順）を指定します。 | 任意 |
| テーブル内フィルター形式 | 標準 / 数式 | テーブル内の行を抽出する条件の記述方法を選択します。 | 必須（デフォルト：標準） |
| 条件 | テーブル内フィルター条件 | テーブル内の行を絞り込む条件（対象フィールド、演算子、比較値）を指定します。 | テーブル内フィルター形式が「標準」の場合は必須 |
| 条件 | すべての条件を満たす（AND）/ いずれかの条件を満たす（OR） | テーブル内の複数条件を組み合わせる方法を選択します。 | テーブル内フィルター形式が「標準」の場合は必須（デフォルト：すべての条件を満たす） |
| 数式 | テーブル内フィルター数式 | テーブル内の抽出条件を数 式で指定します。 | テーブル内フィルター形式が「数式」の場合は必須 |
| テーブル内ソート | テーブル内ソート条件 | テーブル内の抽出された行の並び順を指定します。 | 任意 |
標準フィルターについて
レコードに対するフィルターの場合
対象フィールドとして指定できるのは、テーブル外のフィールドのみです。
テーブル内フィールドの値をフィルター条件として使用したい場合（例えばテーブル内フィールドの合計値が指定した値以上である場合のみ抽出したい場合）は、数式フィルターを使用することで対応が可能です。
テーブル行に対するフィルターの場合
対象フィールドとして指定できるのは、テーブル内のフィールドのみです。
数式フィルターについて
フィルター形式で「数式」を選択した場合、Excelライクな関数を使用して、より複雑な抽出条件を記述できます。
使用可能な関数: AND, OR, IF, EXACT, ISBLANK, SEARCH などの関数がサポートされています。詳しくは数式を参照してください。
評価基準: 記述した数式はレコード（テーブル内フィルターの場合はテーブル内の各行）ごとに評価されます。計算結果が FALSE・0・空文字・エラー値のいずれでもない場合に真と判定され、そのデータが抽出されます。
テーブル内フィルターの数式を記述する際はテーブル内のフィールドを一つ以上含める必要があります。
使い方
設定手順
データフロー編集画面で「プロセッサーを追加」＞「レコード抽出」を選択し、以下の手順で設定を行います。
- レコードのフィルターとソートの設定: フィルター形式（標準/数式）を選択し、抽出条件を設定します。必要に応じて「ソート」から出力されるレコードの並び順を設定します。
- テーブル内データのフィルターとソートの設定: 入力データにテーブルが含まれる場合、テーブル内の行を絞り込む「テーブル内フィルター形式」と条件を指定します。テーブル内の行を並び替えたい場合は「テーブル内ソート」を設定します。
- ノード名の設定と保存（任意）: 必要に応じて、ノードのタイトルや説明を編集し、設定を保存します。
注意事項
- 抽出結果が0件の場合の挙動: 設定したフィルター条件によってすべてのレコードが除外され、結果が0件となった場合、後続のプロセッサーにデータは渡されません（0件として後続のプロセッサーに引き渡されます）。エラーではありませんが、意図しないデータ欠落を避けるため、テストデータなどでの条件確認を推奨します。
- 大文字/小文字や全角/半角の区別: フィルター条件（標準形式）で文字列を比較する場合、大文字/小文字や全角/半角は厳密に区別されます。表記ゆれがあるデータを扱う場合は、事前にクレンジングするか数式フィルターを組み合わせて条件を記述してください。
