スクリプト タスク

Execute inline JavaScript in Maestro Orchestrate Script tasks to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next process component.

The Script Task in Maestro Orchestrate allows you to execute inline JavaScript to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next component in the process.

スクリプト タスクは、スキーマ キュー、API 呼び出し、エージェント、またはストレージ システムのデータを準備する場合に使用します。

[実装] > [種類]: インライン スクリプトを実行します。

スクリプト タスクを使用する状況

スクリプト タスクは、次の場合に使用します。

• 受信データを変換または再構築する必要がある場合。

• フィールドを検証する、または無効な入力を拒否する場合。

• 複数の入力を 1 つのオブジェクトに結合する必要がある場合。

• 転送する前に、データをフィルター処理、削除、または再フォーマットする場合。

  注:

  Maestro Orchestrate currently supports JavaScript only inside the expression editor.

Setting up a Script task in Maestro Orchestrate

1. プロセス ツールバーからスクリプト タスク ノードを追加します (キャンバスにドラッグするか、ダブル選択して中央に挿入します)。
2. 右側のパネルの [入力] セクションに入力引数を追加します。

入力引数には、リテラル値、コンテキスト変数、または前のノード出力 (vars.inArg など) を指定できます。3.エディターでスクリプトを記述します。

• [スクリプト] 入力フィールドを選択し、展開して完全なエディターを表示します。
• 次の例のように、JavaScript の式はオブジェクトまたは値を返す (return) 必要があります。

  return {
    param1: inputString,
    param2: "staticValue"
  };
  

4. Map outputs from the return object into Maestro Orchestrate variables using the Outputs section.

結果

The script task is configured with its inputs, logic, and output mappings. The return object's values are available as Maestro Orchestrate variables for use in subsequent process nodes.

スクリプト ロジックをテストする

fx アイコンを選択して JS 関数式エディターを開くと、式をインラインでテストできます。このエディターには以下が含まれます。

• サンプル入力を貼り付けることができる [テスト入力] パネル。
• 返されるオブジェクトがどのように表示されるかをプレビューするためのリアルタイムの [式の出力] パネル。

デバッグに役立つ実行時エラー (例: JSON.parse エラー) が表示されます。

スクリプト タスクで利用可能なアクション

[スクリプト タスク] の [アクション] ドロップダウンでは、プロセスが呼び出す外部実行の種類を定義できます。各オプションは、UiPath の特定の機能または連携方法にマップされています。各オプションの概要は以下のとおりです。

• なし

  スクリプト タスクの実装は設定されていません。

• アクション アプリ タスクを作成

  タスクの完了を待たずに、ユーザーの操作のためにアクション アプリ内にタスクを作成します。

• RPA ワークフローを開始して待機

  デプロイ済みの RPA ワークフロー (UiPath Studio プロジェクトなど) を開始し、そのワークフローが完了するまで待機してから続行します。

• エージェントを開始して待機

  UiPath エージェント (再利用可能なロジック ブロック) を起動し、その実行が完了するまで待機します。

• 外部エージェントを開始して待機

  UiPath の外部でホストされているエージェント (CrewAI、Salesforce、ServiceNow など) をトリガーし、結果を待機します。

• API ワークフローを開始して待機

  API ベースのワークフローを実行し、応答を待機します。

• エージェンティック プロセスを開始

  エージェンティック設計 (モジュール式ロジック) に基づいてプロセスを開始し、それが終了するのを待機しません。

• エージェンティック プロセスを開始して待機

  エージェンティック プロセスを開始し、実行が完了するまで一時停止します。

• ビジネス ルールを実行 [プレビュー]

  ビジネス ルールを評価し、その結果をプロセスで使用します (現在はプレビュー段階)。

• キュー アイテムを作成

  非同期処理を行うために、新しいアイテムを UiPath のキューに追加し、結果は待機しません。

• キュー アイテムを作成して待機

  アイテムをキューに追加し、処理されるまで待機してから次の処理に進みます。

• キュー アイテムを一括追加

  1 つのバッチで最大 15,000 個のアイテムをキューに追加します。

• キュー アイテムを削除

  [新規] ステータスのアイテムをキューから削除します。

• トランザクション アイテムを延期

  処理中のトランザクション アイテムを後日に延期し、新規ステータスに戻します。

• トランザクションの進行状況を設定

  処理中のトランザクション アイテムを、Orchestrator に表示されるカスタムのステータス文字列で更新します。

• トランザクションのステータスを設定

  トランザクション アイテムの最終ステートを [成功] または [失敗] に設定します。

• コネクタ アクティビティを実行

  事前設定された Integration Service コネクタ アクティビティ (例: Salesforce または Slack) を実行します。

• コネクタ イベントを待機

  コネクタから特定のイベント (フォームの送信や外部トリガーなど) を受信するまで、プロセスを一時停止します。

• スクリプトを実行

  プロセス中に、軽量なロジックや変換を行う短いスクリプト (JavaScript または同様のスクリプト) を実行します。

  

[変数を追加] ダイアログでは、変数の名前、型 (String、Number、Boolean など)、およびオプションの既定値を指定して、新しい変数を定義できます。保存すると、その変数は、スクリプト タスク内の入力、出力、または式で使用できるようになります。

Autopilot でのスクリプト タスクのサポート

The JS Function Expression editor includes Autopilot for Maestro Orchestrate assistance that helps you write and refine JavaScript expressions directly in Script tasks. You can describe the logic you need in plain language, and Autopilot generates a function that you can review, edit, and test in place. The editor shows a live preview of the expression output and lets you insert variables from your workflow, so you can build and validate custom logic without leaving the canvas.

各キュー アクションの必須フィールドと動作については、「 キュー タスク アクティビティ」をご覧ください。

タスクについて詳しくは、「BPMN モデリングのタスク」をご覧ください。

注:

エージェントの連携と API ワークフローにアクセスできるかどうかは、使用するクラウド サービスによって異なります。詳しくは、「 利用可能な Maestro Orchestrate 機能」をご覧ください。