Maestro ユーザーガイド

最終更新日時 2025年11月7日

スクリプトタスク

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

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

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

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

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

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

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

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

プロセスツールバーからスクリプトタスクノードをドラッグします。
右側のパネルの [入力] セクションに入力引数を追加します。
入力引数には、リテラル値、コンテキスト変数、または前のノード出力 (vars.inArg など) を指定できます。
エディターでスクリプトを記述します。
- [スクリプト] の下の入力ボックスをクリックし、エディターの全画面表示に展開します。
- 次の例のように、JavaScript の式はオブジェクトまたは値を返す (return) 必要があります。
```
return {
  param1: inputString,
  param2: "staticValue"
};return {
  param1: inputString,
  param2: "staticValue"
};
```
[出力] セクションを使用して、返されるオブジェクトからの出力を Maestro 変数にマッピングします。

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

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

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

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

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

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

None
スクリプトタスクの実装は設定されていません。
アクションアプリタスクを作成
タスクの完了を待たずに、ユーザーの操作のためにアクションアプリ内にタスクを作成します。
RPA ワークフローを開始して待機
デプロイ済みの RPA ワークフロー (UiPath Studio プロジェクトなど) を開始し、そのワークフローが完了するまで待機してから続行します。
エージェントを開始して待機
UiPath エージェント (再利用可能なロジックブロック) を起動し、その実行が完了するまで待機します。
外部エージェントを開始して待機
UiPath の外部でホストされているエージェント (CrewAI、Salesforce、ServiceNow など) をトリガーし、結果を待機します。
API ワークフローを開始して待機 [プレビュー]
API ベースのワークフロー (プレビュー) を実行し、応答を待機します。
エージェンティックプロセスを開始
エージェンティック設計 (モジュール式ロジック) に基づいてプロセスを開始し、それが終了するのを待機しません。
エージェンティックプロセスを開始して待機
エージェンティックプロセスを開始し、実行が完了するまで一時停止します。
ビジネスルールを実行 [プレビュー]
ビジネスルールを評価し、その結果をプロセスで使用します (現在はプレビュー段階)。
キューアイテムを作成
非同期処理を行うために、新しいアイテムを UiPath のキューに追加し、結果は待機しません。
キューアイテムを作成して待機
アイテムをキューに追加し、処理されるまで待機してから次の処理に進みます。
コネクタアクティビティを実行
事前設定された Integration Service コネクタアクティビティ (例: Salesforce または Slack) を実行します。
コネクタイベントを待機
コネクタから特定のイベント (フォームの送信や外部トリガーなど) を受信するまで、プロセスを一時停止します。
スクリプトを実行
プロセス中に、軽量なロジックや変換を行う短いスクリプト (JavaScript または同様のスクリプト) を実行します。