entitySelection.or( )

4D v19.8


entitySelection.or ( entidade\|seleçãoEntidade ) -> Resultado

Parâmetro	Tipo	Descrição
entidade\|seleçãoEntidade	Entity, EntitySelection	Entidade ou seleção de entidade a ser intersectada
Resultado	EntitySelection	Nova seleção de entidade ou nova referência à seleção de entidade original

Descrição

O método entitySelection.or( ) combina a seleção de entidade com os parâmetros entidade ou selecaoEntidade usando o operador lógico OR (não exclusivo); retorna uma nova seleção de entidade não ordenada que contém todas as entidades da seleção de entidades e o parâmetro.

Se passar entidade como parâmetro, se compara a entidade com a seleção de entidade. Se a entidade pertencer à seleção de entidade, uma nova referência à seleção de entidade é retornada. Senão, uma nova seleção de entidade que contenha tanto a seleção de entidade original quanto a entidade original será retornada. .
Se passar entitySelection como parâmetro, se compara as seleções de entidade. Uma nova seleção de entidade é retornada, que contém as entidades que pertencem à entidade original ou entitySelection (OR é não exclusivo, as entidades referenciadas em duas seleções não são duplicadas na seleção resultante).

Nota: Pode-se comparar seleções de entidade ordenadas ou não rodenadas. A seleção resultante é sempre não ordenada. Para saber mais, veja o parágrafo Entity selections Ordenadas vs não ordenadas em 4D Developer Guide.

se a seleção de entidade original e o parâmetro entitySelection estiverem vazios, uma seleção de entidade vazia é retornada. Se a entidade de seleção original estiver vazia, uma referência a entitySelection ou a uma seleção de entidade que contém apenas entity será retornada.
Se entitySelection estiver vazia ou se entity for Null, uma nova referência à seleção de entidade original será retornada.

Se a seleção de entidade original e o parâmetro não forem relacionados à mesma dataclass, um erro é retornado

Exemplo 1

 C_OBJECT($employees1;$employees2;$result)

 $employees1:=ds.Employee.query("lastName = :1";"H@") //Retorna "Colin Hetrick","Grady Harness"

 $employees2:=ds.Employee.query("firstName = :1";"C@") //Retorna "Colin Hetrick", "Cath Kidston"

 $result:=$employees1.or($employees2) //$result contém "Colin Hetrick", "Grady Harness","Cath Kidston"

Exemplo 2

 C_OBJECT($employees;$employee;$result)

 $employees:=ds.Employee.query("lastName = :1";"H@") // Retorna "Colin Hetrick","Grady Harness", "Sherlock Holmes"

 $employee:=ds.Employee.get(686) //a entidade com a chave primária 686 não pertence a seleção de entidade  $employees

  //corresponde ao funcionário "Mary Smith"

 

 $result:=$employees.or($employee) //$result contém "Colin Hetrick", "Grady Harness", "Sherlock Holmes", "Mary Smith"

Ver também

entitySelection.and( )
UNION