通知を受け取る

UiPath Orchestrator

UiPath Orchestrator ガイド

Orchestrator でキューを管理する

キューの作成


  1. [キュー] ページで、[キューを追加] をクリックします。新しいキューを作成したり、他のフォルダーのキューをリンクしたりするための、2 つのオプションが表示されます。
  2. [新しいキューを作成] をクリックします。[キューを作成] ウィンドウが表示されます。

全般設定

  1. [名前] フィールドに、キューの名前を入力します。
  2. [説明] フィールドにキューの説明を追加します。

その他のオプション

  1. トランザクションの参照を一意にする場合は、[参照の重複を禁止] チェックボックスを選択します。
  2. キュー アイテムのデータおよび出力をデータベースで暗号化する場合は、[暗号化された形式で保存] チェックボックスを選択します。

📘

キュー アイテムの暗号化

  • 暗号化操作は取り消せません。
  • キュー アイテムの固有データおよび出力の値のみが暗号化されます。
  • 既存のキューは暗号化できません。代わりに、キューを再作成して [暗号化された形式で保存] チェックボックスを選択できます。
  • 暗号化形式が原因で、データベース フィールド [固有データ] および [出力] の分析をレポートできなくなったほか、Insights の対応するダッシュボードを利用できなくなりました。
  1. 自動リトライ メカニズムを使用する場合は、[自動リトライ] チェックボックスを選択します。
    • [最大リトライ回数] フィールドに、キュー アイテムの再試行を許可する回数を入力します。

スキーマ定義

  1. 固有データ出力データ分析データのいずれかまたはそれぞれの JSON スキーマを、該当の [参照] ボタンを使用してアップロードします。

SLA 予測値

  1. アイテムの処理時間の制御を向上させ、期限を満たすよう必要なリソースを評価する場合、SLA 予測を有効化します。SLA 予測が有効化されている場合は、次のフィールドを構成します。
    • [プロセス] ドロップダウンから、キュー アイテムを処理するプロセスを選択し、以下の SLA 値を入力します。最大値は 90 日です。
    • 実際の SLA より前のバッファー ゾーンを定義する場合は リスク SLA を有効化し、以下の値を入力します。リスク SLA は、SLA よりも小さくなければなりません。
  2. [追加] をクリックします。中身が空の状態でキューが作成され、[キュー] ページに表示されます。

キューへのデータ読み込みは、Studio を使用するか、[アイテムをアップロード] ウィンドウで行えます。キューからのアイテムの処理は、Studio を使用して行う必要があります。詳細については、「Studio でキューを管理する」をご覧ください。

 

キューを編集する


次のような既存のキュー設定を更新できます。

  • キューの名前説明
  • [自動リトライ] オプション
  • リトライの最大回数

キューの名前または説明を編集する

