脚本任务

	Maestro 中的“脚本”任务用于执行内联 JavaScript，以处理数据，丰富有效负载，应用条件逻辑或转换输入，然后将其传递给流程中的下一个组件。当您希望为 Schema 队列、API 调用、智能体或存储系统准备数据时，此任务特别有用。

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

何时使用“脚本”任务

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

• 您需要转换或重组传入数据。
• 您想验证字段或拒绝无效输入。
• 您需要将多个输入合并到一个对象。
• 您希望在转发之前筛选、清理或重新格式化数据。

注意： Maestro 目前仅在表达式编辑器中支持 JavaScript。

在 Maestro 应用中设置“脚本”任务

1. 从流程工具栏中拖入“脚本”任务节点。
2. 在右侧面板的“输入”部分下添加输入参数。
   输入参数可以是文字值、上下文变量或之前的节点输出（例如，vars.inArg）。
3. 在编辑器中编写脚本：
   • 单击“脚本”下的输入框，然后展开为完整的编辑器视图。
   • JavaScript 表达式必须return一个对象或值，如以下示例所示：

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

4. 使用“输出”部分，将返回对象的输出映射到 Maestro 变量。

测试脚本逻辑

您可以通过单击 fx 图标打开 JS 函数表达式编辑器，以内联方式测试表达式。该编辑器包括：

• 测试输入面板，您可以在其中粘贴输入示例。

• 实时表达式输出面板，用于预览返回对象的外观。

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

“脚本”任务的可用操作

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

• 无

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

• 创建操作应用程序任务

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

• 启动并等待 RPA 工作流

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

• 启动并等待智能体

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

• 启动并等待外部智能体

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

• 启动并等待 API 工作流[预览]

  执行基于 API 的工作流（预览）并等待响应。

• 启动智能体流程

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

• 启动并等待智能体流程

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

• 执行业务规则[预览]

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

• 创建队列项目

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

• 创建并等待队列项目

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

• 执行连接器活动

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

• 等待连接器事件

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

• 执行脚本

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

  
  
  
  
  

要添加额外输出，请选择“新增”，以直接在“脚本”任务中引入新变量。新引入的输出将在后续步骤中提供。

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

要更新现有变量的值，请选择“设置变量值”。

有关任务的更多信息，请访问“BPMN 建模中的任务”。