entitySelection.or( )

4D v19.8


entitySelection.or ( entidad \| entitySelection ) -> Resultado

Parámetro	Tipo	Descripción
entidad \| entitySelection	Entity, EntitySelection	Entidad o entity selection a intersectar con
Resultado	EntitySelection	Nueva entity selection o nueva referencia a la entity selection original

Descripción

El método entitySelection.or( ) combina la entity selection con el parámetro entidad o entitySelection utilizando el operador lógico (no exclusivo) OR; devuelve una nueva entity selection desordenada que contiene todas las entidades de la entity selection y el parámetro.

Si pasa entidad como parámetro, compara esta entidad con la entity selection. Si la entidad pertenece a la entity selection, se devuelve una nueva referencia a la entity selection. De lo contrario, se devuelve una nueva entity selection que contiene la entity selection original y la entidad.
Si pasa entitySelection como parámetro, compara las entity selections. Se devuelve una nueva entity selection que contiene las entidades que pertenecen a la entity selection original o entitySelection (o no es exclusiva, las entidades a las que se hace referencia en ambas selecciones no se duplican en la selección resultante).

Nota: puede comparar entity selections ordenadas y/o no ordenadas. La selección resultante siempre está desordenada. Para más información, consulte el párrafo Ordenadas vs No ordenadas en la Guía del desarrollador 4D.

Si la entity selection original y el parámetro entitySelection están vacíos, se devuelve una entity selection vacía. Si la entity selection original está vacía, se devuelve una referencia a entitySelection o se devuelve una entity selection que contiene solo la entidad.
Si entitySelection está vacía o si entidad es Null, se devuelve una nueva referencia a la entity selection original.

Si la entity selection original y el parámetro no están relacionados con la misma dataclass, se genera un error.

Ejemplo 1

 C_OBJECT($employees1;$employees2;$result)

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

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

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

Ejemplo 2

 C_OBJECT($employees;$employee;$result)

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

 $employee:=ds.Employee.get(686) //la entidad con llave primaria 686 no pertenece a la entity selection $employees

  //Coincide el empleado "Mary Smith"

 

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

Ver también

entitySelection.and( )
UNION