キュー アイテムを一括追加

UiPath.Core.Activities.BulkAddQueueItems

説明

複数アイテムのコレクションを指定した DataTable から Orchestrator のキューに追加します。そのキューに追加されると、アイテムのステータスは、[新規] に変更されます。

注: UiPath.Core.Activities.BulkAddQueueItems アクティビティがプロセスで機能するためには、ロボットが Orchestrator に接続されている必要があります。これは、キュー、アイテム、およびステータスに関する情報を送信および取得するために必要です。

プロジェクトの対応 OS

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

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

• Orchestrator のフォルダー パス - 指定したキューがあるフォルダーのパスです (プロセスが実行されているフォルダーと異なる場合)。このフィールドでは文字列値のみがサポートされており、サブフォルダーを示す区切り文字として / を使用します。例: "Finance/Accounts Payable"
  注:

  Orchestrator folder path パラメーターは、クラシック フォルダー内のロボットによって実行されるプロセスでは機能しません。モダン フォルダー内のロボットのみが、フォルダー外にデータを渡すことができます。

  X-UIPATH-FolderPath-Encoded ヘッダーでは、以下のように相対フォルダー パスがサポートされています。

  / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。

  . で始まるパス - 周囲のフォルダーから開始します。

  .. で始まるパス - パス内のそれぞれの .. について、周囲のフォルダーの階層で 1 つ上のレベルから開始します (例: ../: 1 レベル上の階層、../../: 2 レベル上の階層)。

  末尾にスラッシュを付けることはできませんのでご注意ください。

• キュー名 - 新しいキュー アイテムを追加するキューの名前です。このフィールドは、文字列と String 型変数のみをサポートします。
• データテーブル - 指定したキューに追加する値を含む DataTable 変数です。このフィールドでは DataTable 変数のみサポートされています。
  注: この DataTable 変数には、ファイルの列をマップする方法に応じて、参照に関するデータを含めることもできます。参照について詳しくは、こちらもご覧ください。

詳細オプション

オプション

• CommitType - ドロップダウンから、アイテムの追加方法とエラーの取り扱い方法を指定します。次のオプションがあります：

  • AllOrNothing - エラーが発生しなかった場合、アクティビティは指定されたキュー アイテムのすべてを追加します。エラーの場合、アイテムは追加されず、エラーが発生した行が返されます。
  • ProcessAllIndependently - 個々のキュー アイテムを追加し、追加することができなかったすべてのキュー アイテムのリストを返します (存在する場合)。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。

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

  注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。

出力

• Result - CommitType プロパティで行った選択に応じて、処理中に発生したすべてのエラーを返して DataTable 変数に格納します。このフィールドでは、DataTable 型の変数のみがサポートされています。

Windows - レガシでの設定

プロパティ パネル

共通

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

  注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
• 表示名 - アクティビティの表示名です。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。

入力

• CommitType - ドロップダウンから、アイテムの追加方法とエラーの取り扱い方法を指定します。次のオプションがあります：

  • AllOrNothing - エラーが発生しなかった場合、アクティビティは指定されたキュー アイテムのすべてを追加します。エラーの場合、アイテムは追加されず、エラーが発生した行が返されます。
  • ProcessAllIndependently - 個々のキュー アイテムを追加し、追加することができなかったすべてのキュー アイテムのリストを返します (存在する場合)。
• データテーブル - 指定したキューに追加する値を含む DataTable 変数です。このフィールドでは DataTable 変数のみサポートされています。
  注:

  • UiPath Orchestrator は最大 15,000 行を受け入れます。この制限に達すると、エラーがスローされます。
  • この DataTable 変数には、ファイルの列をマップする方法に応じて、参照に関するデータを含めることもできます。参照について詳しくは、こちらもご覧ください。
• キュー名 - 新しいキュー アイテムを追加するキューの名前です。このフィールドは、文字列と String 型変数のみをサポートします。

その他

• フォルダー パス - 指定されたキューがあるフォルダーのパスです (プロセスが実行されているフォルダーと異なる場合)。このフィールドでは文字列値のみがサポートされており、サブフォルダーを示す区切り文字として / を使用します。例: "Finance/Accounts Payable"
  注:

  FolderPath パラメーターは、クラシック フォルダー内のロボットによって実行されるプロセスでは機能しません。モダン フォルダー内のロボットのみが、フォルダー外にデータを渡すことができます。

  X-UIPATH-FolderPath-Encoded ヘッダーでは、以下のように相対フォルダー パスがサポートされています。

  / で始まるパス - 周囲のフォルダーが属するツリーの root フォルダーから開始します。

  . で始まるパス - 周囲のフォルダーから開始します。

  .. で始まるパス - パス内のそれぞれの .. について、周囲のフォルダーの階層で 1 つ上のレベルから開始します (例: ../: 1 レベル上の階層、../../: 2 レベル上の階層)。

  末尾にスラッシュを付けることはできませんのでご注意ください。

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• Result - CommitType プロパティで行った選択に応じて、処理中に発生したすべてのエラーを返して DataTable 変数に格納します。このフィールドでは、DataTable 型の変数のみがサポートされています。