Úprava vstupního XML pomocí XSLT transformace
Základní vlastností XML komunikace pro import dat je, že umožňuje definovat ve vstupním XML dokumentu všechny parametry, které jsou potřeba pro vytvoření kompletního záznamu v programu POHODA.
XML komunikace programu POHODA umožňuje vytvořit záznam, který je 1:1 shodný se záznamem vytvořeným přes UI rozhraní programu POHODA.
Proto je defnice a struktura vstupního XML dokumentu tak robustní, aby mohl replikovat data programu POHODA.
XML požadavek pro XML import dat do agendy programu POHODA nevyžaduje definici všech parametrů na záznamu v dané agendy do XML.
To vám umožní se rozhodnout, jaká data na záznamu budete importovat do programu POHODA. Zda všechny parametry zázanamu z dané agendy nebo jen vybrané.
Pouze je nutné dodržet základní podmníky pro vytvoření záznamu v programu POHODA v jednotlivých agendách.
XML komunikace pro import dat slouží pro výměnu dat mezi různými aplikacemi, kde každá aplikace může mít vlastní struturu XML dokumentu.
Jednou z možností, jak upravit vstupní XML dokument na XML formát programu POHODA je použít XSLT tranformace.
Možnosti XSLT transformace
Pomocí XSLT transformace můžete změnit:
- hodnoty dat v XML
- strukturu a formát dat v XML
- vstupní formát souboru
To vám umožní se rozhodnout, zda vám třetí strana bude dodávat data přímo ve formátu XML - POHODA nebo si budete vstupní data upravovat sami pomocí XSLT transformace při zpracování vstupních dat v rámci XML komunikace programu POHODA.
XSLT transformaci můžete využít např. pro přenos dokladů mezi dvěma programy POHODA, kdy z jedné POHODY exportujete faktury vydané a do druhé POHODY je importujete jako faktury přijaté.
Definice XSLT transformace
Pokud chceme nastavit a použít XSLT transformaci, pak máme tyto možnosti:
- Ve vstupním XML požadavku.
- Při dávkovém zpracování XML komunikace v konfiguračním INI souboru.
- Při ruční práci v programu POHODA přes průvodce XML komunikace.
Definice XSLT transformace ve vstupním XML požadavku
Transformační XSLT soubor lze definovat ve vstupním XML požadavku úpravou v elementu dat:dataPack/dat:transformation/dat:output
.
Definice XSLT transformace v konfiguračním INI souboru
Zadáním parametru XSLT_input=Vstupni_transformacni_soubor
XSLT_output:
Nepovinný.
Název transformačního souboru, který se použije na transformaci vstupního XML. Výsledkem bude nový soubor s koncovkou "_trn_o1.xml". Název je zadán včetně cesty, buď abslolutně (např: "C:\Program Files\Stormware\Pohoda\Info\XSL\import.xsl"), nebo relativně - vztaženo k adresáři programu POHODA (např: "Info/XSL/import.xsl").
Pokud nastavíme XSLT transformaci v INI souboru i ve vstupním XML požadavku, pak se nejdříve provede transformace zadaná v INI souboru, poté transformace zadaná v XML.