キュー アイテムを追加

UiPath.Core.Activities.AddQueueItem

説明

Orchestrator のキューに新しいアイテムを追加します。項目のステータスは「新規」になります。このアクティビティの使用例については、こちらをご覧ください。

注:

• UiPath.Core.Activities.AddQueueItem アクティビティがプロセスで機能するためには、ロボットが Orchestrator に接続されている必要があります。これは、キュー、アイテム、およびステータスに関する情報を送信および取得するために必要です。
• Orchestrator のキューに追加され、必須としてマークされたスキーマ定義値は、アクティビティのディクショナリ ビルダーに自動的にインポートされます。
• 必須のマークが付いていない値は、キュー アイテムに追加できますが適用はされません。

プロジェクトの対応 OS

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

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

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

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

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

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

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

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

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

• QueueName - QueueItem オブジェクトが追加されるキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。最大文字数は 50 文字です。
  • [キュー名] の横にある [キューを管理] ボタンをクリックすると、Studio が接続されている Orchestrator の [キュー] セクションが表示されます。
• アイテム情報 - 追加する特定のキュー アイテムに関するその他の情報のコレクションです。この情報はアイテムに保存され、トランザクション処理で使用されます。最新のキュー スキーマを取得するには、フィールドの右側にある [引数を更新します。] を選択します。アイテム リストを開き、その属性を編集するには、[アイテム情報] フィールド ボックスを選択します。
  重要:

  Number、Boolean、String、および DateTime 型の基本的な値のみを使用することをお勧めします。

  文字列引数の値に [ と " " は使用できません。

  また、引数名に :、.、,、@、" は使用できません。

  スキーマで必須として設定されていない引数は、コレクションにアップロードされません。

詳細オプション

入力

• 処理期限 - キュー アイテムを処理する必要がある期日です。このプロパティは、[優先度] および [処理期限] とともにキュー アイテムの優先順位を決める際の基準になります。このプロパティには、DateTime.Now.AddHours(2)、DateTime.Now.AddDays(10) および DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) などの相対日付を入力することができます。また、米国表記を使用して、2/10/2017 07:40:00 などの正確な時刻を追加することができます。この日付は自動的に修正することができます。たとえば、8 9 2018 9:0 と記述すると、自動的に 08/09/2018 09:00:00 に変換されます。
• アイテムのコレクション - キュー アイテムの情報のディクショナリ全体をインポートできます。このフィールドで使用できるのは Dictionary<string, object> 型変数のみです。
• 延期 - キュー アイテムを処理できるようになる日付です。このプロパティは、[優先度] および [処理期限] とともにキュー アイテムの優先順位を決める際の基準になります。このプロパティには、DateTime.Now.AddHours(2)、DateTime.Now.AddDays(10) および DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) などの相対日付を入力することができます。また、米国表記を使用して、2/10/2017 07:40:00 などの正確な時刻を追加することができます。この日付は自動的に修正することができます。たとえば、8 9 2018 9:0 と記述すると、自動的に 08/09/2018 09:00:00 に変換されます。
• 優先度 - 追加するキュー アイテムの優先度レベルです。このプロパティは、[処理期限] および [延期] とともにキュー アイテムの優先順位を決める際の基準になります。

• Reference - 追加する QueueItem の参照です。参照を使用して、オートメーション プロジェクト内で使用されている他のアプリケーションにトランザクションをリンクすることができます。また、この機能を使用すると、指定された文字列に従って、Orchestrator で特定のトランザクションを検索することができます。

  注: DueDate は予約済みのキーワードです。このアクティビティを設定する際にプロパティ内で使用することはできません。

その他

• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。その結果、フィールドが空白の場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、エラーの発生に関係なくプロジェクトの実行は継続されます。
  注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。

Windows - レガシでの設定

プロパティ パネル

共通

• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。その結果、フィールドが空白の場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、エラーの発生に関係なくプロジェクトの実行は継続されます。
  注: このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
• 表示名 - アクティビティの表示名です。
• Target.Timeout (milliseconds) - エラーがスローされるまでにアクティビティが待機する時間 (単位: ミリ秒) を指定します。既定値は、30000 ミリ秒 (30 秒) です。

入力

• 処理期限 - キュー アイテムを処理する必要がある期日です。このプロパティは、[優先度] および [処理期限] とともにキュー アイテムの優先順位を決める際の基準になります。このプロパティには、DateTime.Now.AddHours(2)、DateTime.Now.AddDays(10) および DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) などの相対日付を入力することができます。また、米国表記を使用して、2/10/2017 07:40:00 などの正確な時刻を追加することができます。この日付は自動的に修正することができます。たとえば、8 9 2018 9:0 と記述すると、自動的に 08/09/2018 09:00:00 に変換されます。
• アイテムのコレクション - キュー アイテムの情報のディクショナリ全体をインポートできます。このフィールドで使用できるのは Dictionary<string, object> 型変数のみです。
• アイテム情報 - 追加する特定のキュー アイテムに関するその他の情報のコレクションです。この情報はアイテムに保存され、トランザクション処理で使用されます。Number、Boolean、String、および DateTime 型の基本的な値のみを使用することをお勧めします。文字列引数の値に [ と " " は使用できません。また、引数名に :、.、,、@、" は使用できません。
• 延期 - キュー アイテムを処理できるようになる日付です。このプロパティは、[優先度] および [処理期限] とともにキュー アイテムの優先順位を決める際の基準になります。このプロパティには、DateTime.Now.AddHours(2)、DateTime.Now.AddDays(10) および DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) などの相対日付を入力することができます。また、米国表記を使用して、2/10/2017 07:40:00 などの正確な時刻を追加することができます。この日付は自動的に修正することができます。たとえば、8 9 2018 9:0 と記述すると、自動的に 08/09/2018 09:00:00 に変換されます。
• 優先度 - 追加するキュー アイテムの優先度レベルです。このプロパティは、[処理期限] および [延期] とともにキュー アイテムの優先順位を決める際の基準になります。
• QueueName - QueueItem オブジェクトが追加されるキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。最大文字数は 50 文字です。

• Reference - 追加する QueueItem の参照です。参照を使用して、オートメーション プロジェクト内で使用されている他のアプリケーションにトランザクションをリンクすることができます。また、この機能を使用すると、指定された文字列に従って、Orchestrator で特定のトランザクションを検索することができます。

  注: DueDate は予約済みのキーワードです。このアクティビティを設定する際にプロパティ内で使用することはできません。

その他

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

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

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

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

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

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

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

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