Táto téma Pomocníka obsahuje všeobecné informácie o XML komunikácii - jednej z možností exportu/importu údajov z/do systému OBERON.
Základné informácie
- Jedným zo spôsobov, ako exportovať údaje z OBERON-u alebo naopak, importovať do OBERON-u, je pomocou XML komunikácie, t. j. výmeny súborov vo formáte XML, v ktorom sú uložené prenášané údaje. Spravidla sa exportujú/importujú údaje dokladov ako faktúra, objednávka, výdajka a pod. Export alebo import je možné vykonať v danej agende, napr. v Knihe pohľadávok, prípadne nastaviť ich automatické vykonávanie pomocou automatického XML exportu/importu, prípadne prostredníctvom off-line transportov údajov (spravidla pri off-line pobočkovom režime).
- Výmena súborov XML môže prebiehať v rámci jednej firmy (napr. pri viacerých pobočkách), ďalej medzi rôznymi účtovnými jednotkami používajúcimi OBERON (t. j. rovnaký softvér) a nakoniec aj medzi rôznymi účtovnými jednotkami, ktoré používajú odlišné účtovné (skladové) softvéry.
- XML komunikácia v systéme OBERON je založená na súboroch XML, ktoré sú presne špecifického formátu (ide o tzv. natívny formát OBERON XML). Aby systém OBERON mohol importovať údaje z iného softvéru s odlišnou štruktúrou súboru XML, existuje možnosť pred samotným importom automaticky vykonať konverziu (transformáciu) týchto údajov. Konverziu dát možno vykonať niekoľkými spôsobmi, pričom najčastejšie je to pomocou transformačných šablón XSLT. Obdobne je možné postupovať aj pri exporte údajov.
- Hotové transformačné šablóny XSLT pre XML komunikáciu je možné vyhľadať a inštalovať pomocou Správcu doplnkov (záložka XML). V odôvodnených prípadoch je možné požiadať firmu EXALOGIC o vytvorenie transformačnej šablóny XSLT na mieru.
- Popri XSLT transformačných šablónach sa pri XML komunikácii v systéme OBERON používajú aj transformačné šablóny na import súborov CSV exportovaných z iných systémov.
- Pravidlá daného importu alebo exportu je možné určiť pomocou nastavení XML komunikácie. Umožňujú pred importom nastaviť spôsob konverzie údajov zo súboru XML s odlišnou štruktúrou, ako OBERON priamo podporuje (tzv. natívny formát OBERON XML), prípadne spôsob konverzie údajov zo súboru iného formátu ako XML. Zároveň umožňujú nastaviť spôsob konverzie údajov po exporte do súboru XML s odlišnou štruktúrou ako OBERON XML, prípadne do súboru iného formátu ako XML, na ďalšie spracovanie v externých systémoch.
- V rámci podrobných nastavení XML komunikácie je možné nastaviť ďalšie parametre importu (sklad, do ktorého sa má import vykonať, polia na synchronizáciu skladových položiek atď.) v prípade, že sa položky importovaného dokladu (faktúry, príjemky...) majú naimportovať ako skladové (v opačnom prípade sa naimportujú ako neskladové). Zároveň je možné nastaviť ďalšie parametre exportu - sklad, z ktorého sa má export vykonať, a či sa majú exportovať aj základné, resp. rozšírené údaje skladových kariet, na základe ktorých sa pri následnom importe bude môcť z položky dokladu automaticky vytvoriť daná skladová karta v prípade, že sa v cieľovej databáze nenachádza.
- Pri exporte údajov vytvorený súbor XML môže byť automaticky elektronicky podpísaný. Naopak, pri importe údajov môže byť overená pravosť elektronického podpisu, a tým aj importovaného súboru XML. Bližšie informácie o elektronickom podpise získate v téme Čo je elektronický podpis.
Kde je možné použiť XML komunikáciu
- Výmena súborov XML môže prebiehať:
- v rámci jednej firmy používajúcej systém OBERON (napr. pri viacerých pobočkách),
- medzi rôznymi účtovnými jednotkami používajúcimi systém OBERON (t. j. rovnaký softvér),
- medzi účtovnou jednotkou používajúcou systém OBERON a účtovnými jednotkami, ktoré používajú odlišné účtovné (skladové) softvéry - viac informácií získate v témach Import dokladov z iných softvérov a Export dokladov do iných softvérov.
- Umožňuje rýchlo a jednoducho exportovať alebo importovať doklady (záznamy) bez zložitých nastavení.
- Je potrebné špecifikovať len nastavenia XML komunikácie, prípadne podrobné nastavenia XML komunikácie.
- Exportovať je možné jeden záznam, len označené záznamy alebo všetky (odfiltrované) záznamy zobrazené v knihe.
- Importovať je možné jeden alebo viacero dokladov naraz.
- Pri automatickom XML exporte/importe:
- XML komunikáciu je možné použiť aj pri automatickom XML exporte/importe. Predstavuje automatickú úlohu, ktorá umožňuje v určených časových intervaloch automaticky exportovať, resp. importovať XML súbory v ľubovoľných evidenciách programu OBERON - Agenda firmy (skladové karty, objednávky prijaté...) konkrétnym skupinám príjemcov, a to predovšetkým do/z iných účtovných jednotiek (firiem) používajúcich systém OBERON, resp. externých systémov (napr. internetového obchodu).
- Úloha umožňuje odosielať údaje ako:
- súbor uložený v zdieľanom úložisku na spracovanie externým programom,
- súbor odoslaný na FTP server,
- správu obsahujúcu súbor XML odoslanú na WEB server ako HTTP POST požiadavka.
- Úloha môže prijímať údaje zo:
- súboru v zdieľanom úložisku alebo vytvoreného externým programom,
- súboru stiahnutého z FTP servera,
- správy prijatej z WEB servera na základe HTTP GET požiadavky.
- V porovnaní s off-line transportami údajov (pozri nižšie) ide o efektívnejší spôsob prenosu údajov (nastavuje sa len na jednej strane, nie je potrebný výber údajov na transport a pod.).
- V prípade off-line transportov údajov:
- Off-line transporty údajov je umožňujú exporty a importy údajov spravidla medzi pobočkou a centrálou účtovnej jednotky pri off-line pobočkovom režime, napr. zabezpečujú transport údajov pri off-line pobočkovej Pokladnici OBERON.
- Transporty údajov je možné vykonávať tak v internom formáte OBERON (medzi dvomi programami OBERON), ako aj v natívnom formáte OBERON XML - vďaka tomu tieto transporty umožňujú export a import údajov aj do/z iných externých systémov (napr. export faktúr na spracovanie účtovnej kancelárii).
- Off-line transporty údajov je potrebné nakonfigurovať v programe OBERON Center. Ako funkcia v OBERON Centri off-line transporty údajov umožňujú exportovať a importovať doklady automaticky na pozadí. Používateľ nemusí manuálne vyberať doklady na transport a ani manuálne transport spúšťať - o všetko sa stará program OBERON Center. Ide však o ťažkopádnejší spôsob prenosu údajov ako pri automatickom XML exporte/importe (potreba nastavení na oboch stranách, vyššie riziko zlyhania prenosu, potreba výberu údajov na transport a pod.).
Schématický diagram
Obrázok č. 1: Spôsob importu alebo exportu údajov
Import údajov sa vykonáva nasledujúcim spôsobom:
- Ak je importovaný súbor XML iného ako natívneho formátu OBERON XML, údaje v súbore je možné zobraziť pomocou XSLT šablóny na zobrazenie, najčastejšie vo formáte HTML.
- Pomocou XSLT šablóny (alebo pomocou iných nástrojov) sa vykoná transformácia importovaného súboru XML do súboru natívneho formátu OBERON XML. Údaje zo súboru natívneho formátu je možné zobraziť pomocou XSLT šablóny (či už vstavanej alebo ľubovoľnej inej).
- Následne sa vykoná import údajov zo súboru natívneho formátu OBERON XML a údaje sa zapíšu do databázy.
Export údajov sa vykonáva nasledujúcim spôsobom:
- Údaje sa načítajú z databázy a následne sa exportujú do súboru natívneho formátu OBERON XML. Údaje zo súboru natívneho formátu je možné zobraziť pomocou XSLT šablóny (či už vstavanej alebo ľubovoľnej inej).
- Následne sa môže vykonať transformácia (konverzia) súboru natívneho formátu OBERON XML do súboru XML inej štruktúry (prípadne iného formátu, napr. CSV).
Príbuzné témy
