Wiki source code of Notifikace

Version 33.5 by Josef Vencl on 2021/11/26 07:38
Hide last authors
Josef Vencl 24.1 1 (% class="box" %)
2 (((
Josef Vencl 25.1 3 Notifikace jsou automatické e-mailové zprávy, které jsou zaslány definovaným uživatelům v okamžiku, kdy nastane určitá situace. Například založení nového uživatelského účtu, vypršení přístupu ke kurzu nebo přiřazení nového kurzu uživateli.
Josef Vencl 24.1 4 )))
Petr Blšťák 20.1 5
Josef Vencl 27.4 6 Notifikace existují v systému dvojího druhu - globální a lokální. Globalní notifikace platí pro všechny objekty v systému a nastavují se ze sekce Nastavení, [[tabu Notifikace 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Nastavení.Tab Notifikace.WebHome]] v modálovém okně Notifikace. Lokální notifikace se nastavují z [[detailu aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail aktivity.WebHome]] a platí pouze pro danou aktivitu. Pokud je tedy nastavena globální notifikace na splnění aktivity uživatelem, odešle se v okamžiku kdy jakýkoli uživatel splní jakoukoli aktivitu v systému. Pokud je nastavena stejná notifikace lokálně na aktivitě, odešle se v pouze případě, kdy jakýkoli uživatel splní tuto konkrétní aktivitu.
Petr Blšťák 20.1 7
Josef Vencl 27.4 8 Při nastavení **lokální i globální notifikace na stejný spouštěč** se v závislosti na nastavení zpracují obě notifikace, lokální notifikace nahradí notifikaci globální nebo lokální notifikace zruší tu globální bez náhrady. Zmíněné nastavení upravíme v konfiguračním okně Notifikace z [[Detailu aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail aktivity.WebHome]] zatržením checkboxů Nahradit globální notifikaci, resp. Zrušit globální notifikaci pro tuto aktivitu.
Josef Vencl 26.1 9
Josef Vencl 28.16 10 = Adresáti notifikací =
11
Josef Vencl 28.17 12 Adresátem notifikace může být pouze uživatel spojený se spuštěnou akcí. Jsou to:
Josef Vencl 26.1 13
Josef Vencl 28.18 14 * //uživatel// - přímo spojený např. s aktivitou, která mu je přiřazena, nebo jako majitel uživatelského účtu, jehož e-mail se ověřuje.
15 * //hodnotitel// - uživatel, který je u aktivit a hodnocení jako hodnotitel přiřazen
Josef Vencl 28.20 16 * (% class="box warningmessage" %)
17 (((
18 //zadavatel - k doplnění//
19 )))
20 * (% class="box warningmessage" %)
21 (((
22 //příjemce notifikací skupiny - k doplnění//
23 )))
Josef Vencl 28.21 24 * Další příjemci notifikací mohou být přidáni jmenovitě ve Specifickém nastavení notifikace (viz níže ↓).
Josef Vencl 28.3 25
Josef Vencl 33.2 26 = Události (spouštěče notifikací) =
Josef Vencl 28.3 27
Josef Vencl 33.2 28 U každé události uvádíme krátký popis kontextu události, související obrazovky, ev. doporučené globální/lokální nasazení.
29
Josef Vencl 26.1 30 == Aktivace nové verze aktivity ==
31
Josef Vencl 33.3 32 Verze aktivity mohou být aktivovány ručně nebo může být jejich aktivace načasována. Oba způsoby spustí notifikaci.
Josef Vencl 33.2 33
Josef Vencl 33.4 34 * Související obrazovka: [[Detail aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail aktivity.WebHome]], tab Popis
Josef Vencl 27.1 35
Josef Vencl 26.1 36 == Založení nového uživatele ==
37
Josef Vencl 33.4 38 Uživatele v Competentu zakládáme jednotlivě nebo hromadně importem souboru. Oba způsoby spustí notifikaci.
Josef Vencl 33.3 39
Josef Vencl 33.4 40 * Doporučené nasazení: globální
41 * Související obrazovka: [[Obrazovka Lidé 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Lidé.WebHome]]
42 * Související ukázka: [[Import uživatelů ►>>doc:Main.Official manuals.Competent - Uživatelská příručka.Případy použití - Administrátor.Lidé.Import uživatelů.WebHome]]
Josef Vencl 27.1 43
Josef Vencl 26.1 44 == Zapomenuté heslo ==
45
Josef Vencl 33.4 46 Událost spouští uživatel z obrazovky Přihlášení.
Josef Vencl 27.1 47
Josef Vencl 33.4 48 * Související obrazovka: Přihlášení
49
Josef Vencl 26.1 50 == Přiřazení aktivity uživateli ==
51
Josef Vencl 33.5 52 Notifikace se odešle při vytvoření nové uživatelské aktivity.
Josef Vencl 27.1 53
Josef Vencl 33.5 54 * Související obrazovky: [[Detail aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail aktivity.WebHome]], tab Uživatelé, [[Detail sady 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail sady.WebHome]], tab Uživatelé.
55 * Související téma: Import dat
Josef Vencl 27.1 56
Josef Vencl 26.1 57 == Dokončení aktivity ==
58
Josef Vencl 33.5 59 Uživatelská aktivita změnila stav na Dokončeno s libovolným výsledkem.
60
Josef Vencl 26.1 61 == Úspěšné dokončení aktivity ==
62
Josef Vencl 33.5 63 Uživatel dokončil aktivit
64
Josef Vencl 26.1 65 == Neúspěšné dokončení aktivity ==
66
67 == Zrušení aktivity ==
68
69 == Potřeba vyhodnocení aktivity ==
70
71 == Změna emailu uživatele ==
72
73 == Ověření emailu uživatele ==
74
Josef Vencl 31.1 75 Spouštěč čeká na příkaz serveru Odeslat ověření e-mailu s parametrem Uživatelské ID. Takto zadanému uživateli je následně odeslán e-mail s odkazem pro ověření.
Josef Vencl 30.2 76
Josef Vencl 30.5 77 **Doporučené nastavení**
Josef Vencl 30.3 78
Josef Vencl 31.1 79 * Globální notifikace, Základní typ
Josef Vencl 30.4 80 * Základní šablona
81 * parametry v šabloně: link
82
Josef Vencl 30.5 83 **Související témata**
Josef Vencl 30.2 84
Josef Vencl 31.1 85 * [[Zasílání e-mailů 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Zasílání e-mailů.WebHome]]
Josef Vencl 30.5 86 * [[Uživatel 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Uživatel.WebHome]] - viz parametr emailVerified
Josef Vencl 31.1 87 * [[Příkazy serveru 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Příkazy serveru.WebHome]]
Josef Vencl 30.4 88
Josef Vencl 26.1 89 == Přiřazení hodnocení uživateli ==
90
91 == Dokončení hodnocení ==
92
93 == Úspěšné dokončení hodnocení ==
94
95 == Neúspěšné dokončení hodnocení ==
96
97 == Zrušení hodnocení ==
98
99 == Vyhodnocení pokusu hodnocení ==
100
101 == Aktualizace pokusu hodnocení ==
102
103 == Vyhodnocení pokusu aktivity ==
104
Josef Vencl 28.2 105 **Spouštěč není implementován**
106
Josef Vencl 26.1 107 == Aktualizace pokusu aktivity ==
108
109 == Aktualizace pokusu aktivity po vyhodnocení ==
110
111 == Aktualizace pokusu hodnocení po vyhodnocení ==
112
113 == Počet dní před datem splnění aktivity ==
114
Josef Vencl 28.2 115 **Spoštěč není implementován**
116
Josef Vencl 26.1 117 == Počet dní po datu splnění aktivity ==
118
Josef Vencl 28.2 119 **Spouštěč není implementován**
120
Josef Vencl 26.1 121 == Počet dní před datem splnění hodnocení ==
122
Josef Vencl 28.2 123 **Spouštěč není implementován**
124
Josef Vencl 26.1 125 == Počet dní po datu splnění hodnocení ==
126
Josef Vencl 28.2 127 **Spouštěč není implementován**
128
Josef Vencl 26.1 129 == Prodloužení přístupu k aktivitě ==
130
Josef Vencl 28.3 131 Akce se provede ve chvíli, kdy je přístup uživatele k aktivitě automaticky prodloužen (viz [[Automaticky prodloužený přístup k aktivitě 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Automaticky prodloužený přístup k aktivitě.WebHome]]).
Josef Vencl 26.1 132
133 == Prodloužení přístupu k hodnocení ==
134
Josef Vencl 28.2 135 Akce se provede ve chvíli, kdy je přístup uživatele k hodnocení automaticky prodloužen (viz [[Automaticky prodloužený přístup k aktivitě 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Automaticky prodloužený přístup k aktivitě.WebHome]]).
Josef Vencl 26.1 136
137 == Začátek přístupu k aktivitě ==
138
Josef Vencl 27.1 139 Související obrazovky: [[Detail uživatele 💻>>]], tab Aktivity; [[Detail aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail aktivity.WebHome]], tab Uživatelé
140
141 Související obrazovky studentského modu: [[Obrazovka Nástěnka 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Studentské rozhraní.Obrazovka Nástěnka.WebHome]]; [[Obrazovka Aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Studentské rozhraní.Obrazovka Aktivity.WebHome]]; [[Obrazovka Detail uživatelské aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Studentské rozhraní.Obrazovka Aktivity.Obrazovka Detail uživatelské aktivity.WebHome]]
142
Josef Vencl 26.1 143 == Začátek přístupu k hodnocení ==
144
Josef Vencl 27.1 145 Související obrazovky: [[Detail uživatele 💻>>]], tab Hodnocení; [[Detail hodnocení 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Hodnocení.WebHome]], tab Uživatelé
146
147 Související obrazovky studentského modu: [[Obrazovka Hodnocení 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Studentské rozhraní.Obrazovka Hodnocení.WebHome]]; [[Obrazovka Detail hodnocení 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Studentské rozhraní.Obrazovka Hodnocení.Detail hodnocení.WebHome]]
148
Josef Vencl 28.17 149 == Agregační skupina ==
150
Josef Vencl 29.5 151 Speciální typ notifikace sloužící k seskupení více různých dalších notifikací do jedné zprávy, která se jednou denně odešle příjemci. Notifikace použije hlavičku a patičku agregační e-mailové šablony a naplní ji těly notifikací, které jsou pod ní seskupeny. Pro účely odeslání agregačního e-mailu jsou ignorována některá nastavení na agregační skupině a na dílčích dílčích notifikacích:
Josef Vencl 28.17 152
Josef Vencl 29.6 153 **Ignorováno na agregační skupině**
Josef Vencl 29.5 154
155 * Tělo šablony notifikace
156
157 **Ignorováno na dílčí notifikaci**
158
Josef Vencl 28.26 159 * Hlavička a Patička šablony notifikace
160 * Notifikace se odesílá ... - všechny parametry určující příjemce dílčích notifikací
161 * Některé parametry Specifického nastavení:
162 ** Emails
163 ** Groups
164 ** //Custom//
165
Josef Vencl 29.6 166 == Doporučené nastavení v agregační skupině ==
Josef Vencl 28.17 167
Josef Vencl 29.1 168 * typ šablony: Agregovaná
Josef Vencl 30.1 169 * typ dílčí šablony: Základní (nepoužije se hlavička a patička)
Josef Vencl 29.1 170 * typ notifikace: Agregovaná
Josef Vencl 29.9 171 * (% class="box warningmessage" %)
172 (((
Josef Vencl 30.1 173 typ dílčí notifikace: Základní - toto nastavení se zřejmě v agregační skupině neprojeví
Josef Vencl 29.9 174 )))
Josef Vencl 28.17 175
Josef Vencl 28.22 176 = Specifické nastavení =
Josef Vencl 28.21 177
Josef Vencl 32.2 178 Notifikaci můžeme dále ladit parametry Specifického nastavení. Jedná se o objekt typu JSON a v modálovém okně Notifikace jej upravujeme pomocí grafického editoru. Vlastnosti:
Josef Vencl 28.22 179
Josef Vencl 28.23 180 * Aggregation - napojení na spouštěč Agregační skupina, který tuto notifikaci zařadí mezi další upozornění v této skupině
Josef Vencl 29.2 181 ** ##emailTemplateUsageId - number[]## - seznam identifikátorů agregačních notifikací, do nichž bude tato notifikace začleněna.
Josef Vencl 29.3 182 * Enrich - ##string[] ##(výběr z menu) - seznam tříd, které rozšíří data dostupná pro šablonu e-mailu, takže do ní bude možné dosadit další značky. V tuto chvíli nejsou dostupné žádné obecně dostupné třídy, pouze vytvořené na míru pro jednotlivé klienty.
183 * Emails - pevně stanovené e-maily, na které se notifikace také odešle
184 ** ##emailList - string[] ##- seznam e-mailů oddělených čárkami
Josef Vencl 33.1 185 * Custom - ##{classname: config}[] ##- dynamické stanovení příjemce e-mailu na základě události, přp. jiná akce. Classname stanoví třídu pro spuštění, zatímco volitelný Config dodá případné parametry. V tuto chvíli nejsou dostupné obecně dostupné třídy, pouze vytvořené na míru pro klienty.
Josef Vencl 29.5 186 * Groups - ##{groupNameList: objectRoleList}[]## - pevně stanovené skupiny a uživatelské role v nich, kterým se notifikace také odešle
Josef Vencl 28.22 187
Josef Vencl 32.2 188 [[image:Modal-Notification-annotated.png]]
Josef Vencl 31.2 189
Josef Vencl 32.2 190 Grafický nástroj pro editaci JSON. Obsahuje všechny uvedené parametry:
191
192 * **(1)** Aggregation - emailTemplateUsageId. Pomocí tlačítka **+** je možné přidat další vazby na Agregovanou notifikaci.
Josef Vencl 33.1 193 * **(2)** Enrich - po klikntí na tlačítko **+** zobrazí k výběru dostupné rozšiřující třídy
194 * **(3)** Emails - emailList. Textové pole obsahuje e-mailové adresy oddělené čárkou. Alternativně lze také přidat další řádky.
195 * **(4)** Custom
196 * **(5)** Groups - pole objektů, v němž jsou pod klíčem názvu skupiny vypsány role, jejichž nositelé budou z dané skupiny obesláni.
Josef Vencl 32.2 197
Josef Vencl 26.1 198 (% class="box infomessage" %)
199 (((
Josef Vencl 33.1 200 Aktualizováno na verzi 185
Josef Vencl 26.1 201 )))