フィルター

UiPath.Excel.Activities.Business.FilterX

1 つの列の値に基づいて、範囲、表、またはシートにフィルターを作成します。既存のフィルターをクリアする場合にも使用できます。1 つの範囲/シート/表の複数の列をフィルター処理するには、同じソース範囲を対象とする複数の [フィルター] アクティビティを使用する必要があります。このアクティビティは、親の [ Excel ファイルを使用 ] アクティビティで選択した Excel ファイルまたはプロジェクト ノートブックに使用できます。

このアクティビティを使用してフィルターを作成する、およびフィルターが既に存在する場合:

• 既存のフィルターが定義されている元の範囲に適用されている場合は、既存のフィルターはクリアされません (両方のフィルターが適用されます)。
• 既存のフィルターが定義されている元の範囲外に適用される場合:
  • 定義されている元の範囲がシートまたはセルの範囲である場合は、既存のフィルターはクリアされ、新しいフィルターが適用されます。
  • 定義されている元の範囲が表の場合は、既存のフィルターはクリアされません。

このアクティビティを使用して既存のフィルターをクリアする場合:

• 列が [列の名前] に定義されている場合は、指定した列のフィルターのみがクリアされます。定義されている元の範囲が列でフィルター処理される範囲と一致している必要があります。
• [列の名前] が空の場合:
  • 定義されている元の範囲がシートまたはセルの範囲である場合は、すべてのフィルターがシート全体からクリアされます。
  • 定義されている元の範囲が表である場合は、すべてのフィルターが該当の表からのみクリアされます。

このアクティビティの使い方については、「 チュートリアル: Excel データをフィルター処理する 」をご覧ください。

アクティビティの構成

アクティビティの本体

• 元の範囲 - フィールドの右側にある プラス 記号 をクリックし、ファイルを選択してから、フィルター処理する名前付き範囲、表、またはシートを選択します。または、[ Excel 内で示す ] を選択してファイルを開き、ファイルから直接範囲を選択します。範囲、表、またはシートを手動で入力するには、[ カスタム入力] を選択します。または、[ 詳細エディターを開く ] を選択して、VB 式を入力することもできます。
• 列名 - フィールドの右側にある プラス 記号 をクリックし、[ 範囲] を選択して、フィルター処理する列見出しを選択します。または、[ テキスト ] を選択してテキスト ビルダーに列見出しの値を入力するか、[ 詳細エディターを開く ] を選択して VB の式を入力できます。
• フィルターを設定 - このボタンをクリックして、列内の値に対してフィルターを設定します。基本的なフィルターを使用して、フィルター処理する 1 つ以上の値を入力したり、高度なフィルターを使用して、Excel でカスタム オートフィルターを設定するのと同様の方法で、比較演算子を使用して条件を指定できます。
• 既存のフィルターをクリア - 新しいフィルターを作成する代わりに、既存のフィルターをクリアする場合には、このオプションを選択します。フィルターをクリアしても、フィルター設定はアクティビティ内から削除されません (設定が定義されている場合)。

プロパティ パネル

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。

入力

• 「アクティビティの本体」のオプションをご覧ください。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

• 既存のフィルターをクリア - 「アクティビティの本体」の「既存のフィルターをクリア」をご覧ください。