maestro
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white

Maestro 用户指南

上次更新日期 2026年3月13日

变量和表达式编辑器

使用“属性”面板输入字段旁边的调整选取器,在文本、变量和表达式之间切换。

文本、变量、表达式

  • 使用变量 - 选择现有变量或元素输出值
  • 打开表达式编辑器 - 构建复杂表达式
  • 使用 JSON 编辑器 - 使用 JSON 编辑器创建输入或输出
  • 使用日期时间 - 使用日期时间选取器
  • 使用 Data Fabric - 使用 Data Fabric 实体中的属性

使用“文本构建器 (Text builder)”提供自由格式的文本条目。

Data Fabric 附件

变量

使用变量配置元素属性,并在元素、自动化、智能体、应用任务和连接之间传递值。元素输出可以自动在整个流程中作为变量使用。

打开“变量”选择面板,以选择变量、参数或属性。使用“验证表达式”面板右上角的“测试”按钮,提供并测试值。测试输入值仅用于验证表达式是否准确。它们的功能是确保表达式正确运行,并根据提供的输入产生预期输出。

属性 - 变量下拉列表

提示:

The variable picker includes outputs from tasks within collapsed subprocesses.

You can reference subprocess variables directly regardless of whether the subprocess is displayed in collapsed or expanded view, making it easier to work with modular process designs.

备注:

重命名变量时,系统会更新其基础 ID 以匹配新名称。引用旧 ID 的表达式将在重命名后中断。

使用“修复变量”对话框识别和更新整个流程中损坏的引用。

Expression editor

使用表达式编辑器编写更复杂的表达式,以配置元素属性。表达式编辑器可用于大多数元素属性,具有变量、参数、方法、属性、对象或关键字的智能代码补全功能。您可以编写表达式并使用 Ctrl + Space 查看可用选项列表。

使用表达式编辑器底部的文本栏描述表达式,并可获得 Autopilot™ 的即时帮助。

在您保存表达式时和执行期间,Maestro 会验证表达式,并针对无效语法或未定义的变量引用显示警告。如果出现警告,请打开表达式编辑器并更正语法或更新变量引用。

警告:

不推荐使用 C# 表达式。迁移到 JavaScript 表达式。

有关迁移指南,请参阅从 C# 转换为 JavaScript 表达式

表达式编辑器

JSON 编辑器

首先在“变量”视图中添加一个原始 JSON 对象,以定义您的输入有效负载。添加后,切换到 JSON 编辑器,以结构化格式探索数据并与其交互。此视图会自动组织嵌套对象和数组,便于您轻松检查、展开和引用特定值。用于验证数据的形态,将字段映射到表达式,或为下游组件提供清晰、精确的输入。

docs image

docs image

日期和时间选取器

使用日期和时间选取器捕获自动化流中的详细计划信息。此组件可用于以标准化格式定义日期和时间值,适用于为提交内容添加时间戳,设置截止时间或计划下游活动。您可以手动输入值,或使用日历和时钟控件进行快速选择,以保持一致性并减少格式错误。

日期时间选取器

添加变量

数据结构编辑器

按照以下步骤为流程配置数据集成:

  1. 打开 Data Fabric 编辑器

  2. 从下拉列表中选择一个实体,然后使用唯一标识符(例如 ID 或键)指定记录匹配

  3. 选择适当的字段,以检索或更新特定数据点。这些输入决定了流程中数据交互的范围。

    Data Fabric 编辑器

按字段值查询 Data Fabric 实体

使用qes:前缀语法,按字段值而不是按内部记录 ID 查找 Data Fabric 实体:

datafabric.EntityName["qes:FieldName=Value"].FieldToRead
datafabric.EntityName["qes:FieldName=Value"].FieldToRead

例如:datafabric.LoanApplicationCase["qes:CaseId=HL-999"].LoanAmount

当您知道有业务意义的字段值,但没有内部记录 ID 时,请使用此语法。qes:语法仅支持等于运算符。

将活动输出写回 Data Fabric

活动输出可以使用target属性语法直接以 Data Fabric 实体为目标:

target="=datafabric.EntityName[...]"
target="=datafabric.EntityName[...]"

活动完成后,Maestro 会自动将输出值写回实体,而无需任何其他配置步骤。

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新