🔄 Uživatelské transformace
Umístění v aplikaci:
Nástroje → Uživatelské transformace
🧩 Co jsou uživatelské transformace
Uživatelské XSLT transformace umožňují jednoduše:
vytvářet vlastní transformace dat
evidovat je přímo v systému
opakovaně je využívat (např. v API)
Na rozdíl od integrovaných transformací:
jsou ukládány jako běžné uživatelské záznamy
není nutné žádat o jejich implementaci do ABRA Flexi
💡 Tip
Uživatelské transformace jsou ideální pro rychlé úpravy výstupů (XML/JSON) bez zásahu do systému nebo bez potřeby vývoje na straně ABRA Flexi.
⚠️ Pozor
Pro tvorbu transformací je nutná znalost jazyka XSL (XSLT). Bez této znalosti není možné transformace správně vytvořit ani upravovat.
🗂 Evidence uživatelských transformací
Seznam transformací je dostupný v agendě:
Nástroje → Uživatelské transformace
Potvrzením tlačítka Nový otevřete formulář pro vytvoření nového záznamu.
Zkratka: Jedinečný kód transformace. Používá se při volání transformace (např. v REST API).
Název: Název uživatelské transformace pro přehlednou evidenci.
Dotaz: Obsahuje kompletní transformační předpis v jazyce XSLT.
💡 Tip
Doporučuje se používat konzistentní pojmenování zkratek, např. podle typu dokladu nebo účelu transformace (např. faktura_export, isdoc_uprava).
__________________________________________________________________
⚙️ Použití uživatelských transformací
Uživatelské transformace fungují stejně jako transformace integrované.
Používají se zejména v REST API pro:
úpravu získaných dat (GET)
úpravu ukládaných dat (POST/PUT)
🔗 Použití v API
Pokud chcete aplikovat transformaci, použijte parametr:
?format=code:{zkratka}kde {zkratka} je kód transformace definovaný v evidenci.
📌 Příklad
Použití transformace se zkratkou yxz:
/c/demo/faktura-vydana.xml?format=code:yxz
Tímto dojde k aplikaci uživatelské XSLT transformace na data faktur.
⚠️ Pozor
Pokud uvedená zkratka neexistuje nebo obsahuje chybu, transformace se neprovede a API vrátí standardní výstup nebo chybu.
❓ Časté dotazy (FAQ)
Co se stane, když zadám neexistující transformaci v API?
Transformace se neprovede a API vrátí standardní výstup nebo chybu.
K čemu se transformace nejčastěji používají?
Typicky pro:
integrace s externími systémy
úpravu XML výstupů
převody datových struktur