= Konfiguracja systemowych powiadomień =

== Wprowadzenie ==
System eDokumenty posiada wbudowany mechanizm powiadomień, który odpowiada za powiadamianie określonych użytkowników o wybranych zdarzeniach, które zaszły w odniesieniu do określonych obiektów przy użyciu wybranego kanału komunikacji z użytkownikiem.

Obsługiwane zdarzenia:
 * dodanie dokumentu
 * dodanie zdarzenia w kalendarzu (np. zadania, spotkania)
 * dodanie komentarza

Obsługiwane kanały dystrybucji:
 * komunikator systemowy
 * poczta email
 * dokument

== Konfiguracja ==
Konfiguracja powiadamiania realizowana jest poprzez aktywację/deaktywację powiadamiania dla danego zdarzenia na danym obiekcie oraz określenie odpowiadającego mu kanału dystrybucji.

Aktywacja/deaktywacja odbywa się poprzez ustawienie właściwej wartości stałych w pliku config.inc.

Konfiguracja kanałów dystrybucji odbywa się poprzez modyfikację wartości w kolumnie ''notify'' dla danej klasy określonej w kolumnie ''class'' w tabeli ''observers_config''. Obsługiwane wartości dla kolumny ''notify'' to:
 * ''Communicator'' - komunikator
 * ''Mail'' - poczta e-mail
 * ''Document'' - dokument
Dopuszczalne jest określenie wielu kanałów dystrybucji dla danej klasy. W takim przypadku należy w polu ''notify'' wpisać odpowiednie wartości oddzielone przecinkiem (np. ''Communicator, Mail'');

Poniżej wymienione zostały poszczególne rodzaje powiadomień obsługiwane przez system eDokumenty wraz z informacją o odpowiadającej stałej sterującej w pliku config.inc oraz klasie w tabeli ''observers_config'' w postaci:

[nazwa stałej w pliku config.inc] / [klasa w tabeli obserers_config] - [opis]

=== Sprawy ===
Powiadamiani są wszyscy użytkownicy uprawnieni w sprawie do otrzymywania powiadomień. 

''Uwaga! '' [[BR]]
''Powiadomienia o nowych komentarzach do dokumentów w sprawie wysyłane są do użytkownika, który utworzył dokument oraz do wszystkich użytkowników, którzy dodali co najmniej jeden komentarz do tego dokumentu.''

'''NOTIFY_PROCESSES_DOCUMENTS''' / '''ProcessesDocumentsObserver''' - powiadamianie o nowych dokumentach w sprawie[[BR]]
'''NOTIFY_PROCESSES_TASKS''' / '''ProcessesTasksObserver''' - powiadamianie o nowych zdarzeniach w sprawie (np. zadania, spotkania, itd.)

=== Użytkownicy ===
Powiadamiani są użytkownicy, którym przypisano dane zdarzenie

 - '''NOTIFY_USERS_TODO''' / '''UsersToDoObserver''' - powiadamianie o przydzieleniu zadania[[BR]]
 - '''NOTIFY_USERS_MEETING''' / '''UsersMeetingsObserver''' - powiadamianie o przydzieleniu spotkania[[BR]]
 - '''NOTIFY_USERS_RCP''' / '''UsersRCPObserver''' - powiadamianie o przydzieleniu czynności RCP[[BR]]
 - '''NOTIFY_USERS_PHONECALL''' / '''UsersPhonecallObserver''' - powiadamianie o przydzieleniu rozmowy telefonicznej[[BR]]
 - '''NOTIFY_SUPERVISOR_TODO''' / '''SupervisorToDoObserver''' - powiadamianie przełożonego o nowych zadaniach[[BR]]
 - '''NOTIFY_WORKFLOW_TODO''' - powiadamianie o przydzieleniu zadania przez workflow na podstawie konfiguracji etapu procedury
 - '''NOTIFY_USERS_CORPEVENT''' - powiadamianie o przydzieleniu wydarzenia korporacyjnego (od wersji 6.0.3, 5.2.39)

=== Pozostałe ustawienia ===
Pozostałe ustawienia mechanizmu powiadomień znajdujące się w pliku config.inc

'''MAX_NOTIFY_DSCRPT_LENGTH''' - maksymalna długość tekstu w powiadomieniu lub 0 jeśli powiadomienie ma zawierać pełny tekst. Dane dodatkowe dołączane do treści powiadomienia nie są wliczane.[[BR]]