Handlery
Tato stránka vysvětluje handlery — stavební bloky logiky na změnách stavu. Handlery určují, kdy je změna stavu dostupná, co se při ní kontroluje a co se po ní vykoná.
O funkci
Handler je předpřipravený, konfigurovatelný kus chování, který na přechod přidáte v administraci — bez programování. Existují čtyři druhy; liší se tím, kdy se uplatní a co mohou způsobit:
| Druh | Kdy běží | Co způsobí |
|---|---|---|
| Podmínka | před nabídnutím změny stavu | nesplněná podmínka změnu stavu skryje (žádná chyba) |
| Validace | při pokusu o změnu stavu | neúspěšná validace změnu zastaví a zobrazí chybu |
| Akce | po úspěšné změně stavu | vykoná návazný krok (doklad, e-mail, skladová operace…) |
| Akce při chybě | při selhání některé akce | vykoná kompenzační krok (např. odemčení pozic) |
Prakticky: podmínky fungují jako filtr nabídky („tuto změnu stavu nabídni jen dobírkovým objednávkám"), validace jako závora („nepusť dál doklad s neúplnými daty"), akce jako automatizace („po přechodu vygeneruj fakturu a pošli e-mail") a akce při chybě jako pojistka („když se to nepovede, ukliď po sobě").
Každý handler má:
- Název — český popis, pod kterým handler vybíráte v nabídce typu na přechodu.
- Kód — jedinečný identifikátor (viditelný v katalogu handlerů).
- Podporované typy záznamů — handler se nabízí jen u workflow, jejichž cílový objekt podporuje.
- Parametry — nastavení konkrétního použití (např. text e-mailu, výběr dopravce); formulář parametrů se zobrazí po výběru typu.
- Stav — dostupné handlery lze používat; zastaralé (deprecated) handlery zůstávají funkční, ale nemají se používat v nových konfiguracích.
Katalog handlerů v administraci
Obrazovka Handlers je přehledový katalog všech handlerů dostupných ve vaší instanci — jen ke čtení. U každého handleru zobrazuje název s kódem, druh (Type), stav (State), podporované typy záznamů (Available for) a workflow, která handler aktuálně používají (Used in).
Katalog handlerů — u každého handleru vidíte druh, podporované typy záznamů a workflow, kde je použit.
Cesta v administraci
Registr handlerů v dokumentaci
Podrobný popis jednotlivých handlerů (co dělají, jaké mají parametry) najdete v registru členěném podle modulů, aby se handlery různých částí systému nepletly dohromady:
| Modul | Stránky registru |
|---|---|
| Základ systému | Podmínky · Validace · Akce · Akce při chybě |
| Sklad (WMS) | Podmínky · Validace · Akce · Akce při chybě |
| Distribuce | Podmínky · Validace · Akce · Akce při chybě |
Informace
Registr se buduje postupně — začínáme výběrem nejpoužívanějších handlerů; katalog Handlers v administraci je vždy úplný.
Časté dotazy (FAQ)
Proč v nabídce typů nevidím všechny handlery z katalogu?
Nabídka na přechodu je omezena na handlery, které podporují cílový objekt daného workflow (sloupec Available for v katalogu).
Může jeden handler být akcí i akcí při chybě?
Ano — řada akcí umí sloužit i jako kompenzační krok. V registru je taková akce popsána na stránce akcí a stránka akcí při chybě na ni odkazuje.