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.
• Filter conditions - Define filtering criteria for records from the primary and/or secondary entity. The filter builder works like the one in Query Entity Records, and field names are drawn from both the primary and secondary entities.

The Filter Builder provides a set of operators that you can use to filter records based on the values of entity fields. The operators available for a field depend on its data type.

The following table describes each supported operator and the data types it applies to.

For the In and Not In operators, enter values as a comma-separated list. Field names are prefixed with the entity name — for example, the Name field in the Student entity appears as Student_Name, and relationship fields use the dotted notation from Query Entity Records. To return only records where Student_Name is John or Jane, enter John,Jane.

Operador	Description	Applicable data types
Equals (=)	Matches records where the field value is exactly equal to the specified value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Not Equals (!=)	Matches records where the field value is not equal to the specified value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Less Than (<)	Matches records where the field value is less than the specified value. For date fields, this returns records with an earlier date or time.	Number, Date-Time
Less Than Or Equal (<=)	Matches records where the field value is less than or equal to the specified value.	Number, Date-Time
Greater Than (>)	Matches records where the field value is greater than the specified value. For date fields, this returns records with a later date or time.	Number, Date-Time
Greater Than Or Equal (>=)	Matches records where the field value is greater than or equal to the specified value.	Number, Date-Time
Contém	Matches records where the field value contains the specified text as a substring.	Texto
Not Contains	Matches records where the field value does not contain the specified text.	Texto
Starts With	Matches records where the field value begins with the specified text.	Texto
Ends With	Matches records where the field value ends with the specified text.	Texto
Em	Matches records where the field value is equal to any value in a specified list.	Text, Number, Date-Time, ChoiceSet
Not In	Matches records where the field value is not equal to any value in the specified list.	Text, Number, Date-Time, ChoiceSet
Is Null	Matches records where the field value is null. This operator does not require an input value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Is Not Null	Matches records where the field contains a non-null value. This operator does not require an input value.	Text, Number, Yes/No, Date-Time, ChoiceSet
Is True	Matches records where a Yes/No field is True. This operator does not require an input value.	Sim/Não
Is False	Matches records where a Yes/No field is False. This operator does not require an input value.	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.