キュー アイテムを追加し参照を取得 (Add Queue Item And Get Reference)

UiPath.Persistence.Activities.Queue.AddQueueItemAndGetReference

説明

パラメーターを使用して Orchestrator キュー アイテムを追加し、QueueItemData 変数に格納された対応するキュー アイテム オブジェクトを取得して、ワークフローの実行中にいつでもトランザクションの完了を待機します。

プロジェクトの対応 OS

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

Windows および Windows - レガシでの設定

デザイナー パネル

• キュー名 - QueueItem オブジェクトが追加されるキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。最大文字数は 50 文字です。
• 優先度 - 追加するキュー アイテムの優先度レベルです。このプロパティは、[処理期限] および [延期日] とともにキュー アイテムの優先順位を決める際の基準になります。
• ItemInformation - 追加する特定の QueueItem に関する補足情報のコレクションです。この情報はアイテムに保存され、トランザクション処理で使用されます。Number、Boolean、String、DateTime の各型の基本的な値のみを使用することをお勧めします。文字列型引数の値には、文字 [ と " " を使用できません。引数名には、:、.、,、@、" の各文字を使用できません。
• Queue Item (Output) - The queue object that is returned from Orchestrator as a QueueItemData object after the queue is created. This object can be passed to the Wait for Queue Item and Resume activity in order to suspend the execution of the workflow until the transaction is completed.

プロパティ パネル

共通

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

注:

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

• 表示名 - アクティビティの表示名です。
• タイムアウト (ミリ秒) - エラーがスローされる前にアクティビティが実行されるまで待機する時間 (ミリ秒単位) を指定します。既定値は 30000 ミリ秒 (30 秒) です。

入力

• 処理期限 - キュー アイテムを処理する必要がある期日のタイムスタンプです。このプロパティには、DateTime.Now.AddHours(2)、DateTime.Now.AddDays(10)、DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) などの相対タイムスタンプを入力することができます。また、米国の表記を使用して、12/10/2017 07:40:00 などの正確な時刻を追加することができます。この日付は自動的に修正することができます。たとえば、8 9 2018 9:0 と記述すると、自動的に 08/09/2018 09:00:00 に変換されます。
• Orchestrator フォルダー パス - キューアイテムを作成する Orchestrator のフォルダーのパスです。現在のプロセスが動作する Orchestrator のフォルダーのパスとは異なります。Orchestrator のフォルダーの詳細については、こちらをご覧ください。クラシック フォルダーの場合、このプロパティはフローティング ロボットでのみ使用でき、現在のユーザーが移動先のフォルダーで正しいタスク権限を持っている場合にのみ使用できます。モダン フォルダーの場合、フォルダー パスのオーバーライドはサポートされていません。このフィールドでは、文字列と String 変数のみがサポートされています。

注:

[フォルダー パス] プロパティは、現在のフォルダーとは異なるフォルダーからキュー アイテムを作成またはクエリする必要がある場合にのみ使用する必要があります。このアクションを実行するユーザーがターゲット フォルダーに必要なアクセス許可を持っていない場合、キュー アイテムの作成は失敗し、重大なエラーがスローされます。フォルダーのアクセス許可について詳しくは、 こちらをご覧ください。

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

その他

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

出力

• Queue Item (Output) - The queue object that is returned from Orchestrator as a QueueItemData object after the queue is created. This object can be passed to the Wait for Queue Item and Resume activity in order to suspend the execution of the workflow until the transaction is completed.

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

• キュー名 - QueueItem オブジェクトが追加されるキューです。この名前は大文字と小文字を区別しません。つまり、Orchestrator で「MyFirstQueue」と定義されている場合は、「myfirstqueue」とも一致します。最大文字数は 50 文字です。
• 優先度 - 追加するキュー アイテムの優先度レベルです。このプロパティは、[処理期限] および [延期日] とともにキュー アイテムの優先順位を決める際の基準になります。
• ItemInformation - 追加する特定の QueueItem に関する補足情報のコレクションです。この情報はアイテムに保存され、トランザクション処理で使用されます。Number、Boolean、String、DateTime の各型の基本的な値のみを使用することをお勧めします。文字列型引数の値には、文字 [ と " " を使用できません。引数名には、:、.、,、@、" の各文字を使用できません。
• Queue Item (Output) - The queue object that is returned from Orchestrator as a QueueItemData object after the queue is created. This object can be passed to the Wait for Queue Item and Resume activity in order to suspend the execution of the workflow until the transaction is completed.

詳細オプション

共通

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

注:

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

• 表示名 - アクティビティの表示名です。
• タイムアウト (ミリ秒) - エラーがスローされる前にアクティビティが実行されるまで待機する時間 (ミリ秒単位) を指定します。既定値は 30000 ミリ秒 (30 秒) です。

入力

• 処理期限 - キュー アイテムを処理する必要がある期日のタイムスタンプです。このプロパティには、DateTime.Now.AddHours(2)、DateTime.Now.AddDays(10)、DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)) などの相対タイムスタンプを入力することができます。また、米国の表記を使用して、12/10/2017 07:40:00 などの正確な時刻を追加することができます。この日付は自動的に修正することができます。たとえば、8 9 2018 9:0 と記述すると、自動的に 08/09/2018 09:00:00 に変換されます。
• Orchestrator フォルダー パス - キューアイテムを作成する Orchestrator のフォルダーのパスです。現在のプロセスが動作する Orchestrator のフォルダーのパスとは異なります。Orchestrator のフォルダーの詳細については、こちらをご覧ください。クラシック フォルダーの場合、このプロパティはフローティング ロボットでのみ使用でき、現在のユーザーが移動先のフォルダーで正しいタスク権限を持っている場合にのみ使用できます。モダン フォルダーの場合、フォルダー パスのオーバーライドはサポートされていません。このフィールドでは、文字列と String 変数のみがサポートされています。

注:

[フォルダー パス] プロパティは、現在のフォルダーとは異なるフォルダーからキュー アイテムを作成またはクエリする必要がある場合にのみ使用する必要があります。このアクションを実行するユーザーがターゲット フォルダーに必要なアクセス許可を持っていない場合、キュー アイテムの作成は失敗し、重大なエラーがスローされます。フォルダーのアクセス許可について詳しくは、 こちらをご覧ください。

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