Maestro 中的 Data Fabric 操作

支持直接从 Maestro 中的 BPMN 任务表达式查询和更新 Data Fabric 记录的查询前缀和输出操作。

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

查询前缀

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

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

表达式语法

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 条匹配记录的 Array。流程可以使用多实例标记或循环对 Array 进行迭代，从而在单个步骤中实现多条 Data Fabric 记录的扇出模式。

备注：

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

输出操作

以 Data Fabric 实体为目标的 BPMN 任务输出支持三种操作。操作将根据是否存在匹配记录，确定输出插入新记录、修改现有记录，还是同时执行这两项操作。

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

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

相关页面

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