entitySelection.orderBy( )

4D v19.8


entitySelection.orderBy ( criterios ) -> Resultado

Parâmetro	Tipo	Descrição
criterios	Texto, Collection	Texto: rotas de atributo e ordenações as quais vai ordenar a entidade de seleção Coleção:coleção de critérios de objeto
Resultado	EntitySelection	Nova seleção de entidade na ordem especificada

Descrição

O entitySelection.orderBy( ) método retorna uma nova seleção de entidade ordena que contém todas as entidades da seleção de entidade na ordem especificada por criterio.

Notas:

Este método não modifica a seleção de entidade original.
Para saber mais sobre seleções de entidade ordenadas, veja Entity selections Ordenadas vs não ordenadas.

Deve usar o parâmetro criterio para definir como as entidades devem ser ordenadas. Duas sintaxes são compatíveis com o parâmetro:

criterio é de tipo text (fórmula): Neste caso, criterio contém uma fórmula feita de 1 a x rotas de atributo e (opcionalmente) ordenadas, separadas por vírgulas. A sintaxe de fórmula é:
"attributePath1 {desc or asc}, attributePath2 {desc or asc},..."

A ordem na qual os atributos são passados determina a prioridade de ordenamento das entidades. Normalmente os atributos são ordenados em ordem ascendente. Pode estabelecer a ordenação da propriedade na string critério, separada da rota de propriedade por um único espaço:: passe "asc" para ordenar de forma ascendente ou "desc" para ordenar descendente.

criterio é do tipo coleção: neste caso, cada elemento da coleção contém um objeto estruturado da maneira abaixo:
{
"propertyPath": string,
"descending": boolean
}
Normalmente, atributos são ordenados de forma ascendente ("descendente" se falso).
Pode adicionar quantos objetos na coleção criterio quantos sejam necessários.

Nota: Valores Null são avaliados como menores que outros valores.

Exemplo

  // ordena pela fórmula

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

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

 

  // ordena por coleção com ou sema ordenação

 $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 também

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