ファイル システム アクション
ファイル システム アクション ステップは、ファイルへの直接アクセスまたは ロボット ファイル システム (RFS) により、ファイル、ディレクトリ、およびその他のアイテムに対する操作を実行するために役立ちます。このステップは、次の 3 つのレベルで操作を行います。
- デバイス レベルのアクションにはコンテキストはなく、パラメータによって完全に制御されます。
- アプリケーション レベルのアクションはディレクトリ レベルで動作し、各ディレクトリはアプリケーションによって表されます。
- コンポーネント レベルのアクションは、デバイス ツリーの <item> ノードで表されるファイルまたはディレクトリで動作します。
利用可能なコマンドは、発生するいずれのレベルでも同じように機能し、異なるパラメータ数を持ちます。
ローカル Desktop Automation モードでのローカル ファイル システムへのアクセスを含むファイル システム アクセスを有効にするには、RoboServer 設定アプリケーションの [セキュリティ] タブで [ファイル システムとコマンド ラインのアクセスを許可] オプションを選択します。
RoboServer がローカル ファイル システムにアクセスできないように設定されている場合、ロボットは実行できますが、ステップがローカル デバイス上で [直接アクセス] に設定した [ファイル アクセス] を使用するとエラーが発生します。ただし、このステップは、[ファイル アクセス] が [RFS 経由] に設定されているローカル デバイス上で機能します。リモート デバイス上では、[直接アクセス] と [RFS 経由] が使用できます。
アプリケーションとディレクトリ
ロボットは [ディレクトリを一覧表示] アクションを使用して、ディレクトリ内の各オブジェクトの <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 表記でローカル時間として表されます。