Preskoči na glavno vsebino

Štítky

Práca so štítkami v REST API

Avtor: Lenka Haringerová

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, apod.). 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).

Poznámka:

Ak chcete štítok priradiť k záznamu, je podmienkou jeho predchádzajúce založenie v číselníku štítkov.

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.

Na 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.

Export skupiny štítkov

Štítky môžete zaraďovať do skupín štítkov. Tie potom umožňujú lepšie spracovanie pri exporte (pozri nižšie). Ak nastavíte pri skupine, že doklad môže obsahovať iba jeden štítok, ostatné štítky z rovnakej skupiny budú zmazané. Možno 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,SKUPINA2.

Výstup potom môže vyzerať takto:

<winstrom>
...

<faktura-vydana>
...

<stitky SKUPINA1="STITEK1" SKUPINA2="STITEK2">STITEK1,STITEK2,STITEK3</stitky>
...

</faktura-vydana>
</winstrom>
Ste s tem dobili odgovor na svoje vprašanje?