シンプルなプロセスをモデル化し、実装し、運用します

この例では、プロセスのモデル化、実装、デバッグ、公開、デプロイ、管理を行うための Maestro のコア機能を説明するシンプルなエージェントプロセスを実装します。この単純なプロセスの例では、他の UiPath® 製品は使用しません。

目的は、次の図のような単純なルーティングプロセスを構築することです。

手記： エージェント プロセス プロジェクト構成は、現在テナントにバインドされています。編集セッションの間は必ず同じテナント内にいるようにしてください。

手記： エージェント プロセス プロジェクト構成では、現在、1 つのビジネス プロセス (BPMN) ファイルのみがサポートされています。プロジェクトには複数のファイルを追加できますが、デバッグとパブリッシュの両方で予期しない問題が発生します。

プロセスのモデリング

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

1. Automation Cloud™ のテナントに移動します。
2. 左側のレールで、製品のリストから [Maestro] を選択します。
3. Maestro のランディング ページで、[Get Started] を選択します。
   先端： Studio で新しい エージェントプロセス を作成することから始めることもできます。
   新しいエージェント プロセスが開きます。
4. デザイン インターフェイスの左上隅にある [ 開始] を選択します。
5. プロジェクトの名前を「シンプル プロジェクト」に変更し、プロセスの名前を「シンプル プロセス」に変更します。
   
   

   

   
   
6. プロジェクト エクスプローラーを閉じます。
7. キャンバスで開始イベント要素を選択して、要素ツールバーを表示します。要素ツールバーから [追加: テキスト注釈 ] を選択します。
8. 開始イベント要素を選択し、要素ツールバーから 「追加:中間イベント 」を選択します。
   1. 中間要素をダブルクリックして名前を変更します。名前を 「Delay」に変更します。
      先端： また、画面右側の [ プロパティ] タブから [フィールドに 名前を付け] を選択して、要素の名前を変更することもできます。
   2. [遅延] 中間イベントを [タイマー中間キャッチ イベント] に変更します。
   
   

   

   
   
9. ( 遅延 タイマー中間キャッチ) イベントを選択し、[ Add: Exclusive gateway] (追加: 排他ゲートウェイ) を選択します。
   1. 排他ゲートウェイ に という名前を付けます。
10. [どのパスですか?] を選択します。排他ゲートウェイを選択し、[ 追加: タスク] を選択します。
    1. タスクに A タスクという名前を付けます。
    先端： プロセスを描画して設定すると、検証エラーがキャンバスに表示されます。これらのビジュアリゼーションを非表示にする場合は、右上のツール メニューから [ 検証エラーを非表示 ] を選択します

    
    

    

    
    
11. [どのパスですか?] を選択します。排他ゲートウェイを再度選択し、[ 追加: タスク] を選択します。
    1. タスクに 「B Task」という名前を付けます。
    
    

    

    
    
12. [どのパスですか?] を選択します。専用ゲートウェイです。
    1. [ プロパティ] タブの [ 条件] セクションから、最初の条件を展開します。
       生成される条件の名前は edge_Gateway_{randomcharacters}で始まります。
    2. 最初の条件の [ラベル] フィールドに「A」と入力します。
    3. 2 番目の条件を展開します。
    4. 2 番目の条件の [ラベル] フィールドに「B」と入力します。
    
    

    

    
    
13. タスクを選択し、イベントツールバーから [追加: イベント終了] を選択します。
    1. 終了イベントに End A という名前を付けます。
    先端： ベスト プラクティスとして、プロセスの終わりに明示的な終止符を作成します。プロセスがどの経路をたどったか、そしてそれぞれの明確な終了点をすばやく把握するため。
14. [ B タスク ] を選択し、イベント ツールバーから [ 追加: イベントの終了 ] を選択します。
    1. 終了イベントに End B という名前を付けます。
    
    

    

    
    

プロセスを実装する

「 プロセスをモデル化する 」セクションで作成したプロセスに機能を追加するには、以下の手順に従います。

1. [開始] イベント要素を選択し、名前を [手動開始] に変更します。
2. [ プロパティ] タブの [ 入力] セクションから[新規追加] を選択します。
   
   

   

   
   
3. 次のように新しい変数を作成します。
   • 名前: path
   • Type: String
   • Value: A
   
   

   

   
   
4. [保存] を選択します。
   新しい変数が作成されます。
