Moduł wiadomości do użytkowników Konfiguracja - e

Moduł wiadomości do użytkowników
Spis treści
1 Konfiguracja modułu
2 Obsługa modułu
2.1 Wiadomości zwykłe
2.1.1 Dodawanie nowej wiadomości
2.2 Wiadomości automatyczne
2.2.1 Przykładowa reguła
2.3 Dodatkowa konfiguracja w pliku jobs.xml na serwerze
2.3.1 Brak ubezpieczenia pacjenta przebywającego na oddziale
2.3.2 Brak danych osobowych pacjenta
2.4 Odczytywanie wiadomości
Konfiguracja modułu
Moduł wiadomości do użytkowników służy do wysyłania powiadomień do innych użytkowników systemu. Dzieli się on na dwa segmenty ­
segment wiadomości zwykłych (definiowanych przez użytkowników) i wiadomości automatycznych (wysyłanych po wystąpieniu konkretnego
zdarzenia w systemie).
UWAGA: funkcjonalność działa w przeglądarkach Mozilla Firefox, Opera i Google Chrome. Na przeglądarkach Internet Explorer
treść przesyłanych do użytkownika wiadomości może być nieczytelna. Zalecamy użycie alternatywnych przeglądarek.
Konfiguracja modułu sprowadza się do ustawienia parametru USER_MESSAGES_PROPS. W parametrze tym powinny się znaleźć
następujące wartości:
servletName= ­ określa serwlet wyświetlający wiadomości dla użytkowników. Wartość ta jest ustalona w systemie na stałe, nie należy jej
zmieniać.
active= ­ (wartość true lub false) włączenie lub wyłączenie wyświetlania wiadomości, domyślnie wyłączone
autoRefresh ­ (wartość true lub false) włączenie automatycznego odświeżania wiadomości, domyślnie wyłączone
timeInterval ­ (liczba) określa w minutach częstotliwość pobierania (odświeżania) wiadomości. Minimalna wartość to 3, domyślną
wartością jest 5.
Dodatkowo należy ustalić priorytety wiadomości, aby móc oddzielić wiadomości ważne od tych mniej istotnych. W tym celu należy dodać
elementy do słownika systemowego L_MSG_PRIORITY ­ każdy element zdefiniowany w tym słowniku będzie traktowany jako nowy
priorytet wiadomości (na przykład: "informacja", "awaria", "pilne"). Definiując nowy element słownika należy podać następujące dane:
Kod ­ tutaj podajemy niepowtarzalny kod, pod którym element będzie występował w słowniku. Należy wpisać go bez polskich znaków,
np. "wazne"
Opis ­ jedno słowo, opisujące priorytet wiadomości, np. "Ważne" (słowo to będzie widoczne na liście przed treścią wiadomości)
Dane dodatkowe ­ w tym miejscu określamy kolor, jakim mają być wyróżnione na liście wiadomości o tym priorytecie (podajemy kod
koloru HTML lub wartość heksadecymalną, na przykład: green oznacza kolor zielony, #ff0000 oznacza kolor czerwony). Jeśli nie
wpiszemy żadnej wartości, wiadomości nie będą wyróżniane.
Po wypełnieniu słownika elementami mechanizm jest gotowy do działania.
Obsługa modułu
Wiadomości zwykłe
Dodawanie nowej wiadomości
Jeśli moduł jest włączony i mamy odpowiednie uprawnienia, na ekranie pojawi się zakładka Wiadomości. Po uruchomieniu mechanizmu jest
ona pusta, użytkownicy posiadający uprawnienia mogą dodawać do niej nowe wiadomości. Dodanie wiadomości odbywa się poprzez link
Dodaj widoczny ponad listą wiadomości.
Przykładowy ekran dodawania nowej wiadomości widać poniżej:
W górnej części ekranu znajduje się pole tekstowe przeznaczone na wpisanie tekstu wiadomości. Poniżej możemy określić:
Priorytet wiadomości, spośród wcześniej ustalonych
Czas, w jakim wyświetlona ma być wiadomość (dzięki temu można planować wiadomości na przyszłość, jak również określić czas, po
którym wiadomość zniknie automatycznie, mimo braku zatwierdzenia przez użytkownika)
Konkretnego użytkownika, dla którego ma być przeznaczona wiadomość
lub
Klasy użytkowników, dla których ma być przeznaczona wiadomość.
Po wypełnieniu tych pól zatwierdzamy formularz przyciskiem OK. Wiadomość pojawi się na liście. Przykładowa lista wiadomości jest widoczna
poniżej:
Używając linków widocznych po prawej stronie można wyedytować daną wiadomość, podejrzeć jej potwierdzenia przeczytania lub też ją
usunąć.
Wiadomości automatyczne
Do konfiguracji segmentu wiadomości automatycznych służy link Ustawienia wiadomości automatycznych widoczny na zakładce
Wiadomości. Po kliknięciu na niego zostaniemy przeniesieni do listy zdefiniowanych reguł. Klikamy na link Dodaj i pojawia się ekran
definiowania reguły, wyglądający tak jak poniżej:
Znaczenie poszczególnych pól omówiono poniżej:
Działanie ­ w tym polu wybieramy zdarzenie, które musi wystąpić aby wiadomość została wysłana. Przykładowo: jeśli wybierzemy
widoczną na ekranie wartość Stworzenie karty zakażenia, to system będzie wysyłał wiadomość za każdym razem kiedy zostanie stworzona
karta tego typu.
UWAGA: obsługa zdarzeń oznaczonych gwiazdką (*) wymaga dodatkowej konfiguracji na serwerze. Informacje na temat dodatkowej
konfiguracji tego ekranu omówiono w dalszej części tego podręcznika.
Możliwe do wyboru działania to:
Brak ubezpieczenia pacjenta przebywającego na oddziale (*) ­ wiadomość zostanie wysłana, jeśli pacjent aktualnie
przebywający na oddziale nie ma ubezpieczenia
Brak danych osobowych pacjenta (*) ­ wiadomość zostanie wysłana, jeśli w systemie znalazł się pacjent bez kompletu danych
osobowych
Komunikat po zmianie/dodaniu zlecenia leku ­ wiadomość zostanie wysłana, jeśli dodano lub zmieniono zlecenie leków dla
jakiegokolwiek pacjenta
Powrót wyników alert patogen ­ wiadomość zostanie wysłana, jeśli wyniki do karty ALERT PATOGEN zostały zapisane w
systemie
Stworzenie karty zakażenia ­ wiadomość zostanie wysłana, jeśli stworzono nową kartę zakażenia dla pacjenta
Szczepienie noworodków, gruźlica do 24h ­ przypomnienie o szczepieniu noworodka na gruźlicę w pierwszej dobie życia
noworodka
Szczepienie noworodków, WZW do 12h ­ przypomnienie o szczepieniu noworodka na WZW w ciągu pierwszych 12 godzin
życia noworodka
Badania przesiewowe noworodków po 3 dobie ­ przypomnienie o badaniu przesiewowym noworodka po 3 dobie życia
Badania przesiewowe noworodków po 5 dobie ­ przypomnienie o badaniu przesiewowym noworodka po 5 dobie życia
Zrealizowanie zamówienia przez aptekę ­ wiadomość zostanie wysłana za każdym razem, gdy apteka zrealizuje zamówienie
Skierowanie zamówienia do apteki ­ wiadomość zostanie wysłana za każdym razem gdy jednostka wewnętrzna złoży zamówienie
do apteki
Aktywna ­ jeśli to pole nie zostanie zaznaczone (domyślnie jest zaznaczone), to reguła nie będzie działać.
Priorytet ­ analogicznie do wiadomości zwykłych, w tym polu wybiera się jaki priorytet ma mieć wysyłana wiadomość.
Do ­ w tym polu wybieramy adresatów wiadomości. Możemy wybrać spośród następujących:
Personel jednostki, której dotyczy zdarzenie
Aktualnie zalogowany personel jednostki, której dotyczy zdarzenie
Personel wskazanej jednostki
Aktualnie zalogowany personel wskazanej jednostki
Cały personel danego typu
Aktualnie zalogowany personel danego typu
Konkretny użytkownik
Konkretne stanowisko
Po wybraniu wartości wymagającej dodatkowego uszczegółowienia (np. "Personel wskazanej jednostki") pojawi się dodatkowe pole, w którym
będzie można to zrobić.
Czas wyświetlania ­ czas (w godzinach), po których wiadomość przestanie być wyświetlana.
Przykładowa reguła
Załóżmy, że reguła została wypełniona w sposób następujący:
W powyższym przykładzie za każdym razem kiedy zamówienie zostanie skierowane do apteki (pole "działanie") zostanie wysłana wiadomość o
priorytecie "wysoki" (pole "priorytet") do użytkowników konkretnej jednostki (pole "Zakres personelu"), a mianowicie APTEKI SZPITALNEJ
(pole "Personel jednostki org."). Wiadomość wyświetlana będzie przez 24 godziny (pole "czas wyświetlania"), o ile użytkownik nie kliknie
wcześniej przycisku "zapoznałem się, ukryj".
Po wypełnieniu wszystkich pól zapisujemy formularz przyciskiem OK.
Dodatkowa konfiguracja w pliku jobs.xml na serwerze
Uwaga: wszelkie zmiany dokonane w pliku jobs.xml zadziałają dopiero po ponownym uruchomieniu serwera Tomcat.
Dwa spośród zdarzeń obsługiwanych przez wiadomości automatyczne wymagają dodatkowej konfiguracji. Sprowadza się to do wyedytowania
pliku jobs.xml znajdującego się w katalogu [katalog aplikacji]/web. Jeśli takiego pliku nie ma w tym katalogu, to należy go stworzyć.
Przykładowy, pusty plik, może mieć zawartość taką jak poniżej:
<jobs>
</jobs>
Tak zdefiniowany plik jeszcze nic sam z siebie nie robi. Należy dopiero zdefiniować w nim zadania (jobs), które są związane z wiadomościami
automatycznymi. Co ważne: tagi <jobs> i </jobs> mogą występować w pliku tylko raz ­ pomiędzy nie możemy wstawić dowolną liczbę zadań,
według poniższego schematu:
<jobs>
<job name="zadanie1"> ... </job>
<job name="zadanie2"> ... </job>
<job name="zadanie3"> ... </job>
</jobs>
Brak ubezpieczenia pacjenta przebywającego na oddziale
Należy pomiędzy tagi <jobs> i </jobs> wstawić zadanie według poniższego schematu:
<job name="brakUbezpieczenia" class="app.utils.SprawdzenieUbezpieczenia" triggerType="daily" triggerValue="HH:MM" />
Przy czym jako wartość HH:MM należy wpisać czas sprawdzenia ubezpieczenia pacjentów (godzina i minuty). Tak zdefiniowane zadanie
będzie codziennie o zadanej godzinie sprawdzać, czy pacjenci przebywający na oddziale mają ubezpieczenia. Jeśli zadanie natrafi na pacjenta,
który nie posiada ubezpieczenia ­ wyśle wiadomość automatyczną według ustalonych reguł.
Brak danych osobowych pacjenta
Zadanie odpowiedzialne za weryfikację kompletności danych pacjenta jest bardziej złożone niż poprzednie. Ma ono postać taką jak poniżej:
<job name="brakDanychOsobowych" class="app.utils.SprawdzenieDanychOsobowych" triggerType="daily" triggerValue="HH:MM" >
<parameter name="kod_gminy" value="false"/>
<parameter name="nazwisko" value="false"/>
<parameter name="imie" value="false"/>
<parameter name="pesel" value="false"/>
<parameter name="identyfikator" value="false"/>
<parameter name="data_urodzenia" value="false"/>
<parameter name="miejsce_urodzenia" value="false"/>
<parameter name="plec" value="false"/>
<parameter name="kod_pocztowy" value="false"/>
<parameter name="miejscowosc" value="false"/>
<parameter name="tel_dom" value="false"/>
<parameter name="tel_komorkowy" value="false"/>
<parameter name="email" value="false"/>
</job>
Analogicznie do poprzedniego zadania ­ tutaj również zamiast HH:MM należy wstawić godzinę i minuty, o której ma się rozpocząć sprawdzanie.
Dodatkowo za zakres działania tego mechanizmu odpowiada szereg parametrów widocznych w linijkach rozpoczynających się od <parameter
name=. Są to kolejno:
kod_gminy ­ kod gminy pacjenta
nazwisko ­ nazwisko pacjenta
imie ­ imię pacjenta
pesel ­ numer PESEL pacjenta
identyfikator ­ identyfikator pacjenta
data_urodzenia ­ data urodzenia pacjenta
miejsce_urodzenia ­ miejsce urodzenia pacjenta
plec ­ płeć pacjenta
kod_pocztowy ­ kod pocztowy pacjenta
miejscowosc ­ miejscowość zamieszkania pacjenta
tel_dom ­ numer telefonu pacjenta
tel_komorkowy ­ numer telefonu komórkowego pacjenta
email ­ adres e­mail pacjenta
W powyższym przykładzie te parametry mają przypisaną wartość false, co oznacza, że sprawdzanie tych danych jest wyłączone. Jeśli chcemy
włączyć weryfikację konkretnej danej, należy przy parametrze odpowiedzialnym za jej weryfikację zmienić ciąg value="false" na value="true".
Odczytywanie wiadomości
Jeśli wiadomość została wprowadzona do systemu i został osiągnięty czas początku jej wyświetlania, pojawi się ona u adresata powyżej zakładek
systemowych ­ na samej górze ekranu:
Po zapoznaniu się z wiadomością użytkownik może kliknąć na przycisk Zapoznałem się, ukryj po prawej stronie ­ spowoduje to, że wiadomość
zostanie oznaczona jako przeczytana, zniknie z listy wiadomości na ekranie adresata, a u nadawcy pojawi się potwierdzenie przeczytania
wiadomości. Potwierdzenia te pojawiają się na zakładce Wiadomości, po kliknięciu na link Potwierdzenia odczytania można podejrzeć listę
potwierdzeń, wraz z czasem potwierdzenia i użytkownikiem, który to zrobił (przydatne w sytuacji gdy wiadomość kierowana była do klas / klasy
użytkowników).