Operaciones de Data Fabric

Supported query prefixes and output actions for querying and updating Data Fabric records directly from BPMN task expressions in Maestro Orchestrate.

Maestro Orchestrate processes can query and update Data Fabric records directly from BPMN task expressions and output mappings. This page documents the supported query prefixes and output actions.

Prefijos de consulta

Un prefijo de consulta de una expresión de Data Fabric recupera los registros por valor de campo en lugar de por ID de registro interno. Se admiten dos prefijos:

Prefijo	Nombre completo	Tipo de retorno	Comportamiento sin coincidencia	Comportamiento de coincidencias múltiples
qes:	Expansión de consultas única	Registro único	Devuelve un resultado vacío	Devuelve un error
qem:	Expansión de consulta múltiple	Array de hasta 1000 registros	Devuelve un array vacío	Devuelve todos los registros coincidentes

Sintaxis de expresión

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

Ejemplo: búsqueda de un solo registro:

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

Ejemplo: búsqueda de varios registros:

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

Cuándo utilizar cada prefijo

qes: is suited for lookups where exactly one record is expected. When the query matches more than one record, Maestro Orchestrate returns an error and the workflow stops. When no record is found, Maestro Orchestrate returns an empty result and continues execution.

qem: is suited for queries that may return more than one record. Maestro Orchestrate returns an array of up to 1,000 matching records. A process can iterate over the array using a multi-instance marker or a loop, enabling fan-out patterns across multiple Data Fabric records in a single step.

Nota:

Al migrar expresiones de qes: a qem:, actualiza las referencias de variables posteriores. qes: devuelve un solo objeto de registro; qem: devuelve un array.

Acciones de salida

Las salidas de la tarea BPMN que tienen como destino una entidad de Data Fabric admiten tres acciones. La acción determina si la salida inserta un registro nuevo, modifica uno existente o hace ambas cosas, dependiendo de si existe un registro coincidente.

Acción	Comportamiento	El registro debe existir
create	Inserta un nuevo registro.	No
update	Modifica un registro existente identificado por su ID de registro	Sí
upsert	Inserta un nuevo registro si no se encuentra coincidencia; actualiza el registro existente si se encuentra una coincidencia	No

La acción de salida se configura en la sección Salida del panel de propiedades de la tarea. Para obtener más información sobre el panel de propiedades, consulta Configurar propiedades y datos.

Páginas relacionadas

• Integrar sistemas y datos
• Trabajar con archivos en procesos de Maestro Orchestrate
• Editor de expresiones y variables
• Configurar propiedades y datos