Run Job

UiPath.Activities.System.Jobs.RunJob

説明

[ジョブを実行] アクティビティを使用すると、ロボティック プロセス オートメーション (RPA) ワークフローやエージェント プロセスなどの他のオートメーションを容易に開始できます。ワークフローからオートメーションを開始する複数の既存アクティビティが、この 1 つのアクティビティに集約されます。開始するプロジェクトの種類を選択すると、アクティビティの動作が選択内容に応じて調整されます。

重要:

• このアクティビティを設定する前に、Orchestrator フォルダーに選択したオートメーションが存在している必要があります。

• オートメーションを更新したら必ず再パブリッシュし、対応するプロセスを Orchestrator フォルダーに再デプロイしてください。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

Windows、クロスプラットフォームでの設定

• アクティビティの本体のプロパティ
  • Orchestrator フォルダー パス - ワークフロー内から開始するオートメーションがデプロイされている Orchestrator フォルダーを選択します。このドロップダウン メニューには、自分がアクセスできるフォルダーのみが表示されます。オプションを選択しないと、個人用ワークスペースが使用されます。
  • プロセス名 - 実行するオートメーションに関連付けられているプロセスを選択します。すべての種類のプロセス (RPA、エージェント、エージェンティック オーケストレーション) が表示されます。目的のプロセスがリストにない場合は、[プロセスを管理] を選択すると Orchestrator のユーザー フォルダーにリダイレクトされ、不足しているプロセスをそこで追加できます。

  • 入力引数 - 選択したプロセスに入力引数が必要な場合、このフィールドを使用して引数を設定できます。

    [データ マッパー] オプションの使用時にプロセスの引数の最新のリストを取得するには、フィールドの右側にある [引数を更新します。] を選択します。

    重要:

    最適なエクスペリエンスを実現するには、最新バージョンの Studio (2025.0.161) を使用してください。2025.0.161 より前のバージョンの Studio では、[式エディター] ウィンドウを使用します。

    次のコード スニペットは、VB.NET と C# を使用してエージェントの入力引数に値を設定する方法を示しています。

    'VB.NET
    New Email_Rewriter_Input() With {
        .feedback = "sample feedback", 
        .originalEmail = "sample email content"
    }

    //C#
    new Email_Rewriter_Input {
        feedback = "sample feedback",
        originalEmail = "sample email content"
    }

• プロパティ パネル
  • 実行モード - ジョブが完了するまでアクティビティがどのように待機するかを選択します。次のオプションが利用できます。
    • 待機しない - このアクティビティはジョブを開始し、そのジョブの完了を待たずにワークフローを続行できるようにします。
    • ジョブの完了まで待機 - 既定のオプションです。このアクティビティは、開始したジョブが完了するかタイムアウトに達するまで、ワークフローを一時停止します。ジョブが正常に完了すると、このアクティビティはそのジョブの出力を返し、ワークフローを再開します。
      注: この実行モードは、Orchestrator の SignalR 機能を利用して、ジョブの完了をリアルタイムに確認します。テナント レベルの Orchestrator の設定で有効化できます。SignalR が無効化されている場合は、既定で 30 秒のポーリングに設定されます。
    • ジョブ完了まで実行を中断 - このアクティビティはワークフローを一時停止し、出力が得られるまで待機します。
  • タイムアウト - ジョブの完了を待機する最大時間を設定します。既定値は 600,000 ミリ秒 (10 分) です。
  • エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。 このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。その結果、フィールドを設定していない場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

  • ジョブの失敗時に失敗 - このプロパティは、実行モードが [ジョブの完了まで待機] または [ジョブ完了まで実行を中断] の場合にのみ使用できます。

    実行された Orchestrator ジョブが「エラー」ステータスで終了したときに、アクティビティで例外をスローするかどうかを指定します。既定ではオフです。オンに設定すると、Orchestrator のジョブが失敗したときにワークフローの実行が停止し、例外がスローされます。

  • ジョブのデータ - 開始したジョブのオブジェクトを表示します。このデータは自動的に生成されます。

  • 出力引数 - プロセスの作成時に定義された、プロセスの出力引数のリストを表示します。

    プロセス リストからプロセスを選択すると、そのプロセスのすべての出力プロパティが出力オブジェクトに追加されます。

    式を使用してプロセスを指定した場合、または値が返される実行モードを使用している場合は、[静的名を使用] オプションを使用して入力引数と出力引数を設定する必要があります。

既知の制限事項

エージェンティック プロセスで例外がスローされた場合、Maestro は Orchestrator のジョブを [実行中] ステートで維持し、例外が Maestro 内で処理されることを期待します。

その結果、次のような処理が実行されます。

• [ジョブを実行] アクティビティで失敗は検出されません。
• [ジョブの完了まで待機] に設定している場合、次のどちらかになります。
  • タイムアウトする
  • ジョブが [成功] に到達しないため、永続モードで無期限にハングする

この動作を回避するには、[ジョブを実行] アクティビティの [実行モード] に基づいて、以下の推奨事項を使用します。

• [ジョブの完了まで待機] の場合、エージェンティック プロセスの予想実行時間に一致するタイムアウトを適用します。タイムアウトが設定されていない場合、ワークフローはスタックしたままになり、ジョブのステータス変更を待機しますが、この変更は発生しません。
• [ジョブ完了まで実行を中断] を使用します。このモードは、ワークフローが出力を受け取る必要がある場合に最適であるためです。エージェンティック プロセスが完了すると、プロセスは自動的に再開されます。