ストレージ ファイルをダウンロード

[ストレージ ファイルをダウンロード] アクティビティ。Orchestrator 内の指定したストレージ バケットからファイルをダウンロードします。

UiPath.Core.Activities.Storage.DownloadStorageFile

説明

Orchestrator で指定したストレージ バケットからファイルをダウンロードします。

注:

Orchestrator の権限

このアクティビティは、実行するロボットの Orchestrator アカウントで実行されます。ターゲット フォルダーに対する以下の Orchestrator ロールの権限 を保持している必要があります。

• Storage Buckets.View: ストレージ バケットを解決するために使用します
• Storage Files.View: バケットからファイルを読み取ったりダウンロードしたりするために使用します
• Folders.View: Orchestrator フォルダーを参照して選択するために使用します

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

クロスプラットフォームでの設定

• Orchestrator フォルダー パス - このアクティビティで使用する Orchestrator フォルダーのパスです。何も指定しない場合は、現在の Orchestrator フォルダーが使用されます。このフィールドは、文字列と String 型変数のみをサポートします。
• ストレージ バケット名 - ファイルが存在するストレージ バケットの名前です。このフィールドは、文字列と String 型の変数のみをサポートします。
• ファイル パス - ストレージ バケットからダウンロードするファイルのフル パスです。このファイルは、対象の Orchestrator ストレージ コンテナーに存在する必要があります。このフィールドでは、文字列と String 型変数のみがサポートされています。

¹ ソリューションの一部として Studio Web で作成したクロスプラットフォーム プロジェクトでは、[Orchestrator フォルダー パス] フィールドを利用できません。

² ソリューションの一部として Studio Web で作成したクロスプラットフォーム プロジェクトでは、キュー、アセット、ストレージ バケットなどの新しい Orchestrator リソースを設計時に定義する [新しく定義] オプション、またはリソース管理で使用する [Orchestrator を開く] オプションが、[名前] フィールドに用意されています。

詳細オプション

オプション

• ファイル名と場所 - ファイルのダウンロード先の、ファイル名を含む完全なローカル パスです。相対パスは、実行時の実行ディレクトリに基づいて解決されます。このパスにファイル名が含まれていないと、アクティビティは機能しません。このフィールドでは、文字列と String 型変数のみがサポートされています。

• タイムアウト (ミリ秒) - Orchestrator が応答するまで、またはファイル転送が進行するまで待機する時間をミリ秒単位で指定します。指定した時間が経過しても処理が完了するまで待機してからエラーをスローします。合計転送時間を制限しないため、低速接続による大きなファイルも完了します。既定値は 300000 ミリ秒 (5 分) です。接続を開く時間は常に 30 秒に制限されています。

  注:

  タイムアウトすると、アクティビティは失敗し、エラー コード Orchestrator_Sys_TimeoutのTimeoutExceptionが表示されるため、[エラー発生時に実行を継続] と [リトライ スコープ] は、他のエラーと同様に適用されます。値 0 または負の数値は 30 秒に置き換えられ、ジョブのキャンセルはタイムアウトではなくキャンセルとして報告されます。

  部分的に書き込まれたアップロード先ファイルは、アクティビティが失敗する前に削除されます。

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白の場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

  注:

  このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True である場合、プロジェクトの実行時にエラーが捕捉されません。

出力

• ファイル - 他のアクティビティで使用するための、ダウンロード ファイルへの参照です。

Windows - レガシ、Windows での設定

• パス - ストレージ バケットからダウンロードするファイルのフル パスです。このファイルは、対象の Orchestrator ストレージ コンテナーに存在する必要があります。このフィールドは、文字列と String 型変数のみをサポートします。
• ストレージ バケット名 - ファイルが存在するストレージ バケットの名前です。このフィールドは、文字列と String 型の変数のみをサポートします。

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でもオートメーションの実行を継続するかどうかを指定します。このフィールドで使用できるのは Boolean 値 (True、False) のみです。既定値は False であるため、このフィールドが空白の場合にエラーが発生すると、プロジェクトの実行は停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

  注:

  このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True である場合、プロジェクトの実行時にエラーが捕捉されません。

• 表示名 - アクティビティの表示名です。

• タイムアウト (ミリ秒) - Orchestrator が応答するまで、またはファイル転送が進行するまで待機する時間をミリ秒単位で指定します。指定した時間が経過しても処理が完了するまで待機してからエラーをスローします。合計転送時間を制限しないため、低速接続による大きなファイルも完了します。既定値は 300000 ミリ秒 (5 分) です。接続を開く時間は常に 30 秒に制限されています。

  注:

  タイムアウトすると、アクティビティは失敗し、エラー コード Orchestrator_Sys_TimeoutのTimeoutExceptionが表示されるため、[エラー発生時に実行を継続] と [リトライ スコープ] は、他のエラーと同様に適用されます。値 0 または負の数値は 30 秒に置き換えられ、ジョブのキャンセルはタイムアウトではなくキャンセルとして報告されます。

  部分的に書き込まれたアップロード先ファイルは、アクティビティが失敗する前に削除されます。

その他

• フォルダー パス - このアクティビティで使用する Orchestrator フォルダーのパスです。何も指定しないと、現在の Orchestrator のフォルダーが使用されます。このフィールドでは、文字列と String 型変数のみがサポートされています。/ をサブフォルダーの区切り文字として使用して、目的のフォルダーを指定します。
• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 結果 - 他のアクティビティで使用するための、ダウンロード ファイルへの参照です。

ストレージ

• パス - ストレージ バケットからダウンロードするファイルのフル パスです。このファイルは、対象の Orchestrator ストレージ コンテナーに存在する必要があります。このフィールドは、文字列と String 型変数のみをサポートします。
• ストレージ バケット名 - ファイルが存在するストレージ バケットの名前です。このフィールドは、文字列と String 型の変数のみをサポートします。

先

• ファイル名と場所 - ファイルのダウンロード先の、ファイル名を含む完全なローカル パスです。相対パスは、実行時の実行ディレクトリに基づいて解決されます。このパスにファイル名が含まれていないと、アクティビティは機能しません。このフィールドでは、文字列と String 型変数のみがサポートされています。