5. [ 遅延タイマー中間 キャッチ] イベントを選択します。
6. [ プロパティ] タブの [ タイマー] セクションに移動し、次の値を追加します。
   • 種類： 期間
   • 値: 値の設定から 5 秒 を加算します。
   
   

   

   
   
7. [どのパスですか?] を選択します。専用ゲートウェイです。
8. [ プロパティ] タブの [ 条件] セクションから条件を展開します。
9. 最初の条件を設定します。
   1. 最初の条件で [ 式エディターを開く ] を選択します。
      
      

      

      
      
   2. [ 変数を挿入 ] を使用して、[ 手動開始 ] 出力変数 pathを見つけて挿入します。
   3. 値を に設定します "A"。
   4. [保存] を選択します。
   
   

   

   
   
10. 2 番目の条件を設定します。
    1. 2 番目の条件で [ 式エディターを開く ] を選択します。
    2. [ 変数を挿入 ] を使用して、[ 手動開始 ] 出力変数 pathを見つけて挿入します。
    3. 値を に設定します "B"。
    4. [保存] を選択します。
    
    

    

    
    

    先端： または、次の式をコピーして式エディターに貼り付けることもできます。

    • 式 A: vars.path == "A"
    • 式 B: vars.path == "B"

プロセスをデバッグする

まず、プロセスを直接実行して、プロセスが正しく設定されていることを確認します。path 変数の既定値は Aに設定されているため、プロセスはタスク A を経て終了 A に流れます。

要素の左上隅にカーソルを合わせ、[ クリックしてブレークポイントを追加 ] を選択してブレークポイントを設定します。現在、ブレークポイントはプロセスのデバッグを開始した後にのみ設定できます。ただし、実行間では保持されます。

1. [ テスト ] を選択してプロセスをデバッグします。
   
   

   

   
   
   各ステップの実行時にアニメーションが実行されます。ダイアグラムを操作できます。詳しくは、[ 実行証跡 ] タブと [ グローバル変数 ] タブをご覧ください。
   

   

   
   
2. [ デザイン モードに戻る ] を選択してデバッグを終了します。
3. [ ステップ バイ ステップでテスト ] を選択して path 変数を操作し、ルート Bをテストします。
4. [次の手順] を選択して、実行を [遅延タイマー] 中間キャッチ イベントに移動します。
5. [ グローバル変数] タブで、path 変数の[手動開始] の値を[B] に更新します。
   
   

   

   
   

   気を付け： 既知の問題により、デバッグ時に同じ名前の入力変数と出力変数を区別するのに役立つ視覚的なインジケーターはありません。リストに両方が表示される場合は、入力が出力の前に来ます。1 つ目のコンポーネント (入力) を編集する必要があります。出力は編集対象ではありません。出力は null になります。
6. ダイアログ ボックスで [ Update 1 variables ] を選択し、次に [ Update variables] を選択して変更をコミットします。
7. [ 続行 ] を選択して実行を終了します。
   各ステップの実行時にアニメーションが実行されます。ダイアグラムを操作できます。詳しくは、[ 実行証跡 ] タブと [ グローバル変数 ] タブをご覧ください。今回は、プロセスは B ルートをたどります。
   

   

   
   
8. [ デザイン モードに戻る ] を選択してデバッグを終了します。

これで、最初のプロセスが完全にデバッグされました。

プロセスをパブリッシュ、デプロイ、開始する

1. [ 公開 ] を選択して、エージェント プロセスを公開します。
   1. [ 場所] フィールドから [ Orchestrator 個人用ワークスペース フィード] を選択します。
   2. [パブリッシュ] を選択します。
   
   

   

   
   

   手記： Orchestrator 個人用ワークスペース フィードにパブリッシュされたプロセスは自動的にデプロイされますが、テナント フィードまたはフォルダー フィードにパブリッシュされたプロセスは、引き続き別の手順として Orchestrator にデプロイする必要があります。
2. Orchestrator に移動します。
3. [マイ ワークスペース] に移動します。
4. [ オートメーション] タブに移動し、[ プロセス] リストで[Simple.Process] を見つけます。
   
   

   

   
   
5. [Simple.Process] エントリの[ジョブを開始] を選択します。
6. [開始] を選択します。
   
   

   

   
   

これで、最初のプロセスを完全にパブリッシュ、デプロイ、開始できました。

エージェント・プロセスの管理

1. Maestro サービスに移動します。
2. プロセスのリストで [ 単純なプロセス ] を選択して、プロセスの [すべてのインスタンス ] ビューを開きます。
   先端： 必要に応じて、検索フィールドを使用してリストをフィルタリングすることもできます。
