/ API Kontakty

Ú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.