Maestro 中的 Data Fabric 操作

Maestro 流程可以直接从 BPMN 任务表达式和输出映射查询和更新Data Fabric记录。此页面记录了受支持的查询前缀和输出操作。

查询前缀

Data Fabric 表达式中的查询前缀按字段值检索记录，而不是按内部记录 ID。支持 2 个前缀：

前缀	全名	返回类型	不匹配行为	多重匹配行为
qes:	单个查询扩展	单个记录	返回空结果	返回错误
qem:	查询扩展倍数	最多包含 1,000 条记录的数组	返回空数组	返回所有匹配的记录

表达式语法

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

示例 — 单个记录查找：

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

示例 — 多记录查找：

datafabric.LoanApplicationCase["qem:Status=Pending"]

何时使用每个前缀

qes:适用于预计只有一个记录的查找。当查询与多条记录匹配时，Maestro 将返回错误，并且工作流停止。如果未找到记录，Maestro 将返回空结果并继续执行。

qem:适用于可能返回多条记录的查询。Maestro 会返回最多包含 1,000 条匹配记录的数组。流程可以使用多实例标记或循环遍历数组，只需一个步骤即可在多个 Data Fabric 记录之间启用扇出模式。

备注：

将表达式从qes:迁移到qem:时，请更新下游变量引用。qes:返回单个记录对象； qem:返回一个数组。

输出操作

针对 Data Fabric 实体的 BPMN 任务输出支持三种操作。该操作根据是否存在匹配的记录来确定输出是插入新记录、修改现有记录还是两者兼而有之。

操作	行为	记录必须存在
create	插入新记录	否
update	修改由记录 ID 标识的现有记录	是
upsert	如果未找到匹配项，则插入新记录；如果找到匹配项，则更新现有记录	否

输出操作在任务属性面板的“输出”部分中配置。有关属性面板的更多信息，请参阅配置属性和数据。

相关页面

• 集成系统和数据
• 在 Maestro 流程中处理文件
• 变量和表达式编辑器
• 配置属性和数据