簡単なプロセスを実装する

概要

Maestro は、ユース ケースに応じて簡単に開始することも、高度な設定で開始することもできます。簡単なプロセスは、入力を受け取る、オートメーションを実行する、結果を返すなど、いくつかのステップが接続されている場合があり、簡単な概念実証や単純な業務フローに最適です。このセクションでは簡単なフローを紹介し、基本に慣れることができるようにします。

このガイドでは、エージェンティック オーケストレーションのコア機能 (モデリング、実装、デバッグ、パブリッシュ、デプロイ、管理) に焦点を当てた簡単なプロセスの実装方法を示します。このプロセスは、他の UiPath 製品との連携には対応していません。Data Fabric、Integration Service、Studio Web、Agents、Action Center のアクション アプリなどの依存関係を設定および実装する手順については、「使い方 – 複雑なプロセス」をご覧ください。

その目的は、次の図のような簡潔なルーティング プロセスを構築することにあります。

プロセスをモデリングする

注:

• Agentic process project configuration is currently tenant-bound. Make sure that you remain in the same tenant between editing sessions.
• Agentic process project configuration currently supports only one business process (.bpmn) file. Although you can add multiple files to the project, this leads to unexpected issues for both debugging and publishing.

まず、エンドツーエンドのプロセスをモデリングしてから、コンポーネントを設定します。

新しい種類の Studio プロジェクトとして、エージェンティック プロセスを作成します。

1. Automation Cloud™ のテナントに移動します。
2. 左側のレールで、製品のリストから [Maestro] を選択します。
3. Maestro のランディング ページで [モデル化を開始] を選択します。新しいエージェンティック プロセスが開きます。
   You can also start by creating a new Agentic Process in Studio Web.
   

   

   
   
4. 右クリックして、プロジェクトの名前を「Simple Process」、プロセスの名前を「Simple Process」に変更します。

   エージェンティック プロセスは、既定でソリューションの一部です。ソリューションについて詳しくは、『Studio Web ユーザー ガイド』をご覧ください。

   
   
   
   
   
5. 開始要素を選択し、ツールボックスから [追加: テキストの注釈] をクリックして、「Input variable path」と入力します。
   
   
   
   
6. 開始要素を選択し、ツールボックスから [追加: 中間イベント] をクリックします。
   
   
   
   
7. ツールバーから [要素を変更] を選択し、[タイマー中間キャッチ イベント] を選択して、中間イベント名に「Delay」と入力します。
   
   
   
   
8. タイマー要素を選択し、ツールボックスから [追加: 排他的ゲートウェイ] をクリックして、ゲートウェイ名に「Which path?」と入力します。
   
   
   
   
9. ゲートウェイを選択して [追加: タスク] をクリックし、名前に「A task」と入力します。
   
   
   
   
   Validation errors are shown in the lower-left corner of the canvas.
   

   

   
   
10. ゲートウェイを再度選択して [追加: タスク] をクリックし、名前に「B task」と入力します。
    
    
    
    
11. ゲートウェイを選択して最初の条件を展開すると、生成された edge_Gateway_{randomcharacters} で始まる名前が表示されます。[ラベル] には「A」と入力します。2 番目の条件を展開し、[ラベル] に「B」と入力します。
    
    
    
    
    
    
    
    
12. ベスト プラクティスは、プロセスに明示的な終了を作成することです。プロセスがたどったパスを素早く特定するには、それぞれに明示的な終了点を作成します。

    A task を選択し、ツールボックスから [追加: 終了イベント] をクリックして、名前に「End A」と入力します。

    
    
    
    
    
13. B task を選択し、ツールボックスから [追加: 終了イベント] をクリックして、名前に「End B」と入力します。
    
    
    
    

おめでとうございます。これで初めての BPMN によるエンドツーエンドのプロセスを作成できました。

今度は、このプロセスにいくつかの機能を追加します。

プロセスを実装する

開始イベント

1. 開始要素を選択し、プロパティ パネルで [名前] に「Manual start」と入力します。[引数] セクションで [新規追加] を選択して、プロセスの開始時に使用できる変数を追加します。
   
   
   
   
2. これらの値で変数を設定し、[保存] をクリックします。出力変数は自動的に作成されます。
   • 名前: path
   • 型: String
   • 値: A
   
   
   
   
   
   
   
   
   
3. 遅延イベントを選択してプロパティ パネルを開き、[タイマー] セクションで [種類] に [時間] を選択し、値の設定で 5 秒に設定します。
   
   
   
   
4. ゲートウェイを選択し、[条件] を展開して [いいえ] と [はい] のパスの条件を入力します。テキスト入力ピッカーで [式エディターを開く] を選択して条件を入力します。
   
   
   
   
5. [変数を挿入] を使用し、Manual start 出力変数 path を見つけて挿入します。
   
   
   
   値を「A」に設定し、[保存] を選択します。
   
   
   
   
6. 条件 B の式エディターを開き、Manual start の出力変数 path を挿入して、値を「B」に設定し、[保存] をクリックします。
   
   
   
   
   または、以下の式をコピーして式エディターに貼り付けることもできます。

   • A

     vars.path == "A"

   • B

     vars.path == "B"

おめでとうございます。これで、最初のプロセスの設定がすべて完了しました。

注:.bpmn ファイルの名前を右クリックすることで、BPMN をダウンロードして他のプロジェクトで使用できます。

プロセスをデバッグする

You can configure breakpoints by hovering over the upper left of an element and selecting Click to add a breakpoint. Currently, breakpoints can only be set once you start debugging a process. However, they are retained between runs. Read about debugging and breakpoints.

全体を通してデバッグする

まず、プロセスをひととおり実行して、設定が正しいことを確認します。path 変数の既定値を「A」に設定すると、A task を経て End A に至ります。

1. [デバッグ] を選択してプロセスをテストします。
   
   
   
   
2. 各ステップがどのように実行されるかを確認します。[実行証跡] セクション、[グローバル変数]/[インシデント] セクションに移動して、詳細を表示します。
3. [デザイン モードに戻る] を選択してデバッグを終了します。

ステップごとにデバッグ

プロセスをステップごとに実行し、path 変数を操作してルート B をテストできるようにします。

1. [ステップごとにデバッグ] を選択します。
   
   
   
   
2. [次のステップ] を選択して、実行をタイマーに移します。
   
   
   
   
3. Manual start イベントのソースの path グローバル変数を「B」に更新します。Enter キーまたは Tab キーを押して、変更をコミットします。
   
   
   
   
4. [1 個の変数を更新] を選択し、ダイアログで [変数を更新] を選択して変更をコミットします。
5. [続行] を選択して実行を終了します。
6. 各ステップがどのように実行されるかを確認します。[実行証跡] セクション、[グローバル変数]/[インシデント] セクションに移動して、詳細を表示します。今回のプロセスは B ルートをたどります。
   
   
   
   
7. [デザイン モードに戻る] を選択してデバッグを終了します。

.

簡単なプロセスをパブリッシュしてデプロイする

1. [パブリッシュ] を選択します。
2. [場所] を選択し、[パブリッシュ] を選択します。
   
   
   
   
3. Read Publishing and upgrading agentic processes for the steps to publish to Orchestrator.

おめでとうございます。これで、最初のプロセスのパブリッシュ、デプロイ、開始が完了しました。

今度は、ランタイム インスタンスの管理です。

業務プロセスを管理する

1. Automation Cloud ポータルから Maestro サービスに移動します。
2. プロセスのリストで [Simple Process] を選択し、そのプロセスの [すべてのインスタンス] ビューを開きます。必要に応じて、検索機能を使用してリストをフィルター処理することもできます。
   
   
   
   
3. 最新のインスタンスを選択してインスタンス ビューアーを開きます。各ステップを通じてプロセスがライブで実行されます (5 秒の遅延タイマーがまだ実行中であるとします)。
   
   
   
   

   モデルのバックグラウンドをクリックして、実行証跡のほか、グローバル変数とアクション履歴を確認します。モデルのノードまたは実行証跡をクリックして、その実行ステップの詳細と変数を検査できます。

   おめでとうございます。これで、最初のプロセスを完全に管理できました。

   では、プロセスを壊して、修正できるようにしましょう。

プロセスを壊して修正する

この手順では、インスタンス管理を使用して回復する目的で、実行を失敗状態にします。

1. Orchestrator に移動し、[マイ ワークスペース] フォルダーの [オートメーション] タブにある [プロセス] リストで [Simple.Process] を見つけます。
2. [Simple.Process] エントリで [ジョブを開始] を選択しますが、今回は壊し始める前に [引数] を編集します。
3. [引数] タブを選択し、path 変数を編集します。値を「C」に設定し、[保存] を選択します。
   
   
   
   
4. [開始] を選択します。
5. Maestro に移動し、プロセスのリストで [Simple Process] を選択して、そのプロセスの [すべてのインスタンス] ビューを開きます。
   
   
   
   
6. Which path? ゲートウェイのステップを選択すると、「ゲートウェイの出力フローがありません。」というエラーが表示されます。これは、path==”C” の設定がない場合に表示されるエラーです。
   
   
   
   
7. 最初のステップのコンテナーまたはモデルのバックグラウンドをクリックして、[グローバル変数] を表示します。
   
   
   
   
8. Manual start の出力 (2 番目の出力) の path 変数を「A」に更新して、フローが設定された条件に従うようにします。
   
   
   
   
9. [1 個の変数を更新] を選択して変数を更新し、監査のためにコメントを追加します。
   
   
   
   
10. [リトライ] を選択してコメントを追加し、[インスタンスをリトライ] を選択して新しい変数でステップをリトライし、インスタンスが完了するのを確認します。
    注: インスタンスが完了したことを確認するには、ページの更新が必要な場合があります。
    
    
    
    
    
11. [アクションの履歴] を調べて、監査証跡の変化を確認します。
    
    
    
    

    おめでとうございます。 これで、破損したインスタンスを正常に修正できました。

プロセスのバージョンを移行する

現在のプロセス フロー ロジックは、すべてのパス シナリオを管理するには堅牢性が不十分です。プロセスの新しいバージョンをパブリッシュすることで、この問題に対処します。更新したバージョンのプロセスによって、新しいプロセス インスタンスに効果的に対応できるだけでなく、問題がある既存のインスタンスも修正できます。path が A と等しくないすべてのシナリオを効果的に処理できるようにするには、B ルートを Not A ルートに変更します。

この手順では、新しいバージョンによる修正を目的として、実行を失敗状態にします。

1. Orchestrator に移動します。
2. [マイ ワークスペース] に移動します。
3. [オートメーション] タブへ移動し、[プロセス] リストで[Simple.Process] を探します。
4. [Simple.Process] エントリで [ジョブを開始] を選択し、[開始] を選択します。
5. [引数] タブを選択し、path 変数を編集します。
6. 値を「C」に設定し、[保存] を選択します。
7. [開始] を選択します。

では、この破損したインスタンスを移行できるようにプロセスを修正します。

1. UiPath Studio で Simple Process を開きます。
2. Which path? ゲートウェイを選択し、プロパティ パネルを開きます。
3. ラベル B を Not A に変更し、条件を vars.path != A に変更します。
   
   
   
   
4. タスク B task の名前を Not A Task に変更します。
5. 終了イベント End B の名前を End Not A に変更します。
6. [パブリッシュ] をクリックし、[Orchestrator 個人用ワークスペース フィード] を選択して [パブリッシュ] をクリックします。

次に、破損したインスタンスを新しいバージョンに移行します。

1. Maestro に移動して [プロセスのインスタンス] を選択し、プロセスのリストで [Simple Process] を選択して、そのプロセスの [すべてのインスタンス] ビューを開きます。
2. 最新のインスタンスをクリックして、インスタンス ビューアーを開きます。プロセスが Which path? ゲートウェイで失敗のステートであることがわかります。
   注: 最新のインスタンスを確認するには、リストの [更新] ボタンをクリックする必要がある場合があります。
3. [移行] を選択し、パブリッシュしたプロセスの [対象バージョン] を選択し (1.0.1 のはずですが、異なる場合があります)、コメントを入力して [インスタンスを移行] を選択します。
   
   
   
   
4. [リトライ] を選択してコメントを追加し、[インスタンスをリトライ] をクリックして新しい変数でステップをリトライし、インスタンスが完了するのを確認します。
   注: インスタンスが完了したことを確認するには、ページの更新が必要な場合があります。
   
   
   
   
   
5. [アクションの履歴] を調べて、監査証跡の変化を確認します。

おめでとうございます。破損したインスタンスをプロセスの新しいバージョンに正常に移行できました。

最終プロセス

最終的なプロセスは次のようになります。