Operaciones de Data Fabric en Maestro

Los procesos de Maestro pueden consultar y actualizar los registros de Data Fabric directamente desde las expresiones de tareas BPMN y las asignaciones de salida. Esta página documenta los prefijos de consulta y las acciones de salida admitidos.

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: es adecuado para búsquedas en las que se espera exactamente un registro. Cuando la consulta coincide con más de un registro, Maestro devuelve un error y el flujo de trabajo se detiene. Cuando no se encuentra ningún registro, Maestro devuelve un resultado vacío y continúa con la ejecución.

qem: es adecuado para consultas que pueden devolver más de un registro. Maestro devuelve un array de hasta 1000 registros coincidentes. Un proceso puede iterar sobre el array utilizando un marcador multiinstancia o un bucle, lo que permite patrones de distribución (fan-out) en varios registros de Data Fabric en un solo paso.

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 proceso de Maestro
• Editor de expresiones y variables
• Configurar propiedades y datos