キューおよびトランザクションについて

キューとは、無制限にアイテムを保持できる収納機能です。キュー アイテムには、インボイスの情報や顧客情報などさまざまな種類のデータを格納できます。この情報は、例として SAP や Salesforce などの他のシステムで処理することもできます。

The data stored in, and output from, Queue items is free form by default. For situations where a specific schema is needed, such as integrations with other applications, processing machine-generated forms, or analytics, you can upload custom JSON schemas to ensure that all Queue item data is in the proper format.

Orchestrator で新規に作成されるキューは、既定では中身は空です。キューにアイテムを格納するには、Orchestrator のアップロード機能または Studio アクティビティを使用することができます。Studio アクティビティを使用すると、アイテムのステータスを変更したり、アイテムを処理したりすることもできます。キュー アイテムが処理されると、それらのアイテムはトランザクションになります。

キューの概要

キューでは、複雑なロジックによって明示される大型のオートメーション プロジェクトを作成できます。たとえば、すべての請求書情報を収集して各データを格納するキュー アイテムを作成するプロセスを作成できます。続いて、Orchestrator からその情報を収集し、それを使用して追加のタスク (別のアプリケーションで請求書の支払いをする、支払期日または値に基づいて支払いを延期する、請求書の支払いが行われるたびに会計チームにメールを送信するなど) を実行する別のプロセスを作成できます。

[キュー] ページでは、新しいキューを作成できます。以前作成されたキュー、トランザクション ステータス進行状況の時系列チャート、さまざまな他の詳細 (平均実行時間、成功したトランザクションの総数など) を表示することもできます。

キュー グリッドで利用可能なデータは定期的に更新されます。つまり、必ずしもリアルタイムに表示されるとは限らず、わずかな遅延が発生する可能性があります。さらに、アイテム保持ポリシーの影響も受けないため、データベースの項目をアーカイブしても、グリッドに表示される情報は変更されません。

Item statuses are controlled by RPA developers when they create the automation projects, while revision statuses are controlled in Orchestrator and enable you to perform version control, but only of queue items that have been abandoned or have failed with an application or business exception.

Failed or abandoned items can also be assigned to a reviewer, which can be changed or cleared at any point, if needed. Each of these changes are tracked in the History tab of the Audit Details window. The reviewer is in charge of assessing the current status of the transactions they are assigned to, and changing the review status. The status of queue items up for revision can be changed in the Review Requests page.

重要:

To ensure that queue item processing is performed successfully, you need to have a unique reference set at the queue level when dequeuing by reference. Failing to keep the reference unique will lead to concurrency access issues, such as failures due to no transaction data being found (No Transaction Data error message).

参照を一意にすることができない場合は、参照を使用せずにキューから削除することをお勧めします。

.

スキーマ定義

When creating or editing a queue, you can upload a custom JSON schema for the Specific Data,Output Data, and/or Analytics Data. With the schema(s) in place, all transactions are validated against the provided format, and if the resulting data does not conform, that item fails with a Business Exception.

重要:

• スキーマは、既存のトランザクションに遡及的に適用されるのではなく、スキーマをアップロードした後に実行されるトランザクションにのみ適用されます。
• スキーマには、配列を含めることはできません。
• 検証のために、DateTime は string 型として受け入れられます。
• 分析データスキーマの使用と検証には、バージョン 19.10 以降のロボットとアクティビティが必要です。
• アップロードしたスキーマに有効な URI スキーマ定義がない場合、以下の例に示すように、draft-07 がフォールバックとして使用されます。

サンプル スキーマ:

