V celom systéme ABRA Flexi je pridaná podpora pre štítky. Tie umožňujú prilepiť stav k rôznym objektom (napr. doklady, adresár, zákazka, …) prípadne aj k rôznym stavom (napr. spôsob úhrady a pod.). Môžete tak v prepojenom systéme reagovať na situáciu, keď je faktúra uhradená spôsobom, ktorý má štítok (napr. použiť metódu v eshope).
⚠️ Ak chcete štítok priradiť k záznamu, je podmienkou jeho predchádzajúce založenie v číselníku štítkov. Odkaz na nezaložený štítok skončí chybou 400 pri vlastnosti stitky.
Zmazanie / aktualizácia štítkov
Práca so štítkami je trochu odlišná, pretože ide o reláciu, ktorá je emulovaná ako položka. Na vymazanie štítkov alebo ich aktualizáciu je potrebné použiť atribút removeAll="true":
<?xml version="1.0"?>
<winstrom version="1.0">
<adresar>
<id>14</id>
<stitky removeAll="true"/>
</adresar>
</winstrom>
Vyššie uvedené XML zabezpečí odstránenie všetkých štítkov z uvedeného záznamu v adresári.
Pre aktualizáciu štítkov stačí uviesť v elemente stitky nový zoznam hodnôt:
<stitky removeAll="true">STITEK1,NOVY_STITEK</stitky>
resp. v JSON:
"stitky@removeAll": "true",
"stitky": "STITEK1,NOVY_STITEK"
ℹ️ Bez uvedenia atribútu removeAll="true" sa vykoná iba pridanie neexistujúcich štítkov — existujúce štítky zostanú. Ak chcete zoznam skutočne nahradiť, atribút uveďte.
Export skupiny štítkov
Štítky môžete dávať do skupín štítkov. Tie potom umožňujú lepšie spracovanie pri exporte. Ak nastavíte pri skupine, že doklad môže obsahovať iba jeden štítok, budú ostatné štítky z rovnakej skupiny zmazané. Dá sa tým jednoducho emulovať stav dokladu — objekt bude vždy obsahovať iba jeden štítok zo skupiny s iba jedným štítkom.
/c/{firma}/{evidence}.xml?skupina-stitku=SKUPINA1,SKUPINA2Výstup potom môže vyzerať takto:
<winstrom>
...
<faktura-vydana>
...
<stitky SKUPINA1="STITEK1" SKUPINA2="STITEK2">STITEK1,STITEK2,STITEK3</stitky>
...
</faktura-vydana>
</winstrom>
💡 Parametrom ?stitky-as-ids=true je možné štítky exportovať aj importovať ako zoznam číselných ID namiesto kódov — pozri zostavovanie URL.
Súvisiace
Filtrovanie záznamov — podľa štítkov je možné aj filtrovať