Content Comparison

...

Uruchomienie usługi powiadomień SMS w przebiega w następujący sposób:

• biblioteka rejestruje konto u operatora bramki SMS - może wybrać opcję pre-paid, post-paid albo abonament. Szczegóły na stronie operatora (zob. http://www.smsapi.pl/cennik)

• firma SOKRATES-software przeprowadza instalację i konfigurację /wiki/spaces/SOWAALL/pages/688142 - biblioteka musi jedynie dostarczyć nazwę użytkownika i hasło do API, które generuje na stronie operatora bramki SMS

• administrator systemu konfiguruje parametry systemu SowaSQL, które określą dla jakich zdarzeń i o jakiej treści powiadomienia SMS będą wysyłane (niezależnie od powiadomień email)

• zainteresowani czytelnicy muszą zarejestrować swój numer do powiadomień w wypożyczalni (pracownik biblioteki wprowadza go na formularzu czytelnika do pola Telefon do powiadomień SMS).

Konfiguracja

Wymagane jest skonfigurowanie modułu zewnętrznego do wysyłania poczty elektronicznej (SMAILER), a następnie ustawienie odpowiedniej wartości parametru CFG_SMS_ZDARZENIAcore.notifier.default.sms_events. Parametr ten powinien zawierać kody operacji, dla których generowane będą powiadomienia SMS.

...

...

...

Przykład: wysyłanie informacji o zmianie statusu zamówienia oraz o przetrzymaniach

...

Code Block
language none
sowizor config nazwa_katalogu core.notifier.default.sms_events Rm

Opcjonalnie biblioteka może także zmodyfikować treść powiadomień. W tym celu należy ustawić odpowiednią zmienną bazy czytelników (polecenie W# w administratorze). Poniższa tabela zawiera nazwy parametrów oraz ich domyślną wartość:

Operacja	Parametr	Wartość domyślna	Przykład
R	SMS_TXT_ZAM2REZ	${agenda}: Odbierz zamówienie - ${opis:25}	Wypożyczalnia Główna: Odbierz zamówienie - Wojownicza rewolta bombar
O	SMS_TXT_ODB_P	${agenda}: Odbierz rezerwację - ${opis:25}	Wypożyczalnia Główna: Odbierz rezerwację - Wojownicza rewolta bombar
r	SMS_TXT_REZ_U	${agenda}: Skasowano rezerwację - ${opis:25}	Wypożyczalnia Główna: Skasowano rezerwację - Wojownicza rewolta bombar
m	SMS_TXT_UP	${agenda}: Prosimy o zwrot przetrzymanych pozycji (${liczba})	Wypożyczalnia Główna: Prosimy o zwrot przetrzymanych pozycji (15)
k	SMS_TXT_KAR	${agenda}: Prosimy o uregulowanie nieopłaconych należności (${kwota} zł)	Wypożyczalnia Główna: Prosimy o uregulowanie nieopłaconych należności (2,30 zł)
p	SMS_TXT_PRZ	${agenda}: Wkrótce upływa termin zwrotu ${liczba} pozycji	Wypożyczalnia Główna: Wkrótce upływa termin zwrotu 3 pozycji
t	SMS_TXT_REZ_P	${agenda}: Przypominamy o nieodebranych rezerwacjach (${liczba})	Wypożyczalnia Główna: Przypominamy o nieodebranych rezerwacjach (55)

Wartości domyślne zostały tak dobrane, aby zawierały możliwie precyzyjną informację i nie przekraczały 70 znaków! Wynika to z faktu, że wiadomość SMS posiadająca polskie znaki diakrytyczne ograniczona jest właśnie do 70 znaków na 1 SMS - jeśli wiadomość nadana przez system przekroczy tą granicę (nawet o jeden znak!), wówczas operator policzy taką wiadomość jako 2 lub więcej wysłanych wiadomości SMS. Maksymalnie można wysłać wiadomość złożoną z 6 SMSów, czyli 360 znaków. Więcej informacji na ten temat dostarcza operator bramki SMS.

...

Możliwe jest ograniczenie wysyłki SMSów tylko do zdarzeń dotyczącej wybranych agend (np. pozwala to wykluczyć zdarzenia z czytelni). Domyślnie SMSy wysyłane są dla zdarzeń ze wszystkich agend, jeśli ma być inaczej, należy listę agend dodać do parametru CFG_SMS_AGENDY - identyfikatory agend należy rozdzielać pionową kreską.

...

Przykład ustawienia parametru CFG_SMS_AGENDY

sowizor config nazwa_katalogu CFG_SMS_AGENDY 10|11|20|21|'["10","11","20","21"]'

Jeśli koszt wysyłki SMSów nie stanowi dużego problemu dla biblioteki, a chce jak najprzyjaźniej informować czytelnika o wybranych zdarzeniach, może także ustawić automatyczną stopkę, doklejaną do każdej wysyłanej wiadomości SMS. Jest to parametr bazy czytelników: SMS_TXT_FOOTER. Domyślnie jest on pusty. Np. ustawienie tego parametru:

...

Ustawienie "stopki" wiadomości SMS

sowizor config nazwa_katalogu SMS_TXT_FOOTER "Biblioteka Publiczna w Testowie"

spowoduje dla wiadomości dotyczącej np. zmiany statusu zamówienia książki w filii nr 5 wygenerowanie SMSa o treści: "Filia nr 5: Odbierz zamówienie - Dziady cz. III / Biblioteka Publiczna w Testowie". Taka wiadomość znacznie przekracza limit 70 znaków, dlatego operator policzy ją jako 2 wiadomości SMS.

Działania dodatkowe

Warto zmodyfikować sowa_server_profiles.xml dodając w sekcji <!-- PROGRAMS --> zapis “sms” dla uaktywnienia wysyłki ręcznej z programu klienta i ikonki sms na podglądzie czytelnika

<!-- PROGRAMS -->
<list>
     <item>
        <fld_idf>logged</fld_idf>
        <fld_values>
            sms
            ...

Warto dodać zapis w sowa_module_wyp_orders.xml dotyczący dodatkowych zakładek wyszukiwania na liście osób.

<item>
    <fld_idf>CO</fld_idf>
    <fld_name>Nr telefonu</fld_name>
</item>
<item>
    <fld_idf>Cm</fld_idf>
    <fld_name>Nr do SMS</fld_name>
</item>