Operaciones de Data Fabric en Maestro

Los procesos de Maestro pueden consultar y actualizar 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 compatibles.

Prefijos de consulta

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

Prefijo	Nombre completo	Tipo de valor devuelto	Comportamiento de no coincidencia	Comportamiento de coincidencia múltiple
qes:	Consulta única de expansión	Registro único	Devuelve un resultado vacío	Devuelve un error
qem:	Múltiple de expansión de consultas	Matriz de hasta 1000 registros	Devuelve una matriz vacía	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 la ejecución.

qem: es adecuado para consultas que pueden devolver más de un registro. Maestro devuelve una matriz de hasta 1000 registros coincidentes. Un proceso puede iterar sobre la matriz utilizando un marcador de instancias múltiples o un bucle, lo que permite patrones de distribución 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 único objeto de registro; qem: devuelve una matriz.

Acciones de salida

Las salidas de tareas BPMN que se dirigen a una entidad de Data Fabric admiten tres acciones. La acción determina si la salida inserta un nuevo registro, 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 ID de registro	Sí
upsert	Inserta un nuevo registro si no se encuentra ninguna 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