Consultar los registros de la entidad

Nodo de registros de entidad de consulta para leer uno o más registros de una entidad de Data Fabric en un flujo, sin una conexión de Integration Service.

Lee uno o más registros de una entidad de Data Fabric. Este es un nodo de flujo nativo: no requiere una conexión de Integration Service (IS). Funciona con entidades existentes de la plataforma Data Fabric, tanto entidades de tenant como de carpeta, y con entidades definidas en una solución de VS Code. Consulta Entidades en VS Code.

Configuración

Campo	Obligatorio	Descripción
Entidad de Data Fabric	Sí	La entidad a consultar. Selecciona Actualizar esquema si los campos de la entidad han cambiado desde que añadiste el nodo.
Registros para devolver	Sí	Registro único devuelve un registro y falla si el filtro coincide con más de uno. Múltiples registros devuelve una matriz de registros coincidentes.
Filtrar condiciones	No	Una o más condiciones de campo/operador/valor, combinadas con Todos (Y) o Cualquiera (O).
Ordenar por (solo varios registros)	No	El campo por el que ordenar los resultados y la dirección (Ascendente o Descendente). Sin una ordenación, la consulta puede devolver un conjunto diferente de registros cada vez.
Registros a omitir (solo varios registros)	No	Número de registros coincidentes que se omitirán antes de devolver resultados. Predeterminado 0.
Límite de registros (solo registros múltiples)	No	Número máximo de registros que se devolverán. Predeterminado 100, máximo 1000.

Dentro de Filtrar condición(es), selecciona Añadir condición para otra condición en el mismo nivel, o Añadir grupo para anidar un grupo de condiciones con su propia lógica Y/O.

Este nodo no admite la pestaña Gestión de errores .

Salida

Para Registro único, los campos de salida reflejan directamente el esquema de la entidad. Para Múltiples registros, la salida es una matriz results , con cada elemento reflejando el esquema de la entidad. Accede a ellos en sentido descendente como $vars.<nodeId>.output.<fieldName> (registro único) o $vars.<nodeId>.output.results[<index>].<fieldName> (varios registros).

Comportamiento de referencia en vivo

La salida es una referencia activa a la consulta, no una copia almacenada de los resultados. Cada expresión, condición o script que la lee vuelve a ejecutar la consulta en ese momento, por lo que siempre ve los datos actuales de la entidad. El chip CONSULTA ACTIVA en el árbol del esquema marca las salidas que se comportan de esta manera.

Por ejemplo, si una entidad de consulta registra el nodo llamado Buscar ticket devuelve un ticket cuyo estado es Open, y un nodo posterior en el flujo establece ese ticket en Closed, una expresión que diga $vars.Find ticket.output.Status después de ese punto devuelve Closed — no el valor Open que vio la consulta primero. Una copia almacenada seguiría diciendo Open.

Actualizar registro de entidad y Eliminar registro de entidad establecidos en Referencia de entidad : actúan sobre el registro encontrado por esta consulta, sin volver a especificar la entidad y el filtro.

Las colecciones de bucles y transformación de datos son la excepción. Leen una instantánea de los resultados tomados cuando se ejecuta el nodo, en lugar de volver a ejecutar la consulta.