h1. Řazení záznamů

Na všechny zdroje vracející kolekce (AtomFeed) lze aplikovat řazení pomocí parametru [[URLParameters#orderBy|orderBy]]. Řadit lze obvykle podle libovolného elementu v _první úrovni_ pod @atom:content@, a to i podle více elementů, přičemž pro každý lze určit směr řazení (vzestupně/sestupně).


h2. Gramatika a sémantika

Zápis výrazu pro řazení odpovídá jednoduché gramatice:

  expression = ordering, 
             [ ",", ordering ];
ordering   = identifier,
             [ "@", direction ];
identifier = ? ["a"-"z","A"-"Z","_","0"-"9","-"]+ ?
direction  = "asc" | "desc";

kde @identifier@ je název elementu, podle kterého chceme řadit, a @direction@ je směr řazení – @asc@ vzestupný (výchozí), @desc@ sestupný.


h2. Příklady

* "<code>/teachers?orderBy=firstName</code>":/api/3b/teachers?orderBy=firstName – seřadí vyučující podle křestního jména vzestupně od A do Z
* "<code>/teachers?orderBy=firstName@desc</code>":/api/3b/teachers?orderBy=firstName@desc – seřadí vyučující podle křestního jména sestupně od Z do A
* "<code>/teachers?orderBy=firstName,lastName</code>":/api/3b/teachers?orderBy=firstName,lastName – seřadí vyučující podle křestního jména a příjmení vzestupně od A do Z
* "<code>/teachers?orderBy=firstName@desc,lastName@desc</code>":/api/3b/teachers?orderBy=firstName@desc,lastName@desc – seřadí vyučující podle křestního jména a příjmení sestupně od Z do A
* "<code>/teachers?orderBy=firstName@desc,lastName@asc</code>":/api/3b/teachers?orderBy=firstName@desc,lastName@asc – seřadí vyučující podle křestního jména sestupně a podle příjemní vzestupně