Strom ceníku přes REST API

Import do stromu ceníku je aktuálně ve stavu NOT_DOCUMENTED import podporujeme, ale není dokumentovaný a nedoporučujeme jej používat. Není tedy plně implementován, například identifikace je možná pouze pomocí ID. Pokud přecejen budete chtít import použít seznámíme Vás s postupem na jednoduchém příkladu.

Popis evidencí naleznete zde:

strom - popisuje základní struktur (uzly/větve) stromu, jak ji vidíme v aplikaci po zapnutí stromu, zjistíme zde například jejich hladinu, pořadí, otce a cestu
strom-koren - popisuje kořen stromu, standardně se jedná o STR_CEN - Strom ceníku
strom-cenik - popisuje přiřazení ceníkových položek do jednotlivých uzlů (větví) stromu

Pro lepší pochopení struktury a zavislostí si ukážeme jednoduchý příklad stromu.

Na obrázku je znázorněna cesta do kategorie Solná mýdla a její hladina.

V API je tento strom zobrazen následovně:

Otec je předchozí uzel (MYDLA), cesta a hladina je pořadí, jak je vidíte v aplikaci, tím že se počítá i úvodní "Strom ceníku".

Tvorba stromu

V případě tvorby stromu jsou povinné položky jeho název, pořadí a strom do kterého patří. Cesta a hladina je vypočtena automaticky.

<winstrom version="1.0">
  <strom>
    <id>code:TELKREM</id>>
    <nazev>Tělové krémy</nazev>
    <poradi>1</poradi>
    <strom>code:STR_CEN</strom>
    <otec>code:KREMY</otec>
  </strom>
</winstrom>

Pomocí pořadí nastavíme, na jaké pozici se ve své kategorii uzel zobrazí. Strom je hlavní kořen stromu, otec je předcházející uzel stromu.

Přiřazení ceníkové položky do stromu

Jak bylo uvedeno, z důvodu implementace je nutné uzel zapsat ID nikoliv kódem.

<winstrom version="1.0">
  <strom-cenik>
       <!-- idZaznamu = ID nebo kód ceníkové položky, 
       kterou chcete do stromu přiřadit -->
       <idZaznamu>code:TELKREM ABC 500</idZaznamu>

       <!-- uzel = ID daného uzlu ve stromu, 
       které zjistíte dotazem na /strom.xml -->
       <uzel>4</uzel>
  </strom-cenik>
</winstrom>

Po provedení importu se v dané větvy stromu (ID=4) zobrazí přiřazená položka TELKREM ABC 500.

Přesun větve stromu

Pro případný přesun větve je potřeba upravit element otec na kód nové nadřazené kategorie a element pořadí = pro jistotu např. 99, zařadí se tak na konec.

<winstrom version="1.0">
  <strom>
    <id>code:PANSKEKREMY</id>
    <poradi>99</poradi>
    <otec>code:TELKREMY</otec>
  </strom>
</winstrom>

Dojde k přesunu celé kategorie PANSKEKREMY včetně podkategorií a přiřazených položek do kategorie TELKREMY, nikoliv zkopírování.