Preskoči na glavno vsebino

Zoradenie záznamov

Ako triediť záznamy v REST API

Avtor: Lenka Haringerová

Záznamy je samozrejme možné radiť. Zoznam hodnôt, podľa ktorých je možné radiť, závisí od konkrétnej evidencie.

Radenie je riadené parametrom URL order. Tento parameter je možné uviesť opakovane.

Ukážka: /c/firma/adresar?order=nazev


Smer radenia

Je možné riadiť, či radiť vzostupne (order=nazev@A) alebo zostupne (order=nazev@D).

⚠️ @A znamená vzostupne (ascending), @D zostupne (descending). Bez prípony sa radí vzostupne.

Ukážky:

  • /c/firma/adresar?order=nazev — zoradenie adresára podľa vlastnosti nazev vzostupne

  • /c/firma/adresar?order=nazev@D — zostupné radenie

Kvôli kompatibilite s niektorými implementáciami je možné použiť aj parameter sort a dir (nadobúda hodnoty ASC a DESC).


Radenie podľa relačných vlastností

API umožňuje radenie podľa relačných vlastností, ale iba na 1. úrovni. Je možné zadať napríklad ?order=stredisko.nazev alebo ?order=stat.kod. Ak uvediete iba názov relácie (?order=stat), použije sa predvolené radenie danej relácie.

ℹ️ Zanorenie do druhej úrovne (napr. ?order=typDokl.radaPrijem.kod) nie je podporované a skončí chybou 400 s hlásením, že vlastnosť neexistuje.


Predvolené radenie

Ak parameter order nie je uvedený, záznamy sa radia podľa ID. Niektoré evidencie majú výnimku a radia sa ešte podľa ďalších vlastností — pri dokladoch podľa datVyst, pri menových kurzoch podľa platiOdData a mena.

Ste s tem dobili odgovor na svoje vprašanje?