entitySelection.orderBy( )

4D v19.8


entitySelection.orderBy ( critère ) -> Résultat

Paramètre	Type	Description
critère	Texte, Collection	Texte : chemin(s) d'attribut(s) et mode(s) de tri pour la sélection d'entités Collection : collection d'objets critère
Résultat	EntitySelection	Nouvelle sélection d'entités dans l'ordre spécifié

Description

La méthode entitySelection.orderBy( ) renvoie une nouvelle sélection d'entités ordonnée contenant toutes les entités de la sélection d'entités dans l'ordre spécifié par le paramètre critère.

Notes :

Cette méthode ne modifie pas la sélection d'entités d'origine.
Pour plus d'informations sur les sélections d'entités ordonnées, veuillez vous référer à Sélections d'entités triées vs Sélections d'entités non-triées.

Vous devez utiliser le paramètre critère pour définir la manière dont les entités doivent être triées. Deux syntaxes sont prise en charge pour ce paramètre :

critère est de type texte (formule) : Dans ce cas, critère contient une formule composée de chemins d'attribut de 1 à x et (optionnellement) de tri, séparés par des virgules. La syntaxe de la formule est :
"attributePath1 {desc or asc}, attributePath2 {desc or asc},..."

L'ordre dans lequel les attributs sont transmis détermine la priorité de tri des entités. Par défaut, les attributs sont triés par ordre croissant. Vous pouvez définir l'ordre de tri d'une propriété dans la chaîne des critères, séparée du chemin de propriété par un seul espace : passez "asc" pour trier par ordre croissant ou "desc" pour trier par ordre décroissant.

critère est de type collection : Dans ce cas, chaque élément de la collection contient un objet structuré de la façon suivante :
{
"propertyPath": chaîne,
"descending": booléen
}
Par défaut, les attributs sont triés par ordre croissant ("descending" est false).
Vous pouvez ajouter autant d'objets que nécessaire dans la collection critère.

Note : Les valeurs Null sont évaluées comme inférieures aux autres valeurs.

Exemple

  // tri avec formule

 $sortedEntitySelection:=$entitySelection.orderBy("firstName asc, salary desc")

 $sortedEntitySelection:=$entitySelection.orderBy("firstName")

 

  // tri avec collection avec ou sans ordres de tri

 $orderColl:=Creer collection

 $orderColl.push(Creer objet("propertyPath";"firstName";"descending";Faux))

 $orderColl.push(Creer objet("propertyPath";"salary";"descending";Vrai))

 $sortedEntitySelection:=$entitySelection.orderBy($orderColl)

 

 $orderColl:=Creer collection

 $orderColl.push(Creer objet("propertyPath";"manager.lastName"))

 $orderColl.push(Creer objet("propertyPath";"salary"))

 $sortedEntitySelection:=$entitySelection.orderBy($orderColl)

Voir aussi

CHERCHER PAR ATTRIBUT
entitySelection.orderByFormula( )
entitySelection.query( )
TRIER
TRIER PAR ATTRIBUT