{
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://example.com/root.json",
  "type": "object",
  "title": "The Root Schema",
  "additionalProperties": { "type": "string" },
  "required": [
    "stringTest",
    "intTest",
    "boolTest"
  ],
  "properties": {
    "stringTest": {
      "$id": "#/properties/stringTest",
      "type": "string",
      "title": "The Stringtest Schema",
      "default": "",
      "examples": [
        "stringTest"
      ],
      "pattern": "^(.*)$"
    },
    "intTest": {
      "$id": "#/properties/intTest",
      "type": "integer",
      "title": "The Inttest Schema",
      "default": 0,
      "examples": [
        30
      ]
    },
    "boolTest": {
      "$id": "#/properties/boolTest",
      "type": "boolean",
      "title": "The Booltest Schema",
      "default": false,
      "examples": [
        false
      ]
    }
  }
}

トランザクションの概要

[トランザクション] ページでは、対象のキューのトランザクションを表示します。また、そのステータスや処理日、処理を実行するロボット、また、例外および参照情報がある場合は、その種類も表示されます。

特定のトランザクションまたはそのグループを独自の参照に基づいて検索できます。独自の参照は、[キュー アイテムを追加] アクティビティと [トランザクション アイテムを追加] アクティビティの [参照] プロパティで追加されます。参照を使用して、オートメーション プロジェクト内で使用されている他のアプリケーションにトランザクションをリンクすることができます。さらにこの機能を使用することで、Orchestrator 内で指定された独自の参照に基づいて特定のトランザクションを検索できます。

トランザクション参照をキュー レベルで一意にすることもできます。この機能はキュー作成時に有効となり、削除またはリトライされたものを除き、すべてのトランザクションに適用されます。この設定により特定のアイテムの識別が容易になり、レビュープロセスが簡素化されます。

キューへのアイテムの追加時に重複参照が発生した場合には、ジョブは [エラー] ステータスで失敗し、Execution error: UiPath.Core.Activities.OrchestratorHttpException: Error creating Transaction. Duplicate Reference. というエラー メッセージが [ジョブの詳細] ウィンドウに表示されます。

キュー アイテムに格納されている情報が、Orchestrator のトランザクションの詳細ウィンドウの [固有データ] に表示されます。さらに、アイテムが失敗してリトライされた場合は、アイテムの履歴が同じウィンドウに表示されます。

注:

To achieve better control in terms of Orchestrator performance, the Specific Data size of queue items is limited to 1 MB with the Queue.MaxSpecificDataSizeInKiloBytes parameter. Anything beyond this limit cannot be added to a queue, and it returns the 403 - Payload Too Large error code. If you need to upload larger items, store the large data in external storage and only reference the link within the item.

トランザクションの詳細ウィンドウには 3 つのタブが含まれます。

• 詳細 - トランザクションに追加された正確な情報、およびトランザクションのステータス履歴、リトライ回数を確認できます。
• Comments - enables you to view and add transaction-related comments in case you need to share information about a specific transaction with your teammates. All the users with View,Edit, and Delete permissions on Queues and Transactions can add, edit, or remove comments, respectively; however, keep in mind you can make changes to your own comments only.
• [履歴] - 実行されたアクションとその実行者、レビュー担当者、および現在のレビュー ステータスを確認できます。

処理順序

任意のキュー内で、トランザクションは次の順序に従って階層的に処理されます。

1. 次のように処理期限のあるアイテム。
   1. [優先度] の順序と
   2. [優先度] が同じアイテムについては、設定された [処理期限] に従います。
2. 処理期限のないアイテムは [優先度] の順序。
   1. [優先度] が同じアイテムについては、先入れ先出しのルール

[処理期限] または [延期] の日付を設定する場合は、それぞれのフィールドに相対的な日付を入力することをお勧めします。たとえば、 DateTime.Now.AddHours(2)、 DateTime.Now.AddDays(10) 、 DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0))です。また、米国の表記法を使用して、 10/10/2019 07:40:00などの正確な時刻を追加することもできます。この日付の自動修正が可能です。たとえば、 12 10 2019 9:0と記述すると、自動的に 12/10/2019 09:00:00に変換されます。

Studio で [処理期限] および [延期] フィールドに追加された日付は、Orchestrator の [トランザクション] ページの [処理期限] および [延期]列の下に表示されます。

トランザクションをエクスポートする

[トランザクション] ページの [エクスポート] ボタンをクリックすれば、指定のキューに関連するすべてのトランザクションや情報を .csv ファイルにエクスポートできます。ページの絞り込みオプションはすべて、生成されたファイルにも適用されます。

最高のパフォーマンスを得るためにエクスポートされたエントリは日付の新しい順に並んでいないため、注意が必要です。

キュー SLA の予測

このツールを使用すると、キューに新しく追加されるアイテムに SLA (アイテム期限) を設定できます。これにより、追加されたアイテムをタイムリーに処理できるかどうかと、どのリソースを SLA に違反しないように割り当てる必要があるかを評価できるようになります。SLA が満たされない恐れがある場合は、適宜通知され、必要な調整を行うことができます。

注:

Learn how to configure queue SLA.

Learn how predictions are made and what they mean exactly.

SLA は、期限が設定されていないアイテムにのみ適用されます。つまり、期限が事前に定義されていない新しいアイテムは、SLA として設定された値が自動的に適用されたうえでキューに追加されます。具体的には、アイテムがキューに追加された時点から、そのキューに対して SLA で設定された値がそれぞれのアイテムの期限として適用されます。たとえば、SLA を 2 時間に設定し、午後 4 時、5 時、および 6 時に 3 つのアイテムをキューに追加すると、アイテムの期限はそれぞれ午後 6 時、7 時、8 時になります。

期限のあるアイテム (Studio またはアップロードに使用される .csv ファイルのいずれかで設定) は SLA の設定による影響を受けません。

重要:

• The Priority of the items added in a queue after enabling SLA predictions is automatically set to High, regardless of how it was set in Studio or the .csv file used for upload.
• SLA 予測が有効化されているキューに関連付けられたプロセスは削除できません。
• If at least one queue item exceeds its deadline, Over Capacity is displayed in the Necessary Robots (SLA) column, and predictions are no longer calculated.
• 処理期限が 24 時間以内 (この時間は web.config の Queue.SlaReadaheadTimeLimitHours パラメーターで変更できます) に迫っているキュー アイテムに対して予測が作成されます。アイテムの延期日数は考慮されません。

キュー トリガーと SLA 予測値は、キューとプロセスの関連付けおいて依存関係があります。したがって、一方を設定すると、設定が一致するように、もう一方も自動入力されます。たとえば、キュー Y に対するキュー トリガーを、プロセス X を使用するように定義したとします。キュー Y の SLA 予測値はプロセス X のみを使用して決まるので、Y のキュー SLA を有効化すると、X には値が事前入力され、読み取り専用になります。

リスク SLA (Risk SLA)

アイテムのリスク SLA を定義することもできます。これは、SLA の前のバッファーゾーンのように機能します。明示的に、アイテムのリスク期限は、キュー アイテムがキューに追加された時点からのリスク SLA に基づいて計算されます。SLA を 2 時間に設定し、4:30、5:15、および 6:45 PM に 3 つのアイテムをキューに追加すると、アイテムのリスク期限はそれぞれ 6:30、7:15、8:45 PM になります。

リスク SLA が経過し、キュー アイテムが処理されない場合、アイテムは期限に間に合わないリスクが発生します。ユーザーには適切に通知され、それに応じて調整を行うことができます。

権限

キューの SLA 予測値を構成できるようにするには、次の権限が必要です。

• プロセスの表示
• キューの表示
• キューの編集権限 (キューの編集時に SLA を構成するため)
• キューの作成権限 (キューの作成時に SLA を構成するため)

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

この機能では、.csv ファイルを使用して、Orchestrator の特定のキューにアイテムを一括アップロードできます。そのためには、まず特定のキューの Orchestrator インスタンスにファイルをアップロードします。ファイルが正常に処理された後、選択されたストラテジに従って、含まれているアイテムがキューにアップロードされます。アップロード操作が正常に実行されるためには、あらかじめこのファイルにデータを定義済みの形式で読み込んでおく必要があります。

There is a series of predefined column headers that you can use when building your .csv file, but you can also use other custom headers. After successfully uploading the .csv file, the information in columns with predefined headers is mapped to columns as found in Orchestrator. Information in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator.

注:

The upload is limited to 15,000 items per file. You can lower the limit using the Upload.Queues.MaxNumberOfItems parameter in the UiPath.Orchestrator.dll.config

ページです。

列のマッピング

ファイルの列ヘッダー	Orchestrator のフィールド
参照 一意の参照キューの場合は必須です。 二重引用符 (") を除く、すべての特殊文字をサポートしています。	参照 References are not compatible with v2016.2 or lower versions of Orchestrator or Robot.
処理期限 次のいずれかの形式で日付を入力する必要があります。 YYYY-MM-DD YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss YYYY MM DD HH:mm:ss	処理期限
延期 次のいずれかの形式で日付を入力する必要があります。 YYYY-MM-DD YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss YYYY MM DD HH:mm:ss	延期
優先度 次のいずれかの値を入力する必要があります。 低 または 1 標準 または 2 高または 3 ファイル内で優先度を指定していない場合、既定では、アイテムは高優先順位でアップロードされます。	優先度 それぞれ、次の値にマッピングされます。 低 (Low) 標準 (Normal) 高 (High)
[Custom_Name] 名前には、英数字 (0-9、a-z) とアンダースコアしか使えません。	固有データ JSON 形式にマッピングされます。 例: 当行払い小切手: 5540

ファイルには、空白の列ヘッダーを含めることはできませんのでご注意ください。

注:

定義済みの列ヘッダーでは大文字と小文字が区別されます。必ず上記のマッピングルールに従ってください。reference という名前の .csv の列は [参照] 列の代わりに [特定のデータ] セクションにマッピングされています。

ストラテジをアップロードする

アップロードの処理には、2 種類の方法があります。

• 個別にすべてを処理 - すべてのアイテムを個別に処理し、処理が正常に完了したアイテムをキューに追加します。処理に失敗したアイテムがある場合は、それらのアイテムのリストを返します。このリストは、CSV ファイルでダウンロードできます。このファイルには、当初アップロードしたファイルと同じフィールドが表示されます。
• 一括 (すべて成功/すべて失敗) で処理 - すべてのアイテムが正常に処理された場合にのみアイテムが追加されます。そうでない場合は何も追加されません。

例：

次に示す .csv ファイルの内容をキューにアップロードするとします。このようなファイルを容易に作成するには、データを Excel ファイルに入力して .csv ファイルとして保存します。

または、すべての列ヘッダーを入力済みの .csv ファイルをダウンロードして、ニーズに合わせてカスタマイズすることもできます。

ファイルをダウンロード

このファイルには、Orchestrator に存在するアイテムと名前が同じ 3 つの既定の列 ([Reference]、[Deadline]、および [Priority] - 緑で強調表示) と 2 つのカスタム列 ([Customer] および [Color] - 赤で強調表示) が存在します。

1. アップロード先のキューに対する [アイテムをアップロード] をクリックして、この .csv ファイルを選択します。Orchestrator によってファイルが解析され、値がフォーマット ルールを満たしていることが確認されます。

2. 適切なアップロード ストラテジを選択して [アップロード] をクリックし、プロセスを完了します。

   

[その他のアクション] > [トランザクションを表示] を選択して、アップロードしたキュー アイテムを表示します。

The Transactions page displays each item uploaded from your file. The information contained within the file's predefined columns is mapped to the columns with the same name in Orchestrator (Reference,Deadline, and Priority, highlighted in green):

カスタム列の情報は、JSON 形式で各アイテムの [固有データ] セクションにマップされています。その内容を表示するには、アイテムの [詳細を表示] をクリックします。