entitySelection.or()

Home

4D v19.8


entitySelection.or() ( entity \| entitySelection ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
entity \| entitySelection	Entity, EntitySelection	Vereinigungsmenge aus Entity und Entity-Selection
Funktionsergebnis	EntitySelection	Neue Entity-Selection oder neue Referenz zur ursprünglichen Entity-Selection

Beschreibung

Die Methode entitySelection.or() kombiniert die Entity-Selection mit dem Parameter entity oder entitySelection über den logischen (nicht ausschließlichen) Operator OR; Sie gibt eine neue unsortierte Entity-Selection zurück mit allen Entities aus der Entity-Selection und dem Parameter.

Mit dem Parameter entity vergleichen Sie diese Entity mit der Entity-Selection. Gehört die Entity zur Entity-Selection, wird eine neue Referenz zur Entity-Selection zurückgegeben. Sonst wird eine neue Entity-Selection mit der ursprünglichen Entity-Selection und der Entity zurückgegeben.
Mit dem Parameter entitySelection vergleichen Sie Entity-Selections. Eine neue Entity-Selection mit den Entities aus der ursprünglichen Entity-Selection oder entitySelection wird zurückgegeben. OR ist nicht ausschließlich, d.h. heißt Entities, auf die in beiden Selections verwiesen wird, werden nicht doppelt angezeigt.

Hinweis: Sie können sortierte bzw. unsortierte Entity-Selections vergleichen. Die resultierende Selection ist immer unsortiert. Weitere Informationen dazu finden Sie im Abschnitt Sortierte vs unsortierte Entity-Selections des 4D Developer Guide.

Sind die ursprüngliche Entity-Selection und der Parameter entitySelection leer, wird eine leere Entity-Selection zurückgegeben. Ist die ursprüngliche Entity-Selection leer, wird eine Referenz auf entitySelection oder eine Entity-Selection nur mit entity zurückgegeben.
Ist entitySelection leer oder ist entity Null, wird eine neue Referenz auf die ursprüngliche Entity-Selection zurückgegeben.

Sind die ursprüngliche Entity-Selection und der Parameter nicht mit derselben Dataclass verknüpft, wird ein Fehler generiert.

Beispiel 1

 C_OBJECT($employees1;$employees2;$result)

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

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

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

Beispiel 2

 C_OBJECT($employees;$employee;$result)

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

 $employee:=ds.Employee.get(686) //Die Entity mit Primärschlüssel 686 gehört nicht zur Entity-Selection $employees

  //Sie passt zur Angestellten "Mary Smith"

 

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

Siehe auch

entitySelection.and( )
UNION