Orchestrator で既存のキュー名を編集するには、以下の手順を実行します。

  1. [キュー] ページで、目的のキューに対応する [その他のオプション] ボタンをクリックします。
  2. [編集] をクリックします。[キューを更新] ウィザードが表示されます。
  3. [名前] フィールドに、選択したキューの新しい名前を入力します。
    Make sure to enter a unique name. If a queue with the same name already exists in your tenant, you are prompted by the error message: The name <QueueName> is already used. (#1001) です。
    The name is not case sensitive. Therefore, NEW_QueueName and new_queuename are duplicates.
  4. [説明] フィールドで、キューの説明を更新します。
  5. [更新] をクリックします。

🚧

重要

Studio で、対応するワークフロー内のキュー名を必ず更新してください。Studio でキュー名を自動更新する方法はないので、手動で更新する必要があります。

自動リトライ オプションを変更する

既存のキューの [自動リトライ] オプションを変更するには、以下の手順を実行します。

  1. [キュー] ページで、目的のキューに対応する [その他のオプション] ボタンをクリックします。
  2. [編集] をクリックします。[キューを更新] ウィザードが表示されます。
  3. [自動リトライ] フィールドで、必要なオプションを選択します。
    [はい] を選択した場合は、「最大リトライ回数を設定する - 自動リトライ オプション: はい」をご覧ください。
  4. [更新] をクリックします。

最大リトライ回数を設定する

[自動リトライ] チェックボックスがオン

[自動リトライ] オプションを選択した場合は、[最大リトライ回数] フィールドが表示されます。
失敗したトランザクションのリトライ回数として、1 ~ 50 の範囲の値を入力します。

The existing failed transactions are not being retried. Only the transactions that fail after you set the new value are being retried.

Let's say you have a list of failed transactions that are retried once. The current value of Max # of retries is 2. Update the value to 3 and the failed transactions are retried two more times instead of one.

[自動リトライ] チェックボックスがオフ

[自動リトライ] オプションを選択しなかった場合、[最大リトライ回数] フィールドは表示されません。
トランザクションはリトライされません。

 

キューのリンクを管理する


フォルダー間でキューを共有すると、基になるプロセスが同じキューをターゲットにしている場合、Studio でワークフローを再設計しなくても、複数のフォルダーでジョブを開始できます。キューをフォルダーにリンクすると、そのキューとキューに関連するすべてのオブジェクト (キュー アイテムなど) をそのフォルダーで使用できるようになります。

📘

複数のフォルダーにリンクされているキューは、linked_iconlinked_icon アイコンでマークされます。アイコンが表示されていない場合、現在のフォルダーは、キューが存在する唯一のフォルダーです。ここでキューを削除すると、キューは Orchestrator から完全に削除されます。


キューを追加するフォルダー (ターゲット フォルダー) のキュー - 作成権限と、現在キューが存在するフォルダー (元のフォルダー) のキュー - 表示が必要です。ターゲット フォルダーのキュー - 編集がある場合は、元のフォルダーのキュー - 編集も必要です。

現在のフォルダーに複数のキューをリンクする

  1. キューをリンクするフォルダーの [キュー] ページで、[追加] をクリックします。キューを追加したり、他のフォルダーのキューをリンクしたり、オプションを非表示にするための、3 つのボタンが表示されます。
  2. [他のフォルダーのキューをリンク] をクリックします。[他のフォルダーのキューをリンク] ウィンドウに、キューの表示権限を持つフォルダー内のすべてのキューのリストが表示されます。
  3. [キューを選択] セクションで、リストから 1 つまたは複数のキューを選択します。
818818
  1. [続行] をクリックします。[フォルダーの検証] セクションに移動します。ここで、キューが既にリンクされているフォルダーを確認できます。複数のフォルダーがある場合は、番号が表示されます。番号にカーソルを合わせると、フォルダー名が表示されます。
816816
  1. 変更を元に戻すには、該当するキューの [削除] をクリックし、操作を取り消すには [終了] をクリックします。
  2. 選択したキューと現在のフォルダーの間にリンクを作成するには、[リンク] をクリックします。キューが [キュー] ページに表示されます。
823823

複数のフォルダーにキューをリンクする

  1. リンクするキューが存在するフォルダーに移動します。
  2. 目的のキューで [その他のアクション] > [リンクを管理] をクリックして、[リンクを管理] ウィンドウを開きます。キューのリンクの管理ウィンドウが表示されます。
724724

1 - 左側のペインには、キューの表示権限が付与されたすべてのフォルダーが表示されます。
2 - キューの現在のステート。キューが現在置かれているフォルダーの数とその名前を示します。
3 - 左側のペインで選択した内容に従ってキューが追加されるフォルダーです。
4 - キューが削除されるフォルダーです。

  1. [更新] をクリックします。確認ウィンドウが表示されます。
  2. 変更を中止する場合は [キャンセル] をクリックし、変更を反映させる場合は [続行] をクリックします。変更内容に応じて、Orchestrator に操作が反映されます。

フォルダーへのキューのリンクを解除する

フォルダーへのキューのリンクの解除は、リンク操作とほぼ同じ方法で実行できます。上記の手順のリンク管理領域に移動し、特定のキューと特定のフォルダー間の接続を削除します。
Alternatively, you can remove a queue using the Remove functionality. See Removing a Queue.

🚧

重要

複数のフォルダーに存在するキューを削除すると、キューは削除操作を実行したフォルダーからのみ削除され、他のフォルダーからは削除されません。キューを完全に削除するには、既存のリンクをすべて削除する必要があります。

以下の状況では、フォルダーへのキューのリンクを解除できません。

  • そのフォルダーでキュー SLA が有効化されている。
  • キューにキュー トリガーがアタッチされている。

 

トランザクションの表示


[キュー] ページで、[その他のアクション] > [トランザクションを表示] をクリックします。[トランザクション] ページが表示されます。ここには、対象のキュー アイテムのみが含まれています。

 

レビュー リクエストの表示


[キュー] ページで、[レビュー リクエスト] をクリックして、現在ログイン中のユーザーに、リビジョンに割り当てられているすべてのキューを表示します。このページではステータス変更とアイテム情報の管理ができます。

 

キューチャートの表示


特定のキューのチャートを確認するには、[その他のアクション] ボタンをクリックし、[チャートを表示] をクリックします。

線チャートには、特定の期間におけるトランザクション ステータスの推移が表示されます。時間フィルター (直前の 1 時間、1 週間、30 日) を変更することができ、平均実行時間や最大再試行数を表示できます。

812812

 

CSV ファイルを使用してアイテムをキューにアップロードする


See here details about uploading queue items using a CSV file.

 

キューの監視


キューを監視するには、該当する [その他のアクション] ボタンをクリックし、次に [キューを監視] をクリックします。または、[キューの概要] ウィジェット ([監視] > [キュー]) で、ロボットを選択します。

ユーザーがキューを監視するには、キューおよび監視に関して表示権限を持つ必要があります。さらに、[監視] > [キュー] ページの [エラー フィード] ウィジェットでエラーを無効化するには、監視に関する編集権限が必要です。

 

キューにタグを追加する


📘

アクセス許可

キューに既存のタグを追加するには、キューに対する [編集] 権限とアセットに対する [表示] 権限が必要です。
キューに新しいタグを追加するには、キューに対する [編集] 権限とアセットに対する [作成] 権限が必要です。

📘

  • 各キューには、最大 100 万個のキー/値のペアを設定できます。
  • ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
  • Tag names can't contain these characters: < > % & \ ? / : です。

キューへのタグの適用は、キューの作成時または既存のキューの編集時に行うことができます。キューの編集時にキューにタグを追加するには、以下の手順に従います。

  1. [キュー] ページで、対象のキューの横にある [その他のアクション] > [編集] をクリックします。キューが編集のために開かれます。
  2. [ラベル] フィールドで、ラベル名の入力を開始します。既存のラベルを選択するか、新しいラベルを作成することができます。
  3. [プロパティ (キーと値のペア)] フィールドで、[新規追加] をクリックします。
  4. 新しいキーと値を追加します。既存のキーまたは値を選択するか、新しいキーまたは値を作成することができます。
  5. 完了したら、[更新] をクリックします。キューが更新され、新たに作成したタグを (ある場合) 他のオブジェクトで使用できるようになります。

キューからタグを削除する


キューからタグを削除するには、以下の手順に従います。

  1. [キュー] ページで、対象のキューの横にある [その他のアクション] > [編集] をクリックします。キューが編集のために開かれます。
  2. [ラベル] フィールドで、削除するラベル名の横の X をクリックします。ラベルが削除されます。
  3. [プロパティ (キーと値のペア)] フィールドで、削除するキーまたは値の横の X をクリックします。キーまたは値が削除されます。
  4. キー/値のペアを削除するには、そのエントリに対応する削除アイコンをクリックします。キー/値のペアが削除されます。
  5. 完了したら、[更新] をクリックします。キューが更新され、タグが削除されます。

キューを削除する


キューを削除するには、該当する [その他のアクション] ボタンをクリックし、次に [削除] をクリックします。

または、[キュー] ページからキューを選択して [削除] をクリックします。キューが [キュー] ページに表示されなくなります。

🚧

重要

複数のフォルダーに存在するキューを削除すると、キューは削除操作を実行したフォルダーからのみ削除され、他のフォルダーからは削除されません。キューを完全に削除するには、既存のリンクをすべて削除する必要があります。

📘

注:

キューが削除されると、そのキューに属する割り当てられたトランザクション アイテムは [レビュー リクエスト] ページに表示されなくなります。

6 か月前に更新


Orchestrator でキューを管理する


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。