脚本任务

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.

使用脚本任务为 Schema 队列、API 调用、智能体或存储系统准备数据。

实施 > 类型：运行内联脚本。

何时使用“脚本”任务

在以下情况下使用“脚本”任务：

• 您需要转换或重组传入数据。

• 您想验证字段或拒绝无效输入。

• 您需要将多个输入合并到一个对象。

• 您希望在转发之前筛选、清理或重新格式化数据。

  备注：

  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 函数表达式编辑器，以内联方式测试表达式。该编辑器包括：

• 测试输入面板，您可以在其中粘贴输入示例。
• 实时表达式输出面板，用于预览返回对象的外观。

将显示 runtime 错误（例如， JSON.parse故障），以帮助您调试。

“脚本”任务的可用操作

“脚本”任务中的“操作”下拉列表用于定义流程应调用的外部执行类型。每个选项都映射到一个特定 UiPath 功能或集成方法。以下是每个选项的简要概述：

• 无

  未为“脚本”任务配置任何实施。

• 创建操作应用程序任务

  在 Action 应用程序中创建任务，以供用户交互，无需等待任务完成。

• 启动并等待 RPA 工作流

  启动已部署的 RPA 工作流（例如 UiPath Studio 项目），等待完成后再继续。

• 启动并等待智能体

  启动 UiPath 智能体（可重用的逻辑块），等待其完成执行。

• 启动并等待外部智能体

  触发在 UiPath 外部托管的智能体（例如 CrewAI、Salesforce 或 ServiceNow），并等待结果。

• 启动并等待 API 工作流

  执行基于 API 的工作流并等待响应。

• 启动智能体流程

  启动基于智能体设计（模块化逻辑）的流程，无需等待完成。

• 启动并等待智能体流程

  启动智能体流程并暂停，直到完成执行。

• 执行业务规则[预览]

  评估业务规则，并在流程中使用评估结果（目前处于预览阶段）。

• 创建队列项目

  将新项目添加到 UiPath 队列中以进行异步处理，无需等待结果。

• 创建并等待队列项目

  将项目添加到队列中，等待处理后再继续。

• 批量添加队列项目

  单批处理中，最多可将 15,000 个项目添加到队列中。

• 删除队列项目

  从队列中移除状态为“新”的项目。

• 延缓事务项目

  将正在进行的事务项目推迟到以后的日期，并将其返回到“新”状态。

• 设置事务进度

  使用 Orchestrator 中可见的自定义状态字符串更新正在进行的事务项目。

• 设置事务状态

  将事务项目的最终状态设置为“成功”或“失败”。

• 执行连接器活动

  运行预配置的 Integration Service 连接器活动（例如 Salesforce 或 Slack）。

• 等待连接器事件

  暂停流程，直到收到来自连接器的特定事件（例如，表单提交或外部触发器）。

• 执行脚本

  在流程中运行简短脚本（JavaScript 或类似脚本），以实现轻量化逻辑或转换。

  

“添加变量”对话框可用于通过指定新变量的名称、类型（例如字符串、数字、布尔值等）和可选默认值来定义新变量。保存后，变量可用于“脚本”任务中的输入、输出或表达式。

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 功能可用性。