Akce Notifikace

Skupina Notifikace staví čitelný souhrn toho, co běh udělal, a doručí ho e-mailem, na Slack nebo do Teams.

poznámka

Tato skupina nahrazuje notifikační polovinu dřívější stránky Akce Zpráva. E-mailové akce se přesunuly do vlastní skupiny Email a notifikátor už nepotřebuje akci pro vytvoření e-mailového klienta — reporty vykresluje Aiviro Cloud.

Postup pro reportování

1. Během scénáře volejte Přidat zprávu vždy, když se stane něco, co je dobré zaznamenat.
2. Na konci jednou zavolejte Odeslat jako email a nasbírané zprávy se doručí jako formátovaný report.

Zprávy se hromadí v panelu Oznámení, takže vidíte, jak report vzniká, už při vývoji.

---

Přidat zprávu

Přidá jeden záznam do frontu oznámení.

📸 Potřeba snímek — /img/editor/actions/notification/notifier_add.png

Zachytit: formulář Přidat zprávu s rozbalenými pokročilými nastaveními, aby byly vidět Název, ID sekce a Název sekce, a k tomu panel Oznámení s několika zprávami různých typů. Proč přefotit: Název, ID sekce a Název sekce jsou nové.

Parametr	Popis
Zpráva	Text, který se zaznamená. Přijímá proměnné.
Typ	Závažnost, která určuje barvu v reportu: INACTIVE (šedá), SUCCESS (zelená), INFO (modrá, výchozí), WARNING (žlutá), ERROR (červená).
Název	Nepovinná hlavička pro tuto jednu zprávu. Respektuje přepínač VAR — viz níže.
ID sekce	Seskupí zprávy do sekce reportu. Zprávy se stejným ID skončí ve stejné sekci. Nepovinné.
Název sekce	Hlavička zobrazená u té sekce. Nepovinné.

tip

ID sekce změní plochý seznam na strukturovaný report. V cyklu přes faktury použijte jako ID sekce číslo faktury — všechny zprávy o té faktuře se pak objeví pohromadě pod vlastní hlavičkou.

Přepínač VAR

Název se řídí stejným pravidlem jako každé jiné pole:

VAR	Význam
vypnuto	Doslova to, co jste napsali. Report znamená slovo „Report“.
zapnuto	Název proměnné nebo výraz. Report znamená proměnnou Report.

Do verze 0.23.x Název přepínač ignoroval a vždy hádal proměnnou, takže obyčejný nadpis jako Report rozbil výstup Exportovat do Pythonu — export spadl, nebo si tiše vzal nesouvisející proměnnou. Opraveno v 0.24.0.

poznámka

Text zprávy se při vykreslení reportu HTML-escapuje, takže surové HTML vložené do Zprávy se teď zobrazí doslova místo interpretace. Když chcete skutečné HTML, použijte Odeslat jako HTML u akce Odeslat email.

Odeslat jako email

Vykreslí nasbírané zprávy do reportu a odešle ho.

📸 Potřeba snímek — /img/editor/actions/notification/notifier_send.png

Zachytit: dva obrázky — formulář Odeslat jako email s přepínačem Doručení ukazujícím oba způsoby, a ukázku vykresleného reportu, jak dorazí do e-mailové schránky. Proč přefotit: akce už nebere proměnnou s e-mailovým klientem; Doručení a Jazyk jsou nové.

Parametr	Popis
Příjemci	Adresy oddělené středníky, např. a@example.com; b@example.com. Přijímá proměnné.
Předmět hlášení	Předmět e-mailu. Výchozí Aiviro Editor Report.
Jazyk	Jazyk, ve kterém se report vykreslí: cs, en, de nebo sk. Výchozí cs. Report vykresluje vždy Aiviro Cloud v tomto jazyce, bez ohledu na způsob doručení.
Doručení	Aiviro Cloud (výchozí) e-mail zároveň odešle ze serveru — není co nastavovat. E-mailový účet (SMTP) odešle report vykreslený v cloudu přes e-mailový účet z vašeho trezoru, takže pošta odchází z vaší vlastní domény.
Uložit report do logů	Zapíše vykreslený report v HTML i jako čistý text také do složky s logy. Výchozí zapnuto. Nepovinné.

Odeslat zprávu na Slack

Pošle zprávu do kanálu na Slacku.

Parametr	Popis
Token slacku	OAuth token bota nebo uživatele s oprávněním chat:write.
ID kanálu	Cílový kanál, např. C0123456789.
Zpráva	Text, který se odešle.

Odeslat zprávu na Teams

Pošle zprávu do kanálu Microsoft Teams přes příchozí webhook.

Parametr	Popis
URL adresa webhooku	URL příchozího webhooku daného kanálu Teams.
Zpráva	Obsah v JSON nebo v čistém textu.

varování

Token Slacku i URL webhooku Teams jsou přihlašovací údaje. Uložte je do trezoru a odkazujte se na ně jako {{SECRET:KLIC}}, místo abyste je psali do akce — soubor projektu s živým tokenem nemá co dělat v Gitu.