3. 最新のインスタンスを選択して、インスタンスビューアーを開きます。
   各ステップでプロセスの実行状況をライブで確認できます。
   

   

   
   

   モデルの背景を選択して、 グローバル変数 と アクション履歴、 および実行証跡を確認します。モデル内のステップまたは実行証跡を選択して、その実行ステップの [詳細 ] と [変数 ] を検査します。

これで、最初のプロセスを完全に管理できました。

プロセスの中断と修正

この手順では、インスタンス管理を使用して回復するために、実行を失敗させます。

1. Orchestrator に移動します。
2. Orchestrator に移動します。
3. [マイ ワークスペース] に移動します。
4. [ オートメーション] タブに移動し、[ プロセス] リストで[Simple.Process] を見つけます。
   
   

   

   
   
5. [Simple.Process] エントリの[ジョブを開始] を選択します。
6. path変数の値を Cに変更します。
   
   

   

   
   
7. [開始] を選択します。
8. Maestroに移動します。
9. プロセスのリストで [ 単純なプロセス ] を選択して、プロセスの [すべてのインスタンス ] ビューを開きます。
10. 最新のインスタンスを選択して、インスタンスビューアーを開きます。
    プロセスは [どのパスですか?] で失敗ステートです。専用ゲートウェイです。
    

    

    
    
    

    

    
    
11. [どのパスですか?] を選択します。排他的ゲートウェイのステップを使用して、 ゲートウェイの送信フローがないという エラーを確認します。
    このエラーは、 に対する設定がないため path == "C"予期されます。
    

    

    
    
12. [Status & Step] パネルから最初のステップを選択して、グローバル変数を表示します。
    
    

    

    
    
13. path 変数の 2 番目の [手動開始] の出力値 (2 行目) を、設定された条件に従うようにAに更新します。
    
    

    

    
    
14. [ Update 1 variables ] を選択して、 変数を更新します。
15. 監査のために [ コメント] フィールドにコメントを追加します。
    
    

    

    
    
16. [ リトライ] を選択します。
17. コメントを追加して [インスタンスを リトライ ] を選択すると、新しい変数を使用してステップをリトライし、インスタンスが完成します。
    
    

    

    
    
18. [ アクションの履歴 ] タブで、監査証跡に変更がないかどうかを確認します。

破損したインスタンスが正常に修正されました。

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

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

この手順では、新しいバージョンで修正するために実行を失敗させます。

1. Orchestrator に移動します。
2. [マイ ワークスペース] に移動します。
3. [ オートメーション] タブに移動し、[ プロセス] リストで[Simple.Process] を見つけます。
4. [Simple.Process] エントリの[ジョブを開始] を選択します。
5. path変数の値を Cに変更します。
   
   

   

   
   
6. [開始] を選択します。
7. Studio に移動して [シンプル プロセス] を開きます。
8. [どのパスですか?] を選択します。専用ゲートウェイです。
9. [ B ] ラベルを [ Not A ] に変更し、条件を [ vars.path != A] に変更します。
   
   

   

   
   
10. [ B タスク ] タスク名を [Not A Task] に変更します。
11. End B end イベントを End Not A に変更します。
12. [ パブリッシュ] を選択してプロジェクトをパブリッシュします。
    1. [ 場所] フィールドから [ Orchestrator 個人用ワークスペース フィード] を選択します。
    2. [パブリッシュ] を選択します。
13. Maestroに移動します。
14. プロセスのリストで [ 単純なプロセス ] を選択して、プロセスの [すべてのインスタンス ] ビューを開きます。
15. 最新のインスタンスを選択して、インスタンスビューアーを開きます。
    プロセスは [どのパスですか?] で失敗ステートです。専用ゲートウェイです。
16. [ 移行 ] を選択してプロセスを移行します。
    1. パブリッシュしたプロセスの [ターゲット バージョン ] を選択します。
       この例のコンテキストでは、 1.0.1 である必要があります。
    2. コメントをお寄せください。
    3. [ インスタンスを移行] を選択します。
    
    

    

    
    
17. [ リトライ ] を選択して、新しい変数でステップをリトライします。
    1. コメントをお寄せください。
    2. [ インスタンスを再試行] を選択します。
    
    

    

    
    
18. [ アクションの履歴 ] タブで、監査証跡に変更がないかどうかを確認します。

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