Maestro ユーザーガイド

最終更新日時 2025年12月30日

スクリプトタスク

Maestro のスクリプトタスクを使用すると、インライン JavaScript を実行して、プロセスの次のコンポーネントに渡す前に、データの操作、ペイロードの強化、条件ロジックの適用、入力の変換を行うことができます。これは、スキーマキュー、API 呼び出し、エージェント、またはストレージシステムのデータを準備する場合に特に便利です。

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

スクリプトタスクを設定する

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

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

受信データを変換または再構築する必要がある場合。
フィールドを検証する、または無効な入力を拒否する場合。
複数の入力を 1 つのオブジェクトに結合する必要がある場合。
転送する前に、データをフィルター処理、削除、または再フォーマットする場合。

注:
Maestro は現在、式エディター内でのみ JavaScript をサポートしています。

Maestro でスクリプトタスクを設定する

プロセスツールバーからスクリプトタスクノードをドラッグします。
右側のパネルの [入力] セクションに入力引数を追加します。

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

[スクリプト] の下の入力ボックスをクリックし、エディターの全画面表示に展開します。
次の例のように、JavaScript の式はオブジェクトまたは値を返す (return) 必要があります。
```
return {
  param1: inputString,
  param2: "staticValue"
};
return {
  param1: inputString,
  param2: "staticValue"
};
```

[出力] セクションを使用して、返されるオブジェクトからの出力を Maestro 変数にマッピングします。

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

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

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

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

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

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

None

スクリプトタスクの実装は設定されていません。
アクションアプリタスクを作成

タスクの完了を待たずに、ユーザーの操作のためにアクションアプリ内にタスクを作成します。
RPA ワークフローを開始して待機

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

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

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

API ベースのワークフローを実行し、応答を待機します。
エージェンティックプロセスを開始

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

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

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

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

アイテムをキューに追加し、処理されるまで待機してから次の処理に進みます。
コネクタアクティビティを実行

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

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

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