V tejto téme Pomocníka sú uvedené tak informácie o možnostiach nastavení XML komunikácie, ako aj postup nastavenia parametrov XML komunikácie v systéme OBERON.
Základné informácie
- XML komunikácia predstavuje jeden zo spôsobov, ako exportovať údaje zo systému OBERON, alebo naopak, importovať do systému OBERON. Najčastejšie sa exportujú/importujú údaje dokladov ako faktúra, objednávka, výdajka a pod. Viac informácií o tomto spôsobe komunikácie a kde ju možno použiť získate v téme Všeobecne o XML komunikácii.
- V rámci nastavení XML komunikácie sa v systéme OBERON definujú nastavenia parametrov importu a exportu údajov v rámci XML komunikácie.
- Nastavenia XML komunikácie sa uplatňujú pri samotnom importe alebo exporte údajov. Najčastejšie sa využívajú:
- pri importe na nastavenie spôsobu konverzie údajov zo súboru XML s odlišnou štruktúrou, ako OBERON priamo podporuje (tzv. natívny formát OBERON XML),
- pri importe na nastavenie spôsobu konverzie údajov zo súboru iného formátu ako XML,
- pri exporte na nastavenie spôsobu konverzie údajov do súboru XML s odlišnou štruktúrou ako OBERON XML na ďalšie spracovanie v externých systémoch,
- pri exporte na nastavenie spôsobu konverzie údajov do súboru iného formátu ako XML na ďalšie spracovanie v externých systémoch,
- pri importe alebo exporte na určenie, v ktorých agendách systému OBERON bude možné s daným nastavením pracovať,
- pri importe alebo exporte na nastavenie zobrazenia náhľadu XML súboru vo formáte HTML.
- V rámci ďalších (podrobných) nastavení XML komunikácie je ďalej možné:
- pri importe nastaviť sklad, polia na sychronizáciu skladových položiek atď. v prípade, že sa napr. položky importovaného dokladu (faktúry, objednávky, príjemky...) majú naimportovať ako skladové,
- pri exporte nastaviť 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.
- Na konverziu údajov (spravidla zmenu štruktúry súboru XML, prípadne iného formátu, resp. jeho transformáciu do zrozumiteľného formátu pre používateľa, napr. HTML), je možné v systéme OBERON použiť transformačné šablóny XSLT (prípadne transformačné šablóny na import súborov CSV). Výhodou využitia transformačných šablón je ich relatívne jednoduchá úprava bez nutnosti použitia zložitejších nástrojov (stačí aj Poznámkový blok systému Windows, prípadne iný editor - napr. vstavaný XML editor, prípadne ľubovoľný iný, napr. XML Notepad).
- Celý rad hotových transformačných šablón na import/export údajov v rámci XML komunikácie v systéme OBERON je dostupný vo forme doplnkov v ponuke Servis, Správca doplnkov. Použiť ich možno na import dokladov (faktúr, príjemiek...) z iných softvérov, export dokladov (faktúr) do iných softvérov, pri komunikácii medzi systémom OBERON a off-line internetovým obchodom atď.
Obrázok č. : Nastavenie XML komunikácie, záložka Konverzia údajov
Postup nastavenia parametrov XML komunikácie
- V programe OBERON - Agenda firmy v ponuke Servis zvoľte položku Nastavenia XML komunikácie.
- Otvorí sa číselník, v ktorom stlačte tlačidlo Nový - otvorí sa formulár Nastavenie XML komunikácie, v ktorom nastavte parametre importu/exportu:
- v záložke Základné zadajte názov nastavenia. V rozbaľovacom zozname Modul môžete nastaviť, v ktorej agende bude možné s týmto nastavením pracovať (napr. kniha pohľadávok). Po stlačení tlačidla Ďalšie nastavenia sa otvorí formulár Podrobné nastavenia XML komunikácie, v ktorom je možné vykonať ďalšie nastavenia v prípade, že sa položky importovaného/exportovaného dokladu majú naimportovať /vyexportovať ako skladové (napr. nastavenie skladu, poľa na synchronizáciu skladových položiek a pod.);
- v záložke Zobrazenie údajov môžete zadať transformačnú šablónu na zobrazenie náhľadu súboru XML (spravidla vo formáte HTML);
- v záložke Konverzia údajov v rozbaľovacom zozname Typ príkazu zvoľte spôsob konverzie údajov v prípade, že vykonávate import/export z/do externého systému (iného formátu). Ak na konverziu údajov použijete transformačnú šablónu, vyberte možnosť XSLT šablóna (prípadne CSV šablóna) a v poli Príkaz pomocou tlačidla vyberte príslušnú transformačnú šablónu (nainštalovanú v Správcovi doplnkov).
- Vykonané nastavenia uložte stlačením tlačidla OK.
- V prípade inštalácie transformačnej šablóny na import/export dokladov zo Správcu doplnkov sa v ponuke Servis, Nastavenia XML komunikácie automaticky vytvorí príslušné nastavenie (napr. Import vydanej FA do pohľadávok - SuperFaktura->OBERON, Export vydanej FA do formátu Editel XML - OBERON->EDITEL a pod.) s nastaveným spôsobom konverzie a vybratou príslušnou transformačnou šablónou. Manuálne nastaviť je v ňom však potrebné ďalšie parametre v prípade, že sa položky dokladu majú naimportovať/vyexportovať ako skladové (sklad, polia na synchronizáciu skladových položiek atď.). V opačnom prípade sa položky dokladu naimportujú/vyexportujú ako neskladové.
- Vo vybraných dokladových formulároch je možné priradiť neskladovú položku k už existujúcej skladovej karte alebo vytvoriť novú skladovú kartu. Viac informácií získate v téme Formulár Priradiť položku dokladu ku skladovej karte.
Príbuzné témy