entitySelection.or( )

4D v17.4

Description

La méthode entitySelection.or( ) combine la sélection d'entités avec le paramètre entity ou entitySelection en utilisant l'opérateur OU logique (non exclusif) ; elle retourne une nouvelle sélection d'entités non ordonnée contenant toutes les entités de la sélection d'entités et le paramètre.

Si vous passez entity en paramètre, vous comparez cette entité avec la sélection d'entités. Si l'entité appartient à la sélection d'entités, une nouvelle référence à la sélection d'entités est renvoyée. Sinon, une nouvelle sélection d'entités contenant la sélection d'entités d'origine et l'entité est renvoyée.
Si vous passez entitySelection en paramètre, vous comparez des sélections d'entités. Une nouvelle sélection d'entités contenant les entités appartenant à la sélection d'entités d'origine ou à entitySelection est renvoyée (OU n'est pas exclusif, les entités référencées dans les deux sélections ne sont pas dupliquées dans la sélection résultante).

Note : Vous pouvez comparer des sélections d'entités ordonnées et / ou non ordonnées. La sélection résultante est toujours non ordonnée. Pour plus d'informations, reportez-vous au paragraphe Sélections d'entités triées vs Sélections d'entités non-triées dans le Guide du développeur 4D.

Si la sélection d'entités d'origine et le paramètre entitySelection sont vides, une sélection d'entités vide est renvoyée. Si la sélection d'entités d'origine est vide, une référence à entitySelection ou une sélection d'entités contenant uniquement entity est retournée.
Si entitySelection est vide ou si entity est Null, une nouvelle référence à la sélection d'entités d'origine est renvoyée.

Si la sélection d'entités d'origine et le paramètre ne sont pas liés à la même dataclass, une erreur est générée.

Exemple 1

 C_OBJET($employees1;$employees2;$result)

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

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

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

Exemple 2

 C_OBJET($employees;$employee;$result)

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

 $employee:=ds.Employee.get(686) //l'entité avec clé primaire 686 n'appartient pas à la sélection d'entités $employees

  //elle correspond à l'employée "Mary Smith"

 

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

Voir aussi

entitySelection.and( )
REUNION