entitySelection.orderBy()

Home

4D v17.4

Beschreibung

Die Methode entitySelection.orderBy() gibt eine neue sortierte Entity-Selection mit allen Entities der Entity-Selection in der in criteria angegebenen Reihenfolge zurück .

Hinweise:

Diese Methode ändert nicht die ursprüngliche Entity-Selection.
Weitere Informationen dazu finden Sie im Abschnitt Sortierte vs unsortierte Entity-Selections.

Im Parameter criteria definieren Sie, wie die Entities sortiert werden sollen. Es gibt 2 Möglichkeiten:

criteria ist vom Typ Text (Formel): In diesem Fall enthält criteria eine Formel aus 1 bis x Attributspfaden und (optional) Sortierreihenfolgen, getrennt durch Kommas. Die Syntax für die Formel lautet:
"attributePath1 {desc oder asc}, attributePath2 {desc oder asc},..."

Die Reihenfolge, in der die Attribute übergeben sind, bestimmt die Sortierpriorität der Entities. Standardmäßig werden Attribute in aufsteigender Reihenfolge sortiert. Sie können die Sortierreihenfolge einer Eigenschaft im criteria String setzen, vom Eigenschaftspfad getrennt durch ein Leerzeichen: Übergeben Sie "asc" zum Sortieren in aufsteigender Reihenfolge, "desc" für absteigende Reihenfolge.

criteria ist vom Typ Collection: In diesem Fall enthält jedes Element der Collection ein Objekt mit folgender Struktur:
{
"propertyPath": string,
"descending": boolean
}
Attribute werden standardmäßig in aufsteigender Reihenfolge sortiert ("absteigend" ist falsch).
In der Collection criteria können Sie soviel Objekte, wie benötigt hinzufügen.

Hinweis: Nullwerte werden geringer als andere Werte gewertet.

Beispiel

  // Sortierung nach Formel

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

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

 

  // Sortierung nach Collection mit oder ohne Reihenfolge

 $orderColl:=New collection

 $orderColl.push(New object("propertyPath";"firstName";"descending";False))

 $orderColl.push(New object("propertyPath";"salary";"descending";True))

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

 

 $orderColl:=New collection

 $orderColl.push(New object("propertyPath";"manager.lastName"))

 $orderColl.push(New object("propertyPath";"salary"))

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

Siehe auch

entitySelection.query()