V URL používaném pro získávání dat z ABRA Flexi je možné využít mnoho parametrů, které ovlivňují získané výsledky.

Téměř každý uživatel ABRA Flexi API bude dřív nebo později potřebovat nějakým způsobem stránkovat výsledky, které mu systém vrací. Například jen z toho důvodu, že bez jiného určení ABRA Flexi vrací jen prvních 20 výsledků. Implicitně je totiž stránka velká 20 záznamů. Pokud je tedy potřeba ze systému získat další stránky nebo mít stránku delší je nutné začít používat parametry.

limit

Tento parametr určuje, kolik záznamů bude na jedné stránce.
Pokud potřebujete získat stránku se všemi záznamy najednou, tak je nutné tento parametr nastavit na hodnotu 0.

Vrátí se prvních dvacet záznamů z evidence adresář.

Vrátí se prvních pět záznamů z evidence adresář.

Vrátí se všechny záznamy z evidence adresář.

start

Pokud je požadováno stránkování výsledků, tak jen limit nestačí. Je nutné použít i parametr start, který řekne, na kolikátém záznamu stránka začíná.
První záznam a zároveň výchozí hodnota je start=0.

Vrátí stránku o velikosti 5 záznamů z evidence adresář a začne na prvním záznamu.

Vrátí druhou stránku o velikosti 5 záznamů z evidence adresář. Druhá stránka je určena parametrem start s hodnotou 5.

add-row-count

Pokud stránkujete záznamy, je vhodné určit, kdy skončit. Je tedy také možné do URL přidat parametr, který do výstupu doplní celkový počet záznamů, přes které je možné stránkovat. Tento parametr se jmenuje add-row-count a nabývá hodnot true nebo false podle toho, zda se má celkový počet doplňovat, nebo ne.

Vrátí stránku o velikosti 5 záznamů z evidence adresář. V elementu winstrom je doplněn atribut rowCount, který obsahuje celkový počet záznamů.

Stejný postup je možné aplikovat i na JSON výstup. Pak bude do výstupu doplněno „@rowCount“:“457″.

Pro co nejrychlejší odezvu Flexi doporučujeme používat stránkování!

Další optimalizací může být odstranění parametru add-row-count při načítání dalších stránek. Není totiž nutné se při každé stránce dotazovat, zda se tento počet nezměnil. Navíc získání tohoto čísla je v ABRA Flexi další dotaz do databáze, a každý zbytečný dotaz navíc je zdržení.

Dalším velmi důležitým parametrem je detail. Tento parametr umožňuje ovlivnit, jaké vlastnosti jednotlivých záznamů, dané evidence, se budou ve výstupu nacházet. Je to ale velmi rozsáhlá tématika, takže si ji v budoucnu rozebereme v samostatném článku.
Dokumentace k jednotlivým detailům je dostupná na stránkách ABRA Flexi.

Ve většině případů je potřeba záznamy, které ABRA Flexi vrací, mít rovnou i seřazené podle nějaké vlastnosti. Proč bychom měli záznamy řadit ve své aplikaci, když i toto za Vás může vyřešit ABRA Flexi?
Řazení záznamů se provádí parametrem order. Hodnota tohoto parametru je vlastnost, podle které budete chtít řadit.

Pokud tedy do URL doplníte parametr order=kod, systém bude vracet záznamy seřazené podle vlastnosti Zkratka. Záznamy budou seřazeny vzestupně.

Pokud potřebujete záznamy seřadit sestupně (výhodné například pro řazení podle částek, faktury s nejvyšší hodnotou budou na začátku), tak ještě za název vlastnosti doplňte @D

Řazení podle více hodnot se provádí opakovaným použitím parametru order. Pak záleží i na pořadí, jak jsou do URL parametry order vkládány.

Tento příklad vrátí záznamy z evidence adresář, seřazené nejdříve podle státu a pokud je stát stejný, budou záznamy řazeny podle zkratky.

Dotaz s řazením nejdříve podle zkratky a pak podle státu, samozřejmě vrátí jiné výsledky.

Parametr order je možné použít i přímo ve webovém rozhraní ABRA Flexi.

ABRA Flexi umožňuje v URL ještě mnoho dalších parametrů. Jejich kompletní seznam se nachází na stránce Sestavování URL, takže již zmíníme jen ty nejdůležitější a nejpoužívanější.

Logické parametry s možnými hodnotami true / false lze aktivovat pouhým uvedením parametru (tj. s prázdnou hodnotou). Například ?no-ids=true lze zkráceně zapsat jen jako ?no-ids.

only-ext-ids

Výstupy z Flexi vypisují u každého objektu identifikátory.
Pokud se použije tento parametr, budou vypisovány jen externí identifikátory objektů.

V tomto případě tedy zmizely vnitřní identifikátory ABRA Flexi a ve výstupu jsou jen externí identifikátory u záznamů, které je obsahují.

no-ext-ids

Opakem předchozího parametru je parametr no-ext-ids. Pokud je použit tento parametr, nebudou ve výstupu žádné externí identifikátory. Parametr no-ext-ids slouží především ke zrychlení načítání dat z ABRA Flexi. Každý pokus o načtení externích identifikátorů výpis zpomaluje.

no-ids

Obdoba předchozího parametru, ale ve výstupu nebudou žádné vnitřní identifikátory ABRA Flexi. Takže mohou zůstat zobrazeny například externí identifikátory.

Parametr no-ids=true ovlivňuje export ve všech úrovních, tj. také položky dokladů a vložené vazby.

no-comments

Pro možnost potlačení komentářů v XML výstupu byl přidán nový logický parametr no-comments.

mode=simple

Nový režim exportu “simple”(?mode=simple) generující minimalistický výstup bez atributů ref a showAs a v případě XML navíc bez vysvětlujících komentářů.

code-as-id

Tímto parametrem se místo interních identifikátorů ABRA Flexi vypíše u evidencí, které to podporují, zkratka jako identifikátor.

Tímto parametrem je možné v kombinaci s no-ids zajistit přenosy dat mezi jednotlivými firmami ve Flexi. Například, pokud bude potřeba přenést adresář z firmy A do firmy B, je nejlepší způsob použít export přes REST-API, z firmy A a import do firmy B. URL pro získání adresáře bude vypadat například takto:

access-attribs=true

Zpřístupní dodatečné atributy informující o editovatelnosti záznamu.

Výsledek u kolekcí může vypadat například takto: