ワークフローに関するアクティビティ

最終更新日時 2025年4月30日

繰り返し (フォルダー内の各ファイル)

UiPath.Core.Activities.ForEachFileX

指定されたフォルダー内の各ファイルに対してアクティビティまたは一連のアクティビティを実行します。フォルダー内の複数のファイルが作業対象で、各ファイルに対して 1 つ以上のアクティビティを繰り返す場合は、このアクティビティを使用します。繰り返すアクティビティを [繰り返し (フォルダー内の各ファイル)] 内に追加します。アクティビティ設定するとき、プラス記号 をクリックすると開くメニューの [CurrentFile] エントリから、各ファイルに使用するファイルプロパティを選択します。

[繰り返し (フォルダー内の各ファイル)] 内のアクティビティで選択できる現在のファイルのプロパティは、[サイズ] (バイト単位)、[名前] (拡張子を含むファイル名)、[完全名 (フルパスを含む)]、[フォルダー] (ファイルを含むフォルダーのフルパス)、[最終更新日]、[最終アクセス日]、[作成日] (日付と時刻)、[読み取り専用] (TRUE または FALSE)、および [サイズ (KB)] です。アクティビティによっては、選択できるのは一部のプロパティのみの場合があります。

このアクティビティの使い方については、以下をご覧ください。

アクティビティの構成

アクティビティの本体

繰り返し - 反復処理内の現在のファイルを参照するときに使用する名前を入力します。フォルダー内のファイルの種類を表す名前を使用すると、[繰り返し (フォルダー内の各ファイル)] に追加したアクティビティを設定するときに、現在のファイルオプションを簡単に識別して選択できます。たとえば、レポートを含むフォルダーの場合は、「Report」と入力します。既定値は CurrentFile です。
フォルダー内 - フィールドの横にある [参照] アイコンをクリックし、処理するファイルを含むフォルダーを参照して選択します。または、フィールドの右側にあるプラス記号 をクリックし、メニューから、選択可能なオプションの 1 つを選択してフォルダーパスを指定します。
- プロジェクトノートブック、親の Excel ファイル、または Outlook アカウントからのデータ。たとえば、Excel ファイルを選択してフォルダーパスを含むセルを選択するか、または Outlook で選択されているメールからフォルダーパスを含むフィールドを指定します。
- 保存された値を使用 - プロジェクトで後で使用するために以前保存したフォルダーパス形式の値を選択します。
- テキスト - テキストビルダーでフォルダーパスを入力します。テキストに Excel ファイルのセルの数式を結合できます。たとえば、プロジェクトノートブックの数式を使用して、フォルダー名に日付を追加できます。
- 実行時に確認 - プロジェクトの実行時にフォルダーパスの入力を求めます。
- 詳細エディターを開く - VB の式を入力します。
サブフォルダーを含む - 選択した場合、指定された場所の子フォルダーで見つかるファイルに対してもアクティビティを実行します。このオプションは既定で選択されていません。
アクセスが拒否されたフォルダーをスキップ - 選択すると、アクセスが拒否されたフォルダーが自動的にスキップされます。既定では、このオプションは選択されていません。
* フィルター条件 (例: .xlsx)- 指定されたフォルダーで見つかるファイルを拡張子でフィルター処理します。* をワイルドカード (任意の数の文字と一致) として使用します。たとえば、pdf ファイルのみを処理するには、フィルターとして *.pdf を使用します。xlsx ファイルのみを処理するには、*.xlsx を使用します。フィールドの右側にあるプラス記号 をクリックし、[テキスト] を選択してテキストビルダーでフィルターを入力します。または、メニューのその他のオプションの 1 つを使用して、使用するフィルターを指定します。
- プロジェクトノートブック、親の Excel ファイル、または Outlook アカウントからのデータ。たとえば、Excel ファイルを選択してフィルターを含むセルを選択するか、または Outlook で選択されているメールからフィルターを含むフィールドを指定します。
- 保存された値を使用 - プロジェクトで後で使用するために以前保存した、別のアクティビティからのテキスト出力を選択します。
- 実行時に確認 - プロジェクトの実行時にフィルターの入力を求めます。
- 詳細エディターを開く - VB の式を入力します。
並べ替え順 - ドロップダウンメニューから、ファイルを反復処理する順序を選択します。ファイルは、名前、作成日、最終更新日、およびサイズの昇順または降順に並べ替えることができます。