Úrovne podrobnosti

Úrovne podrobnosti vrátených údajov

Petr Pech avatar
Written by Petr Pech
Updated over a week ago

Kvôli zvýšeniu rýchlosti sa nevracajú všetky údaje, ktoré zaznamenávame implicitne. Úroveň podrobnosti údajov je možné kontrolovať. Tento zoznam sa týka len formátov XML, JSON, XLS a CSV. Iné formáty, ako napríklad PDF alebo ISDOC, nie sú ovplyvnené. V každom okamihu je možné vybrať len jednu z úrovní.

Úroveň podrobnosti je určená parametrom podrobnosti. Predvolená úroveň pre zoznam záznamov je súhrnná, pre detail záznamu je úplná.

Príklad: /c/company/addressar?detail=summary

Kód

Názov

Popis

id

Identifikátor

Iba id primárneho kľúča záznamu a externé identifikátory

summary

Zhrnutie

Základný prehľad, ako je id, lastUpdate, kód alebo názov.

full

Úplný detail

Súhrn všetkých položiek, ktoré obsahuje základný záznam.

custom:...

Detail používateľa

Len id a vymenované položky (pozri nižšie).

Detail na úrovni používateľa umožňuje vybrať všetky položky, ktoré sa majú zobraziť. Je to užitočné, ak chcete len niektoré podrobnosti, ale súhrn neobsahuje to, čo potrebujete. Položka v adrese URL je špeciálna:

/c/company/adresar?detail=custom:name,ic

Spôsobí, že sa vyexportuje iba ID, názov a IC. Za vlastným reťazcom nasleduje dvojbodka a za ňou zoznam položiek na export oddelený čiarkou. Identifikátor položky sa vždy exportuje, takže ho nie je potrebné uvádzať. Neznáme vlastnosti sa ignorujú.

Pre kolekcie objektov je tiež možné určiť vlastnú úroveň podrobnosti. Za názvom kolekcie stačí uviesť zoznam vlastností v zátvorkách, a to nasledovne:

/c/company/price?detail=custom:code,sets-and-sets(price,priceSet)

To znamená, že z cenníka sa exportuje len kód a kolekcia sád/kompletov a pre každú sadu/komplet sa exportujú len vlastnosti price list a price listSet (a samozrejme ID).

V prípade potreby môže byť tento záznam aj vnorený (napr. /c/abc/cenik.xml?detail=custom:kod,sets-and-completes(cenik(name),cenikSada)&includes=/cenik/sets-and-completes/sets-and-completes/cenik).

Okrem základnej úrovne podrobností možno pomocou parametra relations kontrolovať aj ďalšie informácie. Tieto údaje možno kombinovať tak, že ich oddelíte čiarkou:

Príklad: /c/company/addressar?relations=väzby,prílohy

Pozor: položky, ktoré sú kontrolované týmto zoznamom, je možné exportovať len zo systému ABRA Flexi. Nie je možné ich použiť na import do systému ABRA Flexi. Ak chcete importovať, je potrebné vložiť údaje do samotnej tabuľky.

Kód

Názov

Popis

väzby

Väzby medzi dokumentmi

prílohy

Prílohy

skladové karty

Skladové karty (pre cenníky)

pozície

Položky dokumentov

Taktiež je možné určiť, aby sa do väzby vložil celý objekt a nie iba ID.

Príklad: /c/company/adresar?includes=/adresar/stat/

Ak chcete súbor použiť viackrát, oddeľte ho čiarkou: ?

includes=/adresar/stat/,/adresar/center/

Did this answer your question?