Consultar Registros de Entidade

Configure the Query entity records node to read Data Fabric records, and read its output in later nodes.

Lê um ou mais registros de uma entidade do Data Fabric. Esse é um nó nativo. Não precisa de uma conexão. Ele funciona com entidades existentes da plataforma Data Fabric, onde quer que sejam armazenadas, e com entidades definidas em uma solução VS Code. Entidades no Código VS: como definir uma entidade em uma solução de 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 de trabalho 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.

Próximas Etapas

• Nós de entidade do Data Fabric: os outros nós de registro de entidade.
• Referência de nó: cada nó e como configurá-lo.
• Comunidade: faça perguntas e compartilhe fluxos de trabalho com outros construtores no Fórum da UiPath.