Wiki source code of Notifikace

Last modified by Josef Vencl on 2021/11/26 07:45

version	line-number	content
24.1	1	(% class="box" %)
	2	(((
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.
24.1	4	)))
20.1	5
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.
20.1	7
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.
26.1	9
28.16	10	= Adresáti notifikací =
	11
28.17	12	Adresátem notifikace může být pouze uživatel spojený se spuštěnou akcí. Jsou to:
26.1	13
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
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	)))
28.21	24	* Další příjemci notifikací mohou být přidáni jmenovitě ve Specifickém nastavení notifikace (viz níže ↓).
28.3	25
33.2	26	= Události (spouštěče notifikací) =
28.3	27
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
26.1	30	== Aktivace nové verze aktivity ==
	31
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.
33.2	33
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
27.1	35
26.1	36	== Založení nového uživatele ==
	37
33.4	38	Uživatele v Competentu zakládáme jednotlivě nebo hromadně importem souboru. Oba způsoby spustí notifikaci.
33.3	39
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]]
27.1	43
26.1	44	== Zapomenuté heslo ==
	45
33.4	46	Událost spouští uživatel z obrazovky Přihlášení.
27.1	47
33.4	48	* Související obrazovka: Přihlášení
	49
26.1	50	== Přiřazení aktivity uživateli ==
	51
33.5	52	Notifikace se odešle při vytvoření nové uživatelské aktivity.
27.1	53
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
27.1	56
26.1	57	== Dokončení aktivity ==
	58
33.5	59	Uživatelská aktivita změnila stav na Dokončeno s libovolným výsledkem.
	60
26.1	61	== Úspěšné dokončení aktivity ==
	62
33.6	63	Uživatel splnil aktivitu.
33.5	64
26.1	65	== Neúspěšné dokončení aktivity ==
	66
33.6	67	Uživatelský přístup k aktivitě vypršel, než ji uživatel stihl splnit, přp. vypršely pokusy.
	68
26.1	69	== Zrušení aktivity ==
	70
33.6	71	Uživatelský přístup byl zrušen.
	72
	73	* 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]]
	74
26.1	75	== Potřeba vyhodnocení aktivity ==
	76
	77	== Změna emailu uživatele ==
	78
	79	== Ověření emailu uživatele ==
	80
31.1	81	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í.
30.2	82
30.5	83	Doporučené nastavení
30.3	84
31.1	85	* Globální notifikace, Základní typ
30.4	86	* Základní šablona
	87	* parametry v šabloně: link
	88
30.5	89	Související témata
30.2	90
31.1	91	* [[Zasílání e-mailů 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Zasílání e-mailů.WebHome]]
30.5	92	* [[Uživatel 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Uživatel.WebHome]] - viz parametr emailVerified
31.1	93	* [[Příkazy serveru 📖>>doc:Main.Official manuals.Competent - Uživatelská příručka.Slovník.Příkazy serveru.WebHome]]
30.4	94
26.1	95	== Přiřazení hodnocení uživateli ==
	96
	97	== Dokončení hodnocení ==
	98
	99	== Úspěšné dokončení hodnocení ==
	100
	101	== Neúspěšné dokončení hodnocení ==
	102
	103	== Zrušení hodnocení ==
	104
	105	== Vyhodnocení pokusu hodnocení ==
	106
	107	== Aktualizace pokusu hodnocení ==
	108
	109	== Vyhodnocení pokusu aktivity ==
	110
28.2	111	Spouštěč není implementován
	112
26.1	113	== Aktualizace pokusu aktivity ==
	114
	115	== Aktualizace pokusu aktivity po vyhodnocení ==
	116
	117	== Aktualizace pokusu hodnocení po vyhodnocení ==
	118
	119	== Počet dní před datem splnění aktivity ==
	120
28.2	121	Spoštěč není implementován
	122
26.1	123	== Počet dní po datu splnění aktivity ==
	124
28.2	125	Spouštěč není implementován
	126
26.1	127	== Počet dní před datem splnění hodnocení ==
	128
28.2	129	Spouštěč není implementován
	130
26.1	131	== Počet dní po datu splnění hodnocení ==
	132
28.2	133	Spouštěč není implementován
	134
26.1	135	== Prodloužení přístupu k aktivitě ==
	136
28.3	137	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]]).
26.1	138
	139	== Prodloužení přístupu k hodnocení ==
	140
28.2	141	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]]).
26.1	142
	143	== Začátek přístupu k aktivitě ==
	144
27.1	145	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é
	146
	147	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]]
	148
26.1	149	== Začátek přístupu k hodnocení ==
	150
27.1	151	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é
	152
	153	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]]
	154
28.17	155	== Agregační skupina ==
	156
29.5	157	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:
28.17	158
29.6	159	Ignorováno na agregační skupině
29.5	160
	161	* Tělo šablony notifikace
	162
	163	Ignorováno na dílčí notifikaci
	164
28.26	165	* Hlavička a Patička šablony notifikace
	166	* Notifikace se odesílá ... - všechny parametry určující příjemce dílčích notifikací
	167	* Některé parametry Specifického nastavení:
	168	** Emails
	169	** Groups
	170	** //Custom//
	171
29.6	172	== Doporučené nastavení v agregační skupině ==
28.17	173
29.1	174	* typ šablony: Agregovaná
30.1	175	* typ dílčí šablony: Základní (nepoužije se hlavička a patička)
29.1	176	* typ notifikace: Agregovaná
29.9	177	* (% class="box warningmessage" %)
	178	(((
30.1	179	typ dílčí notifikace: Základní - toto nastavení se zřejmě v agregační skupině neprojeví
29.9	180	)))
28.17	181
28.22	182	= Specifické nastavení =
28.21	183
32.2	184	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:
28.22	185
28.23	186	* Aggregation - napojení na spouštěč Agregační skupina, který tuto notifikaci zařadí mezi další upozornění v této skupině
29.2	187	** ##emailTemplateUsageId - number[]## - seznam identifikátorů agregačních notifikací, do nichž bude tato notifikace začleněna.
29.3	188	* 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.
	189	* Emails - pevně stanovené e-maily, na které se notifikace také odešle
	190	** ##emailList - string[] ##- seznam e-mailů oddělených čárkami
33.1	191	* 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.
29.5	192	* Groups - ##{groupNameList: objectRoleList}[]## - pevně stanovené skupiny a uživatelské role v nich, kterým se notifikace také odešle
28.22	193
32.2	194	[[image:Modal-Notification-annotated.png]]
31.2	195
32.2	196	Grafický nástroj pro editaci JSON. Obsahuje všechny uvedené parametry:
	197
	198	* (1) Aggregation - emailTemplateUsageId. Pomocí tlačítka + je možné přidat další vazby na Agregovanou notifikaci.
33.1	199	* (2) Enrich - po klikntí na tlačítko + zobrazí k výběru dostupné rozšiřující třídy
	200	* (3) Emails - emailList. Textové pole obsahuje e-mailové adresy oddělené čárkou. Alternativně lze také přidat další řádky.
	201	* (4) Custom
	202	* (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.
32.2	203
26.1	204	(% class="box infomessage" %)
	205	(((
33.1	206	Aktualizováno na verzi 185
26.1	207	)))