Změna stavu potomků dokladu
Kód: document_children_transition_handler · Typy záznamů: všechny typy dokladů
Po změně stavu dokladu posune jeho potomky — doklady, které z něj vznikly — do dalšího stavu. Typickým použitím je řetězení: když se objednávka zruší, zruší se i její výdejky.
Akce vybere potomky podle typu, hloubky zanoření a filtru. Na každém z nich pak zkusí přechody ze seznamu Změna stavu v zadaném pořadí a provede první, který je pro potomka dostupný. Když některý potomek žádný z přechodů provést nemůže, akce skončí chybou — pokud to nepovolíte volbami níže. Vyžadují-li přechody potomků vlastní údaje, zobrazí se jejich pole už v dialogu změny stavu dokladu, označená číslem potomka.
Stejný handler lze na přechod přidat také jako validaci (předem ověří, že všichni potomci přechod provést mohou) a jako akci při chybě.
Parametry (názvy dle formuláře v administraci):
| Parametr | Význam |
|---|---|
| Typ potomka | povinné; typy dokladů, kterých se akce týká |
| Úroveň zanoření | jak hluboko ve stromu potomků hledat (1 = jen přímí potomci) |
| filtr potomků | volitelně Číselná řada, Typ předka, Kategorie stavu, Stav, Štítky — akce se týká jen potomků, kteří filtru odpovídají |
| Změna stavu | přechody pro workflow potomků; provede se první dostupný |
| Přeskočit, pokud je již v cílovém stavu | potomek, který už je v cílovém stavu přechodu, se tiše přeskočí |
| Přeskočit nevalidní přechody | přechod, který potomek provést nemůže nebo neprojde validacemi, se přeskočí a zkusí se další; když žádný nevyhoví, potomek zůstane beze změny |
Související dokumentace
- Akce
- Handlery
- Dokumentový model — předek a potomek
- Změna stavu předka dokladu