Consultar Vários Registros de Entidade

Envia uma solicitação à API do Data Fabric para consultar registros de uma entidade primária, com expansão opcional para uma entidade secundária por meio de um filtro no nível do campo.

Description

Envia uma solicitação à API do Data Fabric para consultar registros de uma entidade primária, com expansão opcional para uma entidade secundária por meio de um filtro no nível do campo.

Esta atividade é equivalente à atividade de mesmo nome no pacote de atividades clássicas do Data Service.

Compatibilidade do projeto

Windows | Multiplataforma

Fluxos de trabalho compatíveis

Todos os fluxos de trabalho no Studio Desktop e no Studio Web.

Propriedades

• Conexão do UiPath Data Fabric - Selecione a conexão do Data Fabric que você estabeleceu no Integration Service. Acesse o menu suspenso para selecionar, adicionar ou gerenciar conexões.
• Entidade principal - Especifique a entidade principal da qual os registros são recuperados.
• Entidade secundária - Especifique a entidade relacionada a associar com a entidade primária.
• Tipo de junção - Defina o tipo de junção realizada entre as entidades primárias e secundárias.
  • Associação interna — selecione para retornar apenas registros nos quais existem valores correspondentes em ambas as entidades.
  • Junção esquerda — selecione para retornar todos os registros da entidade primária e registros correspondentes da entidade secundária. Se não existir nenhuma correspondência, os campos secundários retornarão nulo.
• Campo de associação de entidade primária - Especifique o campo da entidade primária usada para estabelecer a relação de associação.
• Campo de associação de entidade secundária - Especifique o campo da entidade secundária usada para estabelecer a relação de associação.
• Condições de filtro - defina critérios de filtragem para registros da entidade primária e/ou secundária. O construtor de filtros funciona como aquele em Consultar registros de entidade, e os nomes de campos são extraídos de entidades primárias e secundárias.

O Construtor de filtros fornece um conjunto de operadores que você pode usar para filtrar registros com base nos valores dos campos da entidade. Os operadores disponíveis para um campo dependem do seu tipo de dados.

A tabela a seguir descreve cada operador compatível e os tipos de dados aos quais ele se aplica.

Para os operadores In e Not In , insira os valores como uma lista separada por vírgulas. Os nomes de campos são prefixados com o nome da entidade — por exemplo, o campo Name na entidade Student aparece como Student_Name, e os campos de relacionamento usam a notação pontilhada de Consultar Registros de Entidade. Para retornar apenas registros em que Student_Name é John ou Jane, insira John,Jane.

Operador	Description	Tipos de dados aplicáveis
igual a (=)	Corresponde registros em que o valor do campo é exatamente igual ao valor especificado.	Texto, Número, Sim/Não, Data-Hora, ChoiceSet
Diferente de (!=)	Corresponde registros em que o valor do campo não é igual ao valor especificado.	Texto, Número, Sim/Não, Data-Hora, ChoiceSet
menor que (<)	Corresponde registros em que o valor do campo é menor que o valor especificado. Para campos de data, isso retorna registros com uma data ou hora anterior.	Número, Data-Hora
Menor ou igual a (<=)	Corresponde registros em que o valor do campo é menor ou igual ao valor especificado.	Número, Data-Hora
maior que (>)	Corresponde registros em que o valor do campo é maior que o valor especificado. Para campos de data, isso retorna registros com uma data ou hora posterior.	Número, Data-Hora
Maior que ou igual a (>=)	Corresponde registros em que o valor do campo é maior ou igual ao valor especificado.	Número, Data-Hora
Contém	Corresponde registros em que o valor do campo contém o texto especificado como uma substring.	Texto
Not Contains	Corresponde registros em que o valor do campo não contém o texto especificado.	Texto
Starts With	Corresponde registros em que o valor do campo começa com o texto especificado.	Texto
Ends With	Corresponde registros em que o valor do campo termina com o texto especificado.	Texto
Em	Corresponde registros em que o valor do campo é igual a qualquer valor em uma lista especificada.	Texto, Número, Data-Hora, ChoiceSet
não está em	Corresponde registros em que o valor do campo não é igual a nenhum valor na lista especificada.	Texto, Número, Data-Hora, ChoiceSet
É nulo	Corresponde registros em que o valor do campo é nulo. Esse operador não exige um valor de entrada.	Texto, Número, Sim/Não, Data-Hora, ChoiceSet
Não é nulo	Corresponde registros em que o campo contém um valor não nulo. Esse operador não exige um valor de entrada.	Texto, Número, Sim/Não, Data-Hora, ChoiceSet
é verdadeiro	Corresponde registros em que um campo Sim/Não é Verdadeiro. Esse operador não exige um valor de entrada.	Sim/Não
é falso	Corresponde registros em que um campo Sim/Não é Falso. Esse operador não exige um valor de entrada.	Sim/Não

Opções

• Pular - Especifique o número de registros a serem pulados desde o início.
• Superior - Especifique o número de registros a serem retornados no máximo. A propriedade aceita valores de 1 a 1000. O valor padrão é 100.
• Classificar em ordem crescente — especifique se deve classificar em ordem crescente (true) ou decrescente (false).
• Classificar por campo - Especifique o campo usado para classificar os registros retornados.

Saída

• Consultar vários registros de entidade — retorna uma lista de registros produzidos pela junção das duas entidades selecionadas e aplicação do filtro fornecido. Cada registro contém todos os campos aos quais o chamador tem acesso em ambas as entidades.