#Consultar Dados

Use este nó para consultar e recuperar registros de dados de uma coleção que atendam a condições específicas.

Você pode configurar para consultar um único registro ou múltiplos registros. O resultado da consulta pode ser usado como uma variável em nós subsequentes. Ao consultar múltiplos registros, o resultado é um array. Se o resultado da consulta estiver vazio, você pode escolher se deseja continuar executando os nós seguintes.

#Criar Nó

Na interface de configuração do fluxo de trabalho, clique no botão de adição (“+”) no fluxo para adicionar um nó de “Consultar Dados”:

#Configuração do Nó

#Coleção

Selecione a coleção da qual você deseja consultar os dados.

#Tipo de Resultado

O tipo de resultado é dividido em “Registro Único” e “Múltiplos Registros”:

• Registro Único: O resultado é um objeto, que corresponde apenas ao primeiro registro encontrado, ou null.
• Múltiplos Registros: O resultado será um array contendo os registros que correspondem às condições. Se nenhum registro for encontrado, será um array vazio. Você pode processá-los um por um usando um nó de Loop.

#Condições de Filtro

Semelhante às condições de filtro em uma consulta de coleção comum, você pode usar as variáveis de contexto do fluxo de trabalho.

#Ordenação

Ao consultar um ou mais registros, você pode usar regras de ordenação para controlar o resultado desejado. Por exemplo, para consultar o registro mais recente, você pode ordenar pelo campo “Data de Criação” em ordem decrescente.

#Paginação

Quando o conjunto de resultados pode ser muito grande, você pode usar a paginação para controlar a quantidade de resultados da consulta. Por exemplo, para consultar os 10 registros mais recentes, você pode ordenar pelo campo “Data de Criação” em ordem decrescente e, em seguida, configurar a paginação para 1 página com 10 registros.

#Tratamento de Resultados Vazios

No modo de registro único, se nenhum dado atender às condições, o resultado da consulta será null. No modo de múltiplos registros, será um array vazio ([]). Você pode escolher se deseja marcar a opção “Sair do fluxo de trabalho quando o resultado da consulta estiver vazio”. Se marcada, e o resultado da consulta for vazio, os nós subsequentes não serão executados e o fluxo de trabalho será encerrado antecipadamente com status de falha.