ファイル システム アクション

ロボットは [ディレクトリを一覧表示] アクションを使用して、ディレクトリ内の各オブジェクトの <item> ノードとそのオブジェクトの一部のコア プロパティを含むアプリケーションを開きます。アプリケーションは静的であり、ディレクトリのコンテンツが変更された場合でも更新されません。コンテンツを更新するには、ロボットでアプリケーションを閉じてから再度開くか、[更新] アクションを使用してディレクトリのコンテンツを再スキャンします。

[ディレクトリを一覧表示] アクションにより、新しいアプリケーションが開きます。このアクションは、アプリケーションに名前属性を設定するために必要な [アプリケーション名] パラメータを提供します。

いずれかのアクションでエラーが発生すると、DeviceIssue 例外が生成されます。これらのエラーは、「トライ-キャッチ」ステップを使用してキャッチできます。[最後のエラーを取得] アクションを使用して、ファイル システム ドライバーが実行した最後のアクションによって報告されたエラーを取得できます。

アクション

• ディレクトリを一覧表示: ディレクトリのコンテンツを表す新しいアプリケーションを開きます。このアクションは、完了するまでに長い時間がかかる可能性があることに注意してください。

  ファイル アクセス、ディレクトリ、および アプリケーション名パラメータを指定します。

• ファイル削除: ファイルを削除します。

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

• ディレクトリを作成: 指定された名前でディレクトリを作成します。このアクションは、基盤となるストレージのディレクトリ作成セマンティクスを使用します。

  ファイル アクセス および ディレクトリ パラメータを指定します。

• ディレクトリを削除: ディレクトリを削除します。ディレクトリが空でない場合、基盤となるストレージによっては、このアクションが失敗する可能性があります。

  ファイル アクセス および ディレクトリ パラメータを指定します。

• 存在する: オブジェクトが存在するかどうかをテストし、結果をブール値として返します。

  ファイル アクセス パラメータとアイテム パラメータ、および結果を [結果] フィールドに格納する変数を指定します。

• ファイル コピー: ファイルを新しい場所にコピーし、RFS (ロボット ファイル システム) とローカル ファイル システムの間でファイルをコピーするために使用します。ソース パラメータおよびターゲット パラメータには、ファイルの名前を含める必要があります。このアクションは、基盤となるストレージのコピー セマンティクスを使用します。

  ファイル名を含むパスを使用して [ソース] と [ターゲット] の両方のパラメータを指定し、ファイル アクセスを指定します。

  ファイル c:\a\b\c.txt をディレクトリ d:\destination にコピーする場合、[ソース] フィールドには c:\a\b\c.txt が含まれている必要があり、[ターゲット] フィールドには d:\destination\c.txt が含まれている必要があります。[ターゲット] フィールドでファイル名を省略した場合、またはターゲット ディレクトリが存在しない場合、予測できない結果になる可能性があります。

• 移動: オブジェクトを移動または名前変更します。ソース パラメータおよびターゲット パラメータには、オブジェクトの名前を含める必要があります。このアクションを使用して、RFS (ロボット ファイル システム) とローカル ファイル システム間でオブジェクトを移動することはできません。実装では、基盤となるストレージの移動セマンティクスを使用します。

  ファイル アクセスを指定し、オブジェクト名を含むパスを使用して [ソース] パラメータおよび [ターゲット] パラメータを指定します。

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

  ファイル アクセス、[アイテム]、および [新しい名前] パラメータを指定します。

• タイプを取得: オブジェクトのタイプを取得します。オブジェクトが存在しない場合は、DeviceIssue 例外をスローします。このアクションは、次のような値を返します。

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

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

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

  ファイル アクセス パラメータとアイテム パラメータ、および結果を [タイプ] フィールドに格納する変数を指定します。

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

• すべてのディレクトリを閉じる: ロボットによって開かれたディレクトリに関連付けられているすべてのアプリケーションを閉じます。

• ディレクトリを閉じる: アプリケーションを閉じます。

• カウント: コンポーネント ファインダーに一致するオブジェクトの数をカウントします。このアクションは、存在のチェックとワイルドカード検索に使用できます。

• 最後のエラーを取得: ファイル システム ドライバーが実行した最後のアクションからエラー メッセージを取得します。

  [エラー] フィールドに結果を格納する変数を指定します。

• 更新: アプリケーションによって表されるディレクトリのコンテンツをスキャンして再ロードし、ツリーを更新します。

  このアクションは、完了するまでに長い時間がかかる可能性があることに注意してください。

プロパティ

• ファイル アクセス: [直接アクセス] または [RFS 経由] のいずれかを選択します。

• ディレクトリ: ディレクトリのパスと名前を指定します。

• ファイル: ファイルのパスと名前を指定します。

• アイテム: アイテムのパスと名前を指定します。

• アプリケーション名: アプリケーションで名前属性を設定します。

• 結果: アクションの結果を保存する変数を指定します。

[ディレクトリを一覧表示] アクションで開かれた各ディレクトリは、独自のツリーを持つアプリケーションによって表されます。このツリーの要素とその値は、特に明示されていない場合、ローカライズされていません。このツリーには次の構造があります。

fs 要素

要素	説明
title	属性; アプリケーションのタイトル。これは、ディレクトリのパスに設定されます。
driver	属性; 固定値: "fs"。
name	属性; アプリケーションの名前。この属性は、[ディレクトリを一覧表示] アクションによって設定されるか、名前パラメータが省略された場合に生成されます。
directory	要素; ディレクトリを表します。

directory 要素

要素	説明
path	属性; [ディレクトリを一覧表示] アクションで使用されるパスが含まれます。
count	属性; ディレクトリ内のオブジェクトの数。
item	要素、反復; 各アイテムの要素は、ディレクトリ内のオブジェクトを表します。これらの要素の順序は定義されておらず、[更新] アクションの後に変更される可能性があります。

item 要素

この要素には、次の node 要素が含まれています。

要素	説明
name	属性; オブジェクトの名前。
size	属性; 基盤となるストレージによって報告された、オブジェクトのサイズ (バイト単位)。
extension	属性; オブジェクトの拡張子 (ファイルの場合) は小文字に変換されます。ディレクトリの場合は空です。
type	属性; ファイルのタイプ。ファイルの場合は file、ディレクトリの場合は directory、その他すべてのタイプのオブジェクトの場合は other。
created	属性; 基盤となるストレージによって報告された、オブジェクトが作成された時刻。この値は、ISO8601 表記でローカル時間として表されます。
modified	属性; 基盤となるストレージによって報告された、オブジェクトが最後に変更された時刻。この値は、ISO8601 表記でローカル時間として表されます。