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.
C_OBJECT($employees1;$employees2;$result)
$employees1:=ds.Employee.query("lastName = :1";"H@")
$employees2:=ds.Employee.query("firstName = :1";"C@")
$result:=$employees1.or($employees2)
C_OBJECT($employees;$employee;$result)
$employees:=ds.Employee.query("lastName = :1";"H@")
$employee:=ds.Employee.get(686)
$result:=$employees.or($employee)