Consultar Registros de Entidade

Nó de registros de entidade de consulta para ler um ou mais registros de uma entidade do Data Fabric em um fluxo, sem uma conexão com o Integration Service.

Lê um ou mais registros de uma entidade do Data Fabric. Esse é um nó de fluxo nativo — ele não requer uma conexão Integration Service (IS). Funciona com entidades existentes da plataforma Data Fabric — tanto entidades de tenant quanto de pasta — e com entidades definidas em uma solução VS Code. Consulte Entidades no código VS.

Configuração

Campo	Required	Description
Entidade do Data Fabric	Sim	A entidade a ser consultada. Selecione Atualizar esquema se os campos da entidade foram alterados desde que você adicionou o nó.
Registros a retornar	Sim	O registro único retorna um registro e falha se o filtro corresponder a mais de um. Vários registros retorna uma matriz de registros correspondentes.
Condição(ões) de filtro	Não	Uma ou mais condições de campo/operador/valor, combinadas com All (AND) ou Qualquer (OR).
Classificar por (apenas vários registros)	Não	O campo pelo qual classificar os resultados e a direção (Ascendente ou Descendente). Sem uma classificação, a consulta pode retornar um conjunto diferente de registros a cada vez.
Registros a ignorar (apenas vários registros)	Não	Número de registros correspondentes a ignorar antes de retornar resultados. 0Padrão.
Limite de registros (apenas vários registros)	Não	Número máximo de gravações a serem retornadas. Padrão 100, máximo 1000.

Dentro de Filtrar condição(ões), selecione Adicionar condição para outra condição no mesmo nível ou Adicionar grupo para aninhar um grupo de condições com sua própria lógica AND/OR.

Esse nó não é compatível com a aba Tratamento de erros .

Saída

Para o registro único, os campos de saída espelham o esquema da entidade diretamente. Para Registros múltiplos, a saída é uma matriz results , com cada item espelhando o esquema da entidade. Acesse-os posteriormente como $vars.<nodeId>.output.<fieldName> (registro único) ou $vars.<nodeId>.output.results[<index>].<fieldName> (vários registros).

Comportamento de referência em tempo real

A saída é uma referência ativa para a consulta, não uma cópia armazenada dos resultados. Cada expressão, condição ou script que a lê executa novamente a consulta naquele momento para que sempre veja os dados atuais da entidade. O chip Query ao vivo na árvore de esquema marca saídas que se comportam dessa maneira.

Por exemplo, se uma entidade de Consulta registra um nó chamado Find ticket retornar um tíquete cujo status é Open, e um nó posterior no fluxo definir esse tíquete como Closed, uma expressão que lê $vars.Find ticket.output.Status depois desse ponto retorna Closed — não o valor Open que a consulta via primeiro. Uma cópia armazenada ainda diria Open.

Atualizar registro de entidade e Excluir registro de entidade definidos como Referência de entidade com base nisso: eles atuam no registro que essa consulta encontrou, sem especificar novamente a entidade e o filtro.

As coleções de loop e transformação de dados são a exceção. Eles leem um instantâneo dos resultados obtidos quando o nó é executado, em vez de executar novamente a consulta.