Orchestrator でキューを管理する

Orchestrator でキューを構成する方法についてはこちらをご覧ください。

キューを作成する

1. [キュー] ページで、[キューを追加] をクリックします。新しいキューを作成したり、他のフォルダーのキューをリンクしたりするための、2 つのオプションが表示されます。
2. [新しいキューを作成] をクリックします。[キューを作成] ウィンドウが表示されます。
3. [名前] フィールドに、キューの名前を入力します。
4. [説明] フィールドにキューの説明を追加します。
5. トランザクションの参照を一意にする場合は、[参照の重複を禁止] チェックボックスを選択します。
6. キュー アイテムのデータおよび出力をデータベースで暗号化する場合は、[暗号化された形式で保存] チェックボックスをオンにします。
   注:

   • 暗号化操作は取り消せません。
   • データは AES 256 を使用して保存され、復号できるのは Orchestrator のみです。
   • 使用される暗号化キーは、構成ファイルのパラメーターで設定されたキーです。詳細については、UiPath.Orchestrator.dll.config ページの「インストールの詳細設定」セクションをご覧ください。
   • キュー アイテムの固有データおよび出力の値のみが暗号化されます。これらの値はデータベース内でのみ暗号化され、機密コンテンツがデータベース管理者から保護されます。Orchestrator の UI では復号されたコンテンツが引き続き表示されます。エンドツーエンドで暗号化を使用するには、キュー アイテムをキューに追加する前に暗号化する必要があります。
   • 既存のキューは暗号化できません。代わりに、キューを再作成して [暗号化された形式で保存] チェックボックスを選択できます。
   • 暗号化形式が原因で、データベース フィールド [固有データ] および [出力] の分析をレポートできなくなったほか、Insights の対応するダッシュボードを利用できなくなりました。
7. 自動リトライ メカニズムを使用する場合は、[自動リトライ] チェックボックスを選択します。
   • [最大リトライ回数] フィールドに、キュー アイテムの再試行を許可する回数を入力します。
8. 固有データ、出力データ、分析データのいずれかまたはそれぞれの JSON スキーマを、該当の [参照] ボタンを使用してアップロードします。
9. アイテムの処理時間の制御を向上させ、期限を満たすよう必要なリソースを評価する場合、SLA 予測を有効化します。SLA 予測が有効化されている場合は、次のフィールドを構成します。
   • [プロセス] ドロップダウンから、キュー アイテムを処理するプロセスを選択し、以下の SLA 値を入力します。最大値は 90 日です。
   • 実際の SLA より前のバッファー ゾーンを定義する場合はリスク SLA を有効化し、以下の値を入力します。リスク SLA は、SLA よりも小さくなければなりません。
10. [追加] をクリックします。中身が空の状態でキューが作成され、[キュー] ページに表示されます。

キューへのデータ読み込みは、Studio を使用するか、[アイテムをアップロード] ウィンドウで行えます。キューからのアイテムの処理は、Studio を使用して行う必要があります。

キューを編集する

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

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

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

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

1. [キュー] ページで、目的のキューに対応する [その他のオプション] ボタンをクリックします。
2. [編集] をクリックします。[キューを更新] ウィザードが表示されます。
3. [名前] フィールドに、選択したキューの新しい名前を入力します。
   注:

   • 必ず一意の名前を入力してください。同じ名前のキューがテナントに既に存在する場合は、The name <QueueName> is already used. (#1001) というエラー メッセージが表示されます。
   • この名前は大文字と小文字を区別しません。したがって、NEW_QueueName と new_queuename は重複していることになります。
4. [説明] フィールドで、キューの説明を更新します。
5. [更新] をクリックします。
   重要: Studio で、対応するワークフロー内のキュー名を必ず更新してください。Studio でキュー名を自動更新する方法はないので、手動で更新する必要があります。

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

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

1. [キュー] ページで、目的のキューに対応する [その他のオプション] ボタンをクリックします。
2. [編集] をクリックします。[キューを更新] ウィザードが表示されます。
3. [自動リトライ] フィールドで、必要なオプションを選択します。
4. [更新] をクリックします。

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

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

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

失敗したトランザクションのリトライ回数として、1 ～ 50 の範囲の値を入力します。

注: 既存の失敗したトランザクションはリトライされません。新しい値を設定した後に失敗したトランザクションだけが、リトライされます。

リトライされたキュー アイテムと削除されたキュー アイテムは、一意の参照チェックの対象になりません。したがって、元のキュー アイテムをリトライ チェーンから削除しないことをお勧めします。削除すると、一意の参照を検証できなくなるためです。

失敗したトランザクションのうち、一度リトライされているもののリストがあるとします。[最大リトライ回数] の現在の値は 2 です。値を 3 に更新すると、失敗したトランザクションが 1 回ではなく 3 回リトライされます。

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

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

トランザクションはリトライされません。

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

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

注:

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

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

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

1. キューをリンクするフォルダーの [キュー] ページで、[追加] をクリックします。キューを追加したり、他のフォルダーのキューをリンクしたり、オプションを非表示にするための、3 つのボタンが表示されます。
2. [他のフォルダーからリンク] をクリックします。[他のフォルダーのキューをリンク] ウィンドウに、キューの表示権限を持つフォルダー内のすべてのキューのリストが表示されます。
3. [キューを選択] セクションで、リストから 1 つまたは複数のキューを選択します。
   
   

   

   
   
4. [続行] をクリックします。[フォルダーの検証] セクションに移動します。ここで、キューが既にリンクされているフォルダーを確認できます。複数のフォルダーがある場合は、その名前が表示されます。
   
   

   

   
   
5. 変更を元に戻すには、該当するキューの [削除] をクリックし、操作を取り消すには [終了] をクリックします。
6. 選択したキューと現在のフォルダーの間にリンクを作成するには、[リンク] をクリックします。キューが [キュー] ページに表示されます。
   
   

   

   
   

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

1. リンクするキューが存在するフォルダーに移動します。
2. 目的のキューで [その他のアクション] > [リンクを管理] をクリックして、[リンクを管理] ウィンドウを開きます。キューのリンクの管理ウィンドウが表示されます。
   1 - 左側のペインには、キューの表示権限が付与されたすべてのフォルダーが表示されます。2 - キューの現在のステート。キューが現在置かれているフォルダーの数とその名前を示します。3 - 左側のペインで選択した内容に従ってキューが追加されるフォルダーです。4 - キューが削除されるフォルダーです。
   

   

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

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

フォルダーへのキューのリンクの解除は、リンク操作とほぼ同じ方法で実行できます。上記の手順のリンク管理領域に移動し、特定のキューと特定のフォルダー間の接続を削除します。

削除機能を使用してキューを削除することもできます。

重要:

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

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

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

トランザクションを表示する

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

レビュー リクエストを表示する

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

キューのグラフを表示する

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

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

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

CSV ファイルを使用してキュー アイテムをアップロードする方法の詳細は、こちらをご覧ください。

キューを監視する

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

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

キューにタグを追加する

注:

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

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

注:

• 各キューには、最大 100 万個のキー/値のペアを設定できます。
• ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
• タグ名に使用できない文字は、<、>、%、&、\)\)、?、/、: です。

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

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

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

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

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

キューを削除する

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

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

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

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