Řešení problémů
Ze scénáře vychází notifikační událost, jež nese data podstatná pro budoucí notifikaci. K této notifikační události se připojuje nastavení pro notifikaci v notifikační skupině. Zde je vybrán kanál pro odeslání zprávy i její budoucí příjemci. Pokud je nastavení správné, vytvoří se notifikace, která je odeslána vybraným uživatelům.
Na všech úrovních tohoto procesu mohou vznikat chyby, které znemožní vytvoření notifikací nebo jejich odeslání. Následující ilustrace vám pomůže s diagnostikou místa, kde nastala chyba, kterou právě řešíte.
Níže jsou popsány jednotlivé chyby podle jednotlivých fází procesu.
CHYBA 1: Scénář z různých důvodů nemusí vyrobit notifikační událost, např. v důsledku špatného kódu.
CHYBA 2: Scénář sice notifikační událost vyrobí, ale ve špatném formátu. Altworx ji potom odmítne zpracovat.
CHYBA 3: Notifikační událost se nemusí podařit expandovat, v seznamu notifikačních událostí ji poznáte podle červeného no ve sloupci Expanded. Událost nemusí být expandována pouze dočasně, protože čeká, až Notifikační centrum Altworxu zpracuje notifikace před ní. Pokud není notifikace expandovaná delší dobu, jedná se již o chybu. Ta lze vyřešit restartem Altworxu. Právě tehdy se centrum pokusí znovu expandovat dosud neexpandované notifikace. V případě, že restart nepomůže, jedná se o závažnější chybu na straně Altworxu.
CHYBA 4: Chyba může být také ve špatném formátu direct subscriptions. Pro takovou chybu pak Notifikační centrum nemůže notifikační událost zpracovat v notifikaci.
CHYBA 5A: Potíže mohou nastat při špatné definici ID a AQL v notifikační události, kdy práva nejsou ošetřena tak, aby mohla pro dané uživatele notifikace vzniknout. Toto nastavení vychází ze scénáře.
CHYBA 5B: Stejně tak může nastat chyba z druhé strany. K notifikační skupině, ve které se vymezují příjemci notifikace, je přiřazen uživatel s nedostatečným oprávněním.
CHYBA 6: V tomto případě se může jednat o špatné nastavení typu, formátu, kanálu či metadata filtru. Může dojít k překlepu při zadávání identifikátorů tam, kde není výběr pod roletkou.
CHYBA 7: Může být špatně nastaven kanál, což také může zkomplikován celý proces tvorby notifikací.
CHYBA 8: Notifikační událost je sice vyexpandovaná, ale nezpracuje se v notifikaci. Mohlo nastat pochybení v nastavení notifikační skupiny, které se pak neprovázalo s daty v notifikační události vycházející ze scénáře, nebo k jiné chybě související s propojením skupiny a události. Že nedošlo k vytvoření notifikace poznáte tak, že v kartě notifikační události je tabulka notifikací prázdná.
CHYBA 9: Notifikace vznikne, ale chybně. Při jejím formátování se projeví chybně nakódovaná šablona, tzv. Compose error.
CHYBA 10: Technické důvody mezi Altworxem a příjemcem notifikace jsou další z možných
příčin, proč notifikaci příjemce neobdrží. Například Altworx ztratí připojení k SMTP
serveru, nebo uživatelův poskytovatel emailu zprávu ztratí. Jde o množinu problémů, která
je mimo kompetenci Altworxu.
CHYBA 11: Může nastat situace, kdy má samotný příjemce plnou schránku a notifikace mu tak nemůže dorazit. Protokol SMTP může v těchto případech vygenerovat informační e-mail o neúspěšném doručení notifikace.
S následujícími typy chyb se můžete setkat ve filtru a seznamu na stránce NOTIFIKACE pod záložkou NOTIFIKACE. Souvisí se šablonami a kanály. Jedná se o tyto typy chyb:
(Dispatch status: error_compose)
Chyba se vyskytuje na úrovni kódu šablony nebo při jeho zpracování.
(Dispatch status: error_dispatch)
Potíže vznikající při zadání kanálu. Např. v notifikační skupině je specifikovaný kanál, který neexistuje.
(Dispatch status: error_channel)
Při této chybě kanál existuje, ale nedokáže zprostředkovat předání notifikace.
V kartě Notifikace v Dispatch details můžete zjistit důvod, proč chyba nastala.
Může se stát, že se notifikace nevytvoří nebo není doručena příjemci. Při řešení problémů doporučujeme identifikovat místo, kde chyba vznikla.
Nejprve vždy zkontrolujte, zda byla notifikace vytvořena. Učiníte tak v seznamu notifikací pod záložkou NOTIFICATIONS na stránce NOTIFICATIONS. Zde notifikaci dohledáte pomocí filtru. Notifikaci můžete dohledat i prostřednictvím stránky RAW NOTIFICATION EVENTS, pokud znáte notifikační událost, z které měla být notifikace vytvořena. V kartě dohledané události pak zkontrolujete tabulku vytvořených notifikací. Pokud notifikace nebyla vytvořena vůbec, v tabulce nebude uvedena.
Může se stát, že nedohledáte ani notifikační událost v seznamu událostí na stránce RAW NOTIFICATION EVENTS, protože vůbec nevznikla. Potom je chyba ve scénáři. Může se jednat o špatně napsaný kód scénáře (CHYBA 1, 2). V takových případech se neváhejte obrátit na podporu a vývojáře scénáře.
V takovém případě si zkontrolujte nastavení notifikační skupiny v uživatelském rozhraní pod záložkou SETTINGS v sekci Notification groups. V nastavení může být překlep (CHYBA 6) nebo nemusí odpovídat notifikační události a nemusí se správně provázat (CHYBA 8). Správným nastavením skupiny byste mohli docílit opravy.
Další chyby způsobující nevytvoření notifikace už jsou hůře opravitelné na úrovni aplikace. Může se jednat o neexpandovanou událost (na obrázku CHYBA 3) nebo o špatné direct subscription (CHYBA 4).
Situace, kdy nevznikla notifikace z události nevznikla, mohla nastat také tím, že příjemci neměli dostatečná oprávnění pro obdržení konkrétní notifikace (CHYBY 5A a 5B). Oprávnění mohlo být nedostatečně nastaveno, ať už ze strany notifikační události v AQL nebo ID, nebo ze strany oprávnění jednotlivých uživatelů.
CHYBA 5A - Notifikační události vycházejí ze scénáře, v takovém případě je potřeba požádat o opravení scénáře.
CHYBA 5B - Oprávnění konkrétních uživatelů lze upravovat v uživatelském rozhraní aplikace pod záložkou SETTINGS v sekci Users.
Notifikace mohla být sice vytvořena, ale nesprávně. Tehdy ji najdete v seznamu notifikací s uvedenou chybou souvisejících s kanálem nebo šablonou (Compose error, Dispatch error, nebo Channel error).
Chyba typu Compose error souvisí se šablonou, která je napsána nebo zpracována chybně a nenaformátuje notifikaci správně (CHYBA 9). Opravy kódu šablony spadají pod vývojáře scénáře.
Chyba typu Dispatch error je vyvolána díky zadání kanálu, který neexistuje (CHYBA 6). V uživatelském rozhraní pod záložkou SETTINGS v sekci Notification groups zkontrolujte, zda je kanál správně uveden. Může zde být překlep v ID. Zadejte spravné ID existujícího kanálu.
Pokud je kanál chybně nastavený (CHYBA 7), opravte jeho nastavení v administrátorském rozhraní pod záložkou NOTIFICATIONS na stránce CHANNELS. Přesný důvod chyby Channel error najdete v Dispatch details. I tato informace vám může pomoct k řešení problémů.
Všechny zamýšlené příjemce notifikace naleznete pod záložkou NOTIFICATIONS na stránce RAW NOTIFICATION EVENTS v tabulce notifikací.
Pokud uživatel notifikaci neobdržel, chyba mohla během procesu odeslání notifikace k příjemci (CHYBY 10 a 11) nastat z několika důvodů. Hlásí-li chybu pouze jeden z příjemců, mohou být potíže s doručením na jeho straně. Může mít plnou e-mailovou schránku. Doptejte se ho, zda mu tento fakt nestěžuje přijetí zprávy. Při doručování notifikace mohl vypadnout signál, spojení mezi servery, nemusela být funkční služba, která příjemci spravuje e-mailovou schránku, atd.
Tento problém je už mimo kompetenci Altworxu. Jakmile je zjištěný problém vyřešen, můžete notifikaci poslat znovu. Na stránce NOTIFICATION pod záložkou NOTIFICATION vyhledáte konkrétní notifikaci a kliknete na ni. V kartě notifikace je nahoře vpravo tlačítko Resend notification. Tím by se mohla na další pokus dostat notifikace k příjemci.
Výše uvedený výčet chyb není konečný. V případě, že si nevíte rady, kontaktuje technickou podporu aplikace.