Instrukcja konfiguracji powiadomień Dotyczy wersji:
Spis treści 1. Wstęp 3 2. Konfiguracja parametrów powiadomień. 4 3. Konfiguracja SMTP 5 4. Konfiguracja SMS 6 5. Konfiguracja SMTP/SMS możliwość wysłania wiadomości 6 testowej 6. Konfiguracja domyślnych treści powiadomień SMS oraz 7 E-mail. 7. Mechanizm wysyłania powiadomień usługa Agent. 10 8. Konfiguracja danych pacjenta. 11 2
1 Wstęp Konfiguracja parametrów wysyłki powiadomień wykonywana jest za pośrednictwem modułu Administracja. Dostęp do modułu Administracja jest możliwy po zalogowaniu się do systemu oraz po przydzieleniu zalogowanemu użytkownikowi roli administratora systemu. Rysunek 1. Przycisk logow ania do m odułu Adm inistracja. Ekran głów ny system u Optim ed24 Jeśli oba te warunki są spełnione, kliknięcie w głównym oknie aplikacji przycisku Administracja, przeniesie użytkownika do tego modułu. Po wybraniu przycisku Administracja zostanie uruchomiony moduł, w wyglądzie zbliżonym do przestawionego poniżej. Rysunek 2. Okno głów ne w m odułu Adm inistracja. Aby przejść do okna konfiguracji powiadomień należy wybrać z górnego panelu okna przycisk Konfiguracja, a następnie Moduły. Lewa część okna Moduły, zawiera strukturę drzewa. Przedostatnią gałęzią są Rozdział 1 - Wstęp 3
Powiadomienia. W skład konfiguracji powiadomień wchodzą: Parametry powiadomień, Konfiguracja SMTP, Konfiguracja SMS, Treść powiadomień. Rysunek 3. Lista konfiguracji m odułów w centrum. Moduł Adm inistracja. 2 Konfiguracja parametrów powiadomień. W tej części aplikacji wyświetlane są parametry dla mechanizmu powiadomień. Aby zmienić ustawienia dotyczące danej własności, należy kliknąć w kłódkę obok wyszukiwarki, spowoduje to odblokowanie wierszy a tym samym umożliwi ich edycję. Następnie należy wybrać wiersz i w kolumnie Wartość wpisać nową wartość lub odznaczyć/ zaznaczyć pole w zależności od wybranego parametru. Po wprowadzeniu odpowiednich zamian, dla poszczególnych parametrów, należy nacisnąć przycisk Zapisz, aby zapamiętać wprowadzone zmiany lub Anuluj, aby powrócić do wartości poprzednich. Rozdział 1 - Wstęp 4
Parametr NOTIF_NOTIFICATIONS_WS_ADDRESS jest to adres usługi powiadomień (WebService) pole nieedytowalne. Parametr NOTIF_NOTIFICATIONS_PROCESSOR_SLEEP_TIMEOUT określa czas (w sekundach) usypiania wątku wysyłającego powiadomienia. Domyślnie wartość ta wynosi 600 i oznacza to, że co 600 sekund wątek wysyłający powiadomienia będzie uruchamiany i będzie sprawdzane czy są jakieś nowe powiadomienia do wysyłki. Parametr NOTIF_NOTIFICATIONS_BATCH_SIZE definiuje rozmiar pojedynczej paczki danych wysyłanych do usługi powiadomień liczony osobno, dla każdego typu powiadomienia SMS lub e-mail. Parametr ten jest nieedytowalny. Parametr NOTIF_NOTIFICATIONS_HOURS informuje na ile godzin przed, mają być wysyłane powiadomienia z przypomnieniem o rezerwacji wizyty. Jeżeli termin wizyty rezerwowany jest w czasie krótszym, niż ustalony w tym parametrze, nie zostaną wysłane żadne powiadomienia. Za pomocą parametrów NOTIF_NIGHT_HOUR_FROM oraz NOTIF_NIGHT_HOUR_TO definiuje się przedział czasowy, w którym powiadomienia nie będą wysyłane. NOTIF_NIGHT_HOUR_FROM godzina, od której powiadomienia nie będą wysyłane (w systemie 24h). NOTIF_NIGHT_HOUR_TO godzina, do której powiadomienia nie będą wysyłane (w systemie 24h). Rysunek 4.Lista param etrów system ow ych pow iadom ień. Moduł Adm inistracja. 3 Konfiguracja SMTP Konfiguracja SMTP dotyczy powiadomień typu e-mail: SMTP_USER adres e-mail/użytkownik serwera SMTP jest to adres, z jakiego będą wysyłane powiadomienia, Rozdział 2 - Konfiguracja parametrów powiadomień. 5
SMTP_SSL_ENABLED włączanie/wyłączanie SSL, SMTP_REPLY_TO ustawienie nadawcy powiadomień e-mail, np. Przychodnia Zdrowie, SMTP_PORT port SMTP domyślnie 25, SMTP_PASS hasło do serwera SMTP, SMTP_EMAIL_ENABLED parametr służący do włączania/wyłączania obsługi powiadomień e-mail, SMTP_ADRESS adres serwera SMTP dla mechanizmu powiadomień. 4 Konfiguracja SMS Konfiguracja SMS zawiera 3 parametry: SMS_USE_SHORT_DATE_FORMAT parametr służący do sterowania formatem daty w wysyłanym powiadomieniu (krótki format daty (liczbowy) to RRRR-MMDD). SMS_UNICODE_ENABLED parametr służący do włączania/wyłączania kodowania wysyłanych SMS ów z polskimi znakami SMS_ENABLED parametr służący do włączania/wyłączania usługi SMS 5 Konfiguracja SMTP/SMS możliwość wysłania wiadomości testowej Dodano możliwość sprawdzenia poprawności konfiguracji za pomocą przycisku Testuj konfigurację znajdującego się w module Administracja -> Konfiguracja -> Moduły -> Powiadomienia -> Konfiguracja SMTP/Konfiguracja SMS. Rozdział 3 - Konfiguracja SMTP 6
Rysunek 5. Konfiguracja testow ego pow iadom ienia em ail W powyższym przypadku, aby wysłać emaila testowego należy w polu Adres email wpisać email osoby do której ma zostać wysłana wiadomość oraz treść wiadomości a następnie potwierdzić kliknięciem w przycisk OK. Analogicznie należy postąpić podczas wysyłania testowego smsa, z tym, że należy podać numer komórkowy. Dzięki tej funkcjonalności użytkownik może upewnić się, iż usługa powiadomień została poprawnie skonfigurowana. 6 Konfiguracja domyślnych treści powiadomień SMS oraz E-mail. Kolejna gałąź drzewa Powiadomienia to Treść powiadomień. Tutaj istnieje możliwość zdefiniowania własnych treści powiadomień, które będą wysyłane podczas odpowiednich zdarzeń, np. rejestracja pacjenta na wizytę czy przypomnienie o wizycie. Aby zmienić domyślne treści powiadomień należy kliknąć ikonę kłódki ( ) znajdującą się nad listą powiadomień. Następnie należy wybrać z listy typ zdarzenia, dla którego chcemy zmienić treść powiadomienia oraz rodzaj powiadomienia SMS lub e-mail. Przy tworzeniu treści powiadomienia dostępne są parametry, które używane będą podczas wysyłania powiadomień dla konkretnego zdarzenia: <PRZYCHODNIA> - pobiera nazwę przychodni powiązanej ze zdarzeniem, <DATA> - pobiera datę wizyty (wraz z godziną i dniem tygodnia) powiązaną ze zdarzeniem, <ADRES> - pobiera adres przychodni powiązanej ze zdarzeniem, Rozdział 5 - Konfiguracja SMTP/SMS możliwość wysłania wiadomości testowej 7
<SWIADCZENIA> - pobiera świadczenia na jakie zarejestrowany jest pacjent. Należy pamiętać, że wszelkie ustawienia konfiguracji pobierane są dopiero w momencie wysyłki powiadomienia. Domyślnie powiadomienia w systemie są wyłączone. Aby powiadomienie należy zaznaczyć odpowiednie pole zaznaczenia ( włączyć dane ) w kolumnach SMS lub e-mail w zależności jaki typ powiadomienia chcemy włączyć. Wyłączenie odbywa się analogicznie poprzez odznaczenie odpowiedniego pola zaznaczenia ( ). Rysunek 6.Treści pow iadom ień. Moduł Adm inistracja. Istnieje także możliwość zdefiniowania treści domyślnych powiadomień dla poszczególnych poradni. W tym celu należy nacisnąć przycisk Dodaj w prawym dolnym panelu okna, a następnie wybrać z listy typ zdarzenia, dla jakiego ma zostać utworzona treść powiadomienia. Dostępne typy zdarzeń to: anulowanie terminu rezerwacji, potwierdzenie rejestracji, potwierdzenie rejestracji Online, przypomnienie o rezerwacji, przypomnienie o rezerwacji Online, Rozdział 6 - Konfiguracja domyślnych treści powiadomień SMS oraz E-mail. 8
rezerwacja Online, wizyty cykliczne, zmiana terminu rezerwacji. Po wybraniu odpowiedniego typu, pojawi się okienko, w którym należy podać, dla jakiej poradni utworzona zostanie treść powiadomienia. Rysunek 7.Wybór przychodni - treści pow iadom ień. Moduł Adm inistracja. Po wybraniu odpowiedniej poradni i kliknięciu OK treść powiadomienia zostanie dodana do listy. W tabeli Treść powiadomień istnieje dodatkowa możliwość grupowania treści powiadomień względem wybranej kolumny. Domyślnie grupowanie odbywa się względem poradni. Można to zmienić odpowiednio przeciągając nagłówek kolumny na pole znajdujące się nad tabelą lub analogicznie z pola do tabeli. Rysunek 8.Treści pow iadom ień pogrupow ane w zględem Poradni. Moduł Adm inistracja. Rozdział 6 - Konfiguracja domyślnych treści powiadomień SMS oraz E-mail. 9
7 Mechanizm wysyłania powiadomień usługa Agent. Aby system powiadomień działał, konieczne jest posiadanie uruchomionej usługi systemowej Agent, która uruchamiana jest domyślnie przy starcie systemu. Może jednak zdarzyć się tak, że z przyczyn losowych usługa ta nie uruchomi się. Aby sprawdzić czy usługa jest uruchomiona należy w systemie Windows przejść do Menu Start Uruchom i wpisać services.msc, a następnie kliknąć Enter. Otworzy się okno z listą wszystkich usług lokalnych. Rysunek 9.Usługi lokalne system u Window s. Należy wyszukać usługę Agentxxxx, gdzie xxxx to numer jednostki c uid. usługa jest wyłączona (kolumna stan-> pusta) można nacisnąć Uruchom, co spowoduje jej włączenie. Innym sposobem włączenia usługi Agent jest przejście do menu Start >Programy -> i kliknięcie Agent uruchom usługę. Opcja ta będzie dostępna, jeśli w trakcie instalacji oprogramowania w ostatnim kroku została wybrana opcja Dodaj do Menu Start. Rysunek 10.Włączanie usługi AgentOptim ed24 z poziom u Menu Start w system ie Window s. Rozdział 7 - Mechanizm wysyłania powiadomień usługa Agent. 10
Uwaga! W momencie, gdy na jednym komputerze jest zainstalowanych kilka jednostek, a co za tym idzie kilka usług Agent w celu włączenia/wyłączenia odpowiedniej usługi należy znać jej numer cuid, który można sprawdzić dla danej jednostki w module Administracja ->Diagnostyka -> Komunikacja. 8 Konfiguracja danych pacjenta. Aby pacjenci mogli otrzymywać powiadomienia SMS lub e-mail należy odpowiednio uzupełnić ich dane. Można to zrobić na przykład w module Rejestracja wybierając Rejestr pacjentów, a następnie wyszukując danego pacjenta i klikając Edytuj. W formatce Dane pacjenta należy zaznaczyć odpowiednie pola wyboru (Zgoda SMS, Zgoda e-mail) jest to niezbędne jeśli powiadomienia mają być wysyłane bez zaznaczenia tych pól nawet przy obecnym numerze telefonu oraz adresie e-mail powiadomienia nie będą wysyłane. Kolejno należy podać prawidłowy numer telefonu pacjenta oraz adres e-mail, a następnie kliknąć Zapisz. Rysunek 11. Okno edycji pacjenta. Rozdział 7 - Mechanizm wysyłania powiadomień usługa Agent. 11