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

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 の式を入力します。
• 並べ替え順 - ドロップダウン メニューから、ファイルを反復処理する順序を選択します。ファイルは、名前、作成日、最終更新日、およびサイズの昇順または降順に並べ替えることができます。

[プロパティ] パネル内

共通

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

入力

• フィルター -「アクティビティの本体」の「フィルター条件」をご覧ください。
• フォルダー -「アクティビティの本体」の「フォルダー」をご覧ください。
• サブディレクトリを含む -「アクティビティの本体」の「サブフォルダーを含む」をご覧ください。
• 順序 -「アクティビティの本体」の「並べ替え順」をご覧ください。

その他

• プライベート - 選択すると、アクティビティで使用したデータが StudioX のログに記録されなくなります。