entitySelection.orderBy()

Home

4D v19.8


entitySelection.orderBy() ( criteria ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
criteria	Text, Collection	Text: Attributpfad(e) und Reihenfolge(n), nach denen die Entity-Selection sortiert werden soll Collection: Collection der Objekte für Kriterien
Funktionsergebnis	EntitySelection	Neue Entity-Selection in der angegebenen Reihenfolge

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.orderByFormula( )
entitySelection.query()
ORDER BY
ORDER BY ATTRIBUTE
QUERY BY ATTRIBUTE