ディレクトリの反復

この手順を使用して、ディレクトリ内のすべてのエントリ (ファイル、ディレクトリ、およびその他のタイプのオブジェクト) を反復処理します。

このステップは、アプリケーションをレコーダー ビューで開き、最初のエントリを表示します。エントリのプロパティは、テーブル ビューとツリー ビューで使用できます。このステップは、ディレクトリ内のエントリを反復処理するループ ステップとして機能します。反復処理を行うたびに、次のエントリのプロパティでビューの内容が更新されます。

ループは、最初の反復処理の前にディレクトリ内のエントリのスナップショットを取得し、このスナップショットに対して反復処理を行います。ループ中にディレクトリの内容を変更しても、反復処理には影響しません。アプリケーションは静的であり、エントリのプロパティがループ内のステップによって変更されても更新されません。たとえば、エントリを削除すると、アプリケーションに表示されます。エントリの名前を変更すると、最初の名前で表示されます。エントリを作成しても、アプリケーションには表示されません。

すべてのエントリのイテレーションが完了する (またはロボットが例外やブレイク ステップによってループを終了する) と、アプリケーションは自動的に閉じます。また、ロボットが実行を停止した場合にもアプリケーションは閉じます。

ロボットは、イテレーション変数と続行およびブレーク ステップを使用することで、他のループ ステップと同様にループの実行を制御できます。

抽出ステップを使用すると、通常どおりにアプリケーション ツリーからプロパティを抽出できます。

ディレクトリの反復ステップは、アプリケーション、ファイル システム、およびループのカテゴリに属します。

プロパティ

以下のプロパティを使用して「ディレクトリの反復」ステップを設定します。

名前

ステップの名前。

デバイス

使用するリファレンス名を選択します。このリファレンス名は、「ロボットを呼び出す」ステップの [デバイス] プロパティで指定します。

ファイル アクセス

ファイルのアクセス方法を指定します。

指定したローカル デバイスまたはリモート デバイスのディレクトリ内のエントリに対して反復処理を行うには、[直接アクセス] を選択します。

ロボット ファイル システムのディレクトリ内のエントリを反復処理するには、[RFS 経由] を選択します。

ディレクトリの名前

エントリが反復処理されるディレクトリへのパスを指定します。

たとえば、C:\Directoryname です。

アプリケーション名

ステップで開くアプリケーションの名前を設定します。

この必須パラメータで指定された名前は、アプリケーションの名前属性とタイトル属性で使用されます。

エラーを回避するために、ロボット内のアプリケーションにはそれぞれ異なるアプリケーション名を割り当てます。

イテレーション変数 (オプション)

イテレーション データを格納する変数を指定します。

コンポーネント アクション

次のコンポーネント アクションが使用できます。

アクション

説明

ファイル削除

選択したファイルをディレクトリから削除します。

タイプを取得

オブジェクトのタイプを取得します。このアクションは、次のような値を返します。

  • file オブジェクトはファイルです。

  • directory オブジェクトはディレクトリです。

  • other オブジェクトは存在しますが、ファイルまたはディレクトリではありません。オブジェクトの正確なタイプは基盤となるストレージによって異なりますが、デバイスやシンボリック リンクなどのその他のオブジェクトである場合もあります。

パスを取得

アイテムへのパスを取得します。

ロック ステータス

Windows ファイルの読み取り/書き込みロックのテストを実行し、数値ステータス インジケータを返します。[ロック ステータス] は、RFS および Linux では使用できません。

  • 1 ファイルは存在しますが、ロックされていません。

  • 0 ファイルが存在し、ロックされています (読み取りおよび書き込み)。

  • -1 ファイルが存在しません。

  • -2 機能がサポートされていません。

  • -3 別の理由で失敗しました。(根本的なエラーを取得するには、[最後のエラーを取得] ステップを使用します。)

ファイル コピー

ファイルを新しい場所にコピーします。ターゲット パラメータには、ファイルの名前を含める必要があります。

たとえば、ファイル c:\a\b\c.txt をディレクトリ d:\destination にコピーする場合は、ターゲット フィールドに d:\destination\c.txt が含まれている必要があります。

[ファイル アクセス] および [ターゲット] パラメータを指定します。

移動

オブジェクトを移動または名前変更します。[ターゲット] パラメータには、ファイルの名前を含める必要があります。このアクションを使用して、RFS とローカル ファイル システム間でオブジェクトを移動することはできません。

名前の変更

現在の場所にあるオブジェクトの名前を変更します。