🔄 Používateľské transformácie
Umiestnenie v aplikácii:
Nástroje → Uživatelské transformace
🧩 Čo sú používateľské transformácie
Používateľské XSLT transformácie umožňujú jednoducho:
vytvárať vlastné transformácie dát
evidovať ich priamo v systéme
opakovane ich využívať (napr. v API)
Na rozdiel od integrovaných transformácií:
sú ukladané ako bežné používateľské záznamy
nie je potrebné žiadať o ich implementáciu do ABRA Flexi
💡 Tip
Používateľské transformácie sú ideálne na rýchle úpravy výstupov (XML/JSON) bez zásahu do systému alebo bez potreby vývoja na strane ABRA Flexi.
⚠️ Pozor
Na tvorbu transformácií je potrebná znalosť jazyka XSL (XSLT). Bez tejto znalosti nie je možné transformácie správne vytvoriť ani upravovať.
🗂 Evidencia používateľských transformácií
Zoznam transformácií je dostupný v agende:
Nástroje → Používateľské transformácie
Potvrdením tlačidla Nový otvoríte formulár na vytvorenie nového záznamu.
Skratka: Jedinečný kód transformácie. Používa sa pri volaní transformácie (napr. v REST API).
Názov: Názov používateľskej transformácie pre prehľadnú evidenciu.
Dotaz: Obsahuje kompletný transformačný predpis v jazyku XSLT.
💡 Tip
Odporúča sa používať konzistentné pomenovanie skratiek, napr. podľa typu dokladu alebo účelu transformácie (napr. faktura_export, isdoc_uprava).
__________________________________________________________________
⚙️ Použitie používateľských transformácií
Používateľské transformácie fungujú rovnako ako integrované transformácie.
Používajú sa najmä v REST API na:
úpravu získaných dát (GET)
úpravu ukladaných dát (POST/PUT)
🔗 Použitie v API
Ak chcete aplikovať transformáciu, použite parameter:
?format=code:{zkratka}kde {zkratka} je kód transformácie definovaný v evidencii.
📌 Príklad
Použitie transformácie so skratkou yxz:
/c/demo/faktura-vydana.xml?format=code:yxz
Týmto dôjde k aplikácii používateľskej XSLT transformácie na dáta faktúr.
⚠️ Pozor
Ak uvedená skratka neexistuje alebo obsahuje chybu, transformácia sa nevykoná a API vráti štandardný výstup alebo chybu.
❓ Časté otázky (FAQ)
Čo sa stane, ak zadám neexistujúcu transformáciu v API?
Transformácia sa nevykoná a API vráti štandardný výstup alebo chybu.
Na čo sa transformácie najčastejšie používajú?
Typicky na:
integrácie s externými systémami
úpravu XML výstupov
prevody dátových štruktúr