ストレージ ファイルをアップロード

Orchestrator 内の指定したストレージ バケットにファイルをアップロードする、[ストレージ ファイルをアップロード] アクティビティ。

UiPath.Core.Activities.Storage.UploadStorageFile

説明

Orchestrator で指定したストレージ バケットにファイルをアップロードします。

注:

Orchestrator の権限

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

• Storage Buckets.View: ストレージ バケットを解決するために使用します
• Storage Files.Create: バケットへのファイルのアップロードまたは書き込みに使用します
• Folders.View: Orchestrator フォルダーを参照して選択するために使用します

プロジェクトの対応 OS

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

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

• Orchestrator フォルダー パス - このアクティビティで使用する Orchestrator フォルダーのパスです。何も指定しない場合は、現在の Orchestrator フォルダーが使用されます。このフィールドは、文字列と String 型の変数のみをサポートします。/ をサブフォルダー区切り文字として使用して、目的のフォルダーを指定します。
• ストレージ バケット名 — ファイルのアップロード先のストレージ バケットの名前です。このフィールドは必須です。このフィールドは、文字列と String 型変数のみをサポートします。
• ファイル — 指定したストレージ バケットにアップロードするファイルのフル パスです。ローカル パスまたは IResource 型の変数の使用を切り替えることができます。ローカル パスを使用する場合は、プロジェクトを実行する際に Windows マシンと Linux マシンのファイル構造の違いが考慮されるように、相対フォルダー パスを使用することをお勧めします。例: newFolder/newFileName.txt
• アップロード先 — ストレージ バケット内の、ファイルのアップロード先のパスです。

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

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

詳細オプション

その他

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

  注:

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

  Orchestrator がプロバイダーの URL を配布するのではなく、ファイル コンテンツ自体を提供する場合は ( Features.Buckets.StorageOffloadRequiresAuth 機能が有効化されている Orchestrator で管理されるストレージの場合)、アップロードの合計数もこの値内で完了する必要があります。

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

  注:

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

Windows - レガシ、Windows での設定

• アップロード先 — ストレージ バケット内でファイルをアップロードするパスです。\ をディレクトリ区切り文字として使用して、目的の宛先ディレクトリを指定します。既存のアップロード先ファイルは上書きされます。このフィールドでは、文字列と String 型変数のみがサポートされています。
• ファイル - [ストレージ バケット名 ] フィールドで指定されたストレージ バケットにアップロードするファイルのフル パスです。このフィールドでは、 IResource 型の変数がサポートされています。このフィールドは、実行中にファイル (メールの添付ファイルなど) を動的に取得する場合に使用します。
• パス - 指定されたストレージ バケットにアップロードするファイルの完全なローカル パスです。相対パスは、実行時の実行ディレクトリに基づいて解決されます。このフィールドは、文字列と String 型の変数のみをサポートします。このフィールドは、ファイルがプロジェクト フォルダー内にある場合に使用します。
• ストレージ バケット名 — ファイルのアップロード先のストレージ バケットの名前です。このフィールドは必須です。このフィールドは、文字列と String 型変数のみをサポートします。
  重要:

  これらのフィールドは相互に排他的であるため、使用するフィールドはいずれか 1 つにする必要があります。ローカル パスを指定する場合は、必ず相対フォルダー パスを使用して、Windows システムと Linux システムの異なるファイル構造間で相互運用性を確保してください。例: newFolder/newFileName.txt。

プロパティ パネル

共通

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

  注:

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

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

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

  注:

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

  Orchestrator がプロバイダーの URL を配布するのではなく、ファイル コンテンツ自体を提供する場合は ( Features.Buckets.StorageOffloadRequiresAuth 機能が有効化されている Orchestrator で管理されるストレージの場合)、アップロードの合計数もこの値内で完了する必要があります。

元

• ファイル - [ストレージ バケット名 ] フィールドで指定されたストレージ バケットにアップロードするファイルのフル パスです。このフィールドでは、 IResource 型の変数がサポートされています。このフィールドは、実行中にファイル (メールの添付ファイルなど) を動的に取得する場合に使用します。
• パス - 指定されたストレージ バケットにアップロードするファイルの完全なローカル パスです。相対パスは、実行時の実行ディレクトリに基づいて解決されます。このフィールドは、文字列と String 型の変数のみをサポートします。このフィールドは、ファイルがプロジェクト フォルダー内にある場合に使用します。
  重要:

  これらのフィールドは相互に排他的であるため、使用するフィールドはいずれか 1 つにする必要があります。ローカル パスを指定する場合は、必ず相対フォルダー パスを使用して、Windows システムと Linux システムの異なるファイル構造間で相互運用性を確保してください。例: newFolder/newFileName.txt。

その他

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

ストレージ

• アップロード先 — ストレージ バケット内でファイルをアップロードするパスです。\ をディレクトリ区切り文字として使用して、目的の宛先ディレクトリを指定します。既存のアップロード先ファイルは上書きされます。このフィールドでは、文字列と String 型変数のみがサポートされています。
• ストレージ バケット名 — ファイルのアップロード先のストレージ バケットの名前です。このフィールドは必須です。このフィールドは、文字列と String 型変数のみをサポートします。