entitySelection.orderBy( )

4D v19.8


entitySelection.orderBy ( criteria ) -> Resultado

Parámetro	Tipo	Descripción
criteria	Texto, Collection	Texto: ruta(s) de atributo y orden para ordenar la selección de entidad Colección: colección de objetos de criterio
Resultado	EntitySelection	Nueva entity selection en el orden especificado

Descripción

El método entitySelection.orderBy( ) devuelve una nueva entity selection ordenada que contiene todas las entidades de la entity selection en el orden especificado por criteria.

Notas:

Este método no modifica la selección de la entidad original.
Para más información sobre las entity selections ordenadas, consulte Ordenadas vs No ordenadas.

Debe utilizar el parámetro criteria para definir cómo deben ordenarse las entidades. Dos sintaxis son soportadas para este parámetro:

criteria es del tipo texto (formula): en este caso, criteria contiene una fórmula compuesta de 1 a x rutas de atributos y (opcionalmente) órdenes de clasificación, separadas por comas. La sintaxis de la fórmula es:
"attributePath1 {desc or asc}, attributePath2 {desc or asc},..."

El orden en que se pasan los atributos determina la prioridad de ordenación de las entidades. Por defecto, los atributos se ordenan en orden ascendente. Puede establecer el orden de clasificación de una propiedad en la cadena de criterios, separada de la ruta de la propiedad por un espacio único: pase "asc" para ordenar en orden ascendente o "desc" en orden descendente.

criteria es del tipo colección: en este caso, cada elemento de la colección contiene un objeto estructurado de la siguiente manera:
{
    "propertyPath": cadena,
    "descending": booleano
}
Por defecto, los atributos se ordenan en orden ascendente ("descendente" es false).
Puede agregar tantos objetos en la colección criteria como sea necesario.

Nota: los valores Null se evalúan como valores menores que los otros valores.

Ejemplo

  // ordenar por fórmula

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

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

 

  // ordenar por colección con o sin ordenación

 $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)

Ver también

entitySelection.orderByFormula( )
entitySelection.query( )
ORDER BY
ORDER BY ATTRIBUTE
QUERY BY ATTRIBUTE