オーケストレーション プロセス

長期実行ワークフローは、サービスのオーケストレーション、人間の介入、無人環境における長期実行トランザクションをサポートするマスター プロジェクトです。

特定のプロセスが、アクティビティの次のステップに進む前に、例外、承認、または検証を処理するために人間の入力を必要とする場合、人間の介入が行われます。この状況では、プロセスの実行が中断され、人間のタスクが完了するまでロボットは解放されます。

ワークフローの断片化

長期実行ワークフローは、 UiPath.Persistence.Activities を含み、[ プロセスを呼び出し ] アクティビティやユーザーの操作を伴わないアクティビティと組み合わせて、人間のタスクとロボットのタスクのオーケストレーションが可能です。セッション 0 で動作するため、高速実行が保証されます。オーケストレーション プロセスのデバッグはユーザー セッションで行われることに注意してください。

長期実行ワークフローは、以下のオーケストレーションが可能です。

• API コールを実行し、セッション 0 で動作するアクティビティが含まれる可能性があるバックグラウンド プロセス。これらのアクティビティは 、[プロセスを呼び出し] アクティビティで呼び出すことができます。
• UI: Orchestrator のアクティビティから [ジョブを開始 ] によって呼び出された、ユーザー操作を伴うアクティビティによるプロセス。
• 人間参加型 : Orchestrator でのフォーム入力が必要なタスクを介して、ユーザーが操作します。[フォーム タスクを作成] アクティビティと [フォーム タスク完了まで待機し再開] を組み合わせて使用することを意味します。

オーケストレーション プロセス テンプレート

In Studio, go to Home > Orchestration Process to open the template, which contains the default UiPath.Persistence.Activities and UiPath.System.Activities dependencies in a Flowchart workflow type.

The template's project.json file has the supportsPersistence: true parameter, indicating that process execution resumes upon task completion.

The requiresUserInteraction: false parameter indicates this workflow does not contain user interaction activities, similar to a Background Process.

project.json ファイルのパラメーターを手動で変更することはお勧めできません。

A process may be turned into an Orchestration Process from the Project Settings window by setting the Supports Persistence toggle to Yes.

オーケストレーション プロセスのスニペット

作業着手の手がかりとして、[スニペット] パネルには、オーケストレーション プロセスの作成に使用できるワークフロー スニペットが多数用意されています。

オーケストレーション プロセスを構築する

以下の手順に従い、UiPath.Persistence.Activities パッケージのアクティビティ部分を組み合わせ、独自のオーケストレーション プロセスを構築してください。

1. [ キュー アイテムを追加して参照を取得 ] アクティビティを使用して、 in、 in/out 、または out パラメーターでキュー アイテムを追加し、対応するキュー アイテムのオブジェクトを取得します。キュー アイテムが処理されると、このアクティビティが [キュー アイテム完了まで待機し再開] アクティビティと組み合わされている場合、ItemInformationプロパティの引数がマッピングされたワークフロー変数に割り当てられます。

   

2. [ キュー アイテム完了まで待機し再開] アクティビティを [キュー アイテムを追加し参照を取得] アクティビティと組み合わせる必要があります。ワークフローは一時停止ステートになり、プロセスの次のステップに進む前にこのアクティビティで特定のキュー アイテムの完了を待機しているロボットを解放します。

   

3. [ ジョブを開始し参照を取得 ] アクティビティは in、 in/out 、または out型の引数を提供することで、別のプロセスを呼び出します。このアクティビティが [ ジョブ完了まで待機し再開] アクティビティと組み合わされている場合は、実行後、変更された引数はワークフロー変数にマッピングされます。

   

4. [ ジョブ完了まで待機し再開] アクティビティは、[ ジョブを開始し参照を取得 ] と組み合わせる必要があります。後者のアクティビティの出力として取得した Job Object を提供します。これにより、現在のプロセスが一時的に中断され、参照ジョブが完了するまで待機し、参照ジョブがステータスを更新してプロセスを再開します。

   

5. Use the Create Form Task activity to create a task with form-based visualization for human interactions within a workflow. These forms with the relevant workflow context are presented to users for decision-making and other scenarios.

   このアクティビティを使用するには、UiPath.FormActivityLibrary パッケージをインストールする必要があります。

   

6. [フォーム タスク完了まで待機し再開] アクティビティは、この特定のタスクがエンド ユーザーによって完了するまでワークフローを一時停止するための入力として Task Object を提供することによって、[フォーム タスクを作成] と組み合わせる必要があります。

   

7. ワークフローの実行を一時停止し、指定した日時に再開する[時間 差で再開 ] アクティビティを使用します。

8. Studio からワークフローを実行します。ロボットは、実行時間の長いアクティビティを実行するたびに、Studio はリボンで [再開] オプションが有効化された読み取り専用のステートになります。続行するには、基になるタスク、キュー アイテム、またはジョブを完了し、[再開] をクリックします。

ベスト プラクティス

• UiPath.Persistence.Activities パッケージの長期実行アクティビティ (「完了まで待機し再開」系のアクティビティ) の部分は、オーケストレーション プロセスのエントリ ポイント、つまり Main.xaml としてマークされたファイルでのみ使用できます。

• オーケストレーション プロセスから構築された再利用可能なコンポーネントは、別のオーケストレーション プロセス内からしか参照できません。

• A process attached to a queue processing should not be modeled into a long-running workflow. If it must be used, ensure to complete the queue item status using the Set Transaction Status activity before the first persistence point (any Wait and Resume activity).

  注:

  Starting with Orchestrator v2020.10.8, queue items that are part of persistence points can be processed within long-running workflows, so setting the queue item's transaction to a final status (Failed or Successful) is not mandatory anymore. Head over to the Release Notes for more details.

• 永続化ポイント ([待機] および [再開] アクティビティ) は、[繰り返し (コレクションの各要素)] アクティビティの本体内で使用しないでください。これらのアクティビティは最初の繰り返しを実行した後にワークフローを中断しますが、この挙動が意図した挙動と異なることがあるためです。

  代わりに、[並列繰り返し (コレクションの各要素)] などの 永続性アクティビティをループとともに使用する方法を検討してください。ジョブごとの再開トリガーの最大数は、既定で 1,000 に制限されています。

• 長期実行のワークフローは、ジョブを一時停止したロボットと同じ種類 (Unattended または Non-production) で、同じロボット グループまたはフォルダーにあるロボットであれば、どのロボットでも再開できます。したがって、実行に必要なローカル リソースは永続化ポイントの後にも用意する必要があります。

• All variables used in the scope of a long-running activity must be serializable. Types of variables listed in this page are serializable: Text, True or False, Number, Array, Date and Time. Data Table and GenericValue variables.

• 長期実行アクティビティを含まないスコープで使用される変数は、そのスコープ内でワークフローが中断されないため、シリアル化の要件の対象にはなりません。シリアル化不可能なデータ型は、同じワークフロー内の個別のシーケンス スコープで使用することも、他のファイルを呼び出すことによって使用することもできます。ただし、そのデータ型が「待機」系アクティビティと「再開」系アクティビティの間にある場合に限ります。たとえば、「 ジョブ完了まで待機し再開」、「 キュー アイテム完了まで待機し 再開」、「 フォーム タスク完了まで待機し再開」などです。

• Please take into consideration that some properties of objects generated by long-running activities cannot be evaluated in the Locals panel.

• 各ジョブで実行されるアクション数が多いと予期されるワークフローには、適切なバッチ処理を実装してください。ジョブが一度に待機できるアクション数 (または他のジョブ トリガー) の上限は、既定で 1,000 件に設定されています。

  注:

  The Delay and Retry Scope activities are not supported and do not work properly when used in the Main workflow of an Orchestration Process. In such cases, they should be placed inside a No Persist Scope activity.