Treść powiadomień e-mail

Rodzaje wiadomości

Wysyłane są następujące wiadomości:

Kod	Cel wiadomości

Kod	Cel wiadomości
ZAM2REZ	Zmiana stanu zamówienia na rezerwację
ODB	Zmiana stanu rezerwacji na "do odbioru"
REZ_P	Przypomnienie o pozycjach zarezerwowanych, a nie odebranych
REZ_U	Powiadomienie o skasowaniu nieodebranej rezerwacji
UP	Upomnienie przy przetrzymaniu pozycji
PRZ	Przypomnienie o upływającym terminie zwrotu
KAR	Upomnienie przy nieopłaconych należnościach
CZYT_KAS	Informacja o skasowaniu niepotwierdzonego konta czytelnika (parametr nieużywany)

Prócz tego, w przypadku skonfigurowanych modułów realizacji zakupów oraz wypożyczeń międzybibliotecznych, dostępne są następujące wiadomości (potwierdzenia):

Kod	Cel wiadomości

Kod	Cel wiadomości
KUP_R	Przyjęcie do realizacji zlecenia zakupu
KUP_A	Anulowanie zlecenia zakupu
KUP_Z	Zakończenie (zrealizowanie) zlecenia zakupu
MBSTAT	Zmiana statusu wypożyczenia międzybibliotecznego

Ponadto z programu wypożyczalni możliwe jest wysyłanie wiadomości grupowych do poszczególnych kategorii czytelników (kod: GRUPOWY).

Treść wiadomości

Wszystkie treści w wiadomości są parametryzowalne. Dla każdej wiadomości można ustawić następujące parametry (<kod> zastępujemy odpowiednim kodem wiadomości, np. UP dla upomnień)

MAIL_T_<kod> - tytuł wiadomości
MAIL_TXT_<kod>_<sekcja> - treść wiadomości - jeśli wiadomość podzielona jest na sekcje, które występują w wiadomości (lub nie) w zależności od sytuacji, wówczas treść określana jest w kilku parametrach.

W treści wiadomości mogą występować następujące konstrukcje:

${zmienna} - w momencie generowania wiadomości zastępowana jest wartością zmiennej (każda wiadomość ma swoją listę dostępnych zmiennych)
[LIST] ... [/LIST] - znaczniki listy - jeśli z wiadomością związana jest jakaś lista obiektów (np. lista książek przetrzymanych), wówczas dla każdego takiego obiektu generowany jest wiersz wiadomości wg schematu określonego wewnątrz tych znaczników.

Dodatkowo wszystkie wiadomości automatyczne są uzupełniane o informacje o koncie czytelnika oraz stopkę.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_TXT_READER_INFO	Między treścią a stopką	Dotyczy konta czytelnika: ${nazwisko} (numer karty: ${nr_karty})
MAIL_TXT_FOOTER	Stopka wiadomości	List został wygenerowany automatycznie, prosimy na niego nie odpowiadać.

Jeśli skonfigurowano więcej kont nadawcy można dla każdego z nich ustawić indywidualną stopkę wiadomości. Należy w tym celu ustawić parametr MAIL_TXT_FOOTER_id - gdzie w miejscu id podajemy identyfikator konta nadawcy. Np.:

sowizor config nazwa_katalogu MAIL_TXT_FOOTER_F1 "List został wygenerowany automatycznie w filli nr 1, prosimy na niego nie odpowiadać."

W kolejnych podpunktach omówione zostaną poszczególne rodzaje wiadomości oraz dostępne dla nich parametry i zmienne.

Zmiana zamówienia na rezerwację

Gdy czytelnik ma zamówienie na pozycję, którą właśnie zwrócono do biblioteki, a był pierwszy na liście oczekujących, wówczas system automatycznie przekształca zamówienie na rezerwację tej pozycji i wysyła wiadomość.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_ZAM2REZ	Tytuł	Do odbioru
MAIL_TXT_ZAM2REZ	Treść	Biblioteka prosi o odbiór zamawianej pozycji "${opis}" - <b>${agenda}</b>.

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
agenda	Nazwa agendy

Przykład wiadomości

Biblioteka prosi o odbiór zamawianej pozycji "505 praktycznych skryptow dla webmastera / Marcin Lis. (egz. 002003300000)" - Wypożyczalnia Główna.

Zmiana statusu rezerwacji na "do odbioru"

Gdy czytelnik zarezerwował dostępną do wypożyczenia pozycję i zostanie ona już doniesiona z magazynu, zmieniany jest stan rezerwacji na "do odbioru" (i jednocześnie od tego momentu nie można już anulowac rezerwacji). W tej sytuacji wysyłane jest nastepujące powiadomienie.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_ODB	Tytuł	Do odbioru
MAIL_TXT_ODB	Treść	Zarezerwowana pozycja "${opis}" jest gotowa do odbioru w <b>${agenda}</b>.
MAIL_TXT_ODB_#	Treść dla agendy # (w miejsce znaku # podajem nr agendy)
MAIL_TXT_ODB_TERMIN	Treść: dla pozycji z ustalonym terminem odbioru	Pozycję należy odebrać najpóźniej w dniu <b>${timeout}</b>.

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
agenda	Nazwa agendy
timeout	Termin odbioru (dot. głównie pozycji do odbioru w książkomacie)

Przykład wiadomości

Zarezerwowana pozycja "505 praktycznych skryptów dla webmastera / Marcin Lis. (egz. 002003300000)" jest gotowa do odbioru w Wypożyczalnia Główna.

Powiadomienie o nieodebranych rezerwacjach

(tylko w serwerach SOWA2/MARC21) Zarezerwowane pozycje, dotąd nieodebrane przez czytelnika mogą generować wiadomość: (zob. CFG_REZ_MAIL):

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_REZ_P	Tytuł	Przypomnienie o rezerwacji
MAIL_TXT_REZ_P_START	Treść: początek	Przypominamy, że wymienione poniżej egzemplarze czekają na odebranie (są dla Ciebie zarezerwowane):
MAIL_TXT_REZ_P_LIST	Treść: lista pozycji	[LIST]${opis} - <b>${agenda}</b>[/LIST]
MAIL_TXT_REZ_P_STOP	Treść: koniec	W celu anulowania rezerwacji prosimy o kontakt z bibliotekarzem.

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
no	Numer kolejny pozycji (od 1.)
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
agenda	Nazwa agendy
data_rez	Data rezerwacji pozycji

Przykładowa wiadomość

Przypominamy, że wymienione poniżej egzemplarze czekają na odebranie (są dla Ciebie zarezerwowane):
 1. 505 praktycznych skryptow dla webmastera / Marcin Lis. (egz. 002003300000) - Wypożyczalnia Główna
W celu anulowania rezerwacji prosimy o kontakt z bibliotekarzem.

Powiaomienie o skasowaniu rezerwacji

Zarezerwowana i nieodebrana w terminie rezerwacja może być skasowana. Wówczas na adres czytelnika wysyłana jest wiadomość.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_REZ_U	Tytuł	Skasowano rezerwacje
MAIL_TXT_REZ_U	Treść	Pracownik biblioteki skasował nieodebraną rezerwację "${opis}" - <b>${agenda}</b>

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
agenda	Nazwa agend

Przykładowa wiadomość

Pracownik biblioteki skasował nieodebraną rezerwację "Zielone jabłuszko / Izabela Sowa. (egz. 000054972000)" - Wypożyczalnia Główna.

Upomnienie przy przetrzymaniu pozycji

Jeśli czytelnik nie zwrócił w terminie, wówczas co n dni (zob. CFG_MONIT_MAIL) wysyłana jest wiadomość.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_UP	Tytuł	Upomnienie
MAIL_TXT_UP_START	Treść: początek	Prosimy o niezwłoczny zwrot wymienionych poniżej, przetrzymanych egzemplarzy:
MAIL_TXT_UP_LIST	Treść: lista pozycji	[LIST]${opis} - Termin zwrotu upłynął: ${data_zwr} - <b>${agenda}</b>[/LIST]
MAIL_TXT_UP_KARA	Treść: jeśli naliczono karę - na końcu	Informujemy, że opłata za przetrzymanie powyższych egzemplarzy do dnia <b>${data}</b> wynosi <b>${suma}</b> zł.

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
no	Numer kolejny pozycji (od 1.)
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
data_zwr	Data zwrotu danego egzemplarza
agenda	Nazwa agendy
data	Data bieżąca
suma	Łączna kwota naliczonych kar

Upomnienie przy nieopłaconych należnościach

Jeśli czytelnik nie uregulował należności, wówczas co n dni (zob. CFG_KARY_MAIL) wysyłana jest wiadomość.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_KAR	Tytuł	Upomnienie
MAIL_TXT_KAR_START	Treść: początek	Prosimy o niezwłoczne uregulowanie następujących nieopłaconych należności:
MAIL_TXT_KAR_LIST	Treść: lista pozycji	[LIST]${opis} - ${przyczyna}: <b>${kwota}</b> zł[/LIST]
MAIL_TXT_KAR_ODSETKI	Treść: jeśli naliczono odsetki	Odsetki na dzień ${data} wynoszą <b>${odsetki}</b> zł.
MAIL_TXT_KAR_STOP	Treść: koniec	Łączna kwota do zapłaty wynosi: <b>${suma}</b> zł.
MAIL_TXT_KAR_POMOC	Treść: dodatkowe informacje tuż przed stopką maila

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
no	Numer kolejny pozycji (od 1.)
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
przyczyna	Opis przyczyny naliczenia opłaty
kwota	Naliczona kwota opłaty
agenda	Nazwa agendy
data	Data bieżąca
odsetki	Łączna kwota naliczonych odsetek
suma	Łączna kwota naliczeń powiększona o odsetki

Przypomnienie o upływającym terminie zwrotu

Na n dni przed upływającym terminem zwrotu pozycji (zob. CFG_INFO_MAIL) wysyłane jest przypomnienie. Treść maila jest różna w zależności od tego, czy biblioteka dopuszcza samoobsługowe prolongaty wypożyczeń przez WWW, czy też nie.

Dla każdego elementu listy pozycji wypełniona będzie zmienna ${data_zwr} wartością: Data zwrotu: DD.MM.YYYY.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_PRZ	Tytuł	Przypomnienie
MAIL_TXT_PRZ_START	Treść: początek	Przypominamy, że kończy się okres wypożyczenia wymienionych poniżej egzemplarzy:
MAIL_TXT_PRZ_LIST	Treść: lista pozycji	[LIST]${opis} - ${data_zwr}<b>${agenda}</b>[/LIST]
MAIL_TXT_PRZ_PRL_AU	Treść: koniec (jeśli można prolongować)	Wypożyczenia można prolongować poprzez stronę internetową biblioteki.
MAIL_TXT_PRZ_PRL_BIB	Treść: koniec (jeśli nie można prolongować)	W celu prolongowania wypożyczeń prosimy o kontakt z bibliotekarzem.

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
no	Numer kolejny pozycji (od 1.)
opis	Skrócony opis pozycji - zawiera tytuł, autora i numer egzemplarza
agenda	Nazwa agendy
data_zwr	Data zwrotu egzemplarza

Informacja o skasowaniu niepotwierdzonego konta czytelnika

Gdy czytelnik, który sam zapisał się do biblioteki, nie potwierdził osobiście konta w wyznaczonym terminie, jego konto może być automatycznie kasowane. Jest wówczas generowany do niego mail z informacją o usunięciu konta.

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_CZYT_KAS	Tytuł	Usunięto niepotwierdzone konto czytelnika
MAIL_TXT_CZYT_KAS	Treść	Informujemy, że z powodu braku potwierdzenia tożsamości czytelnika w bibliotece, zarejestrowane w dniu ${data} konto zostało <b>usunięte</b>.

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
data	Data rejestracji konta czytelnika

Zmiana statusu propozycji zakupu

W przypadku gdy jest wdrożony mechanizm obsługi propozycji zakupu książek, są wysyłane powiadomienia o zmianie statusu tej propozycji. Są 3 dostępne powiadomienia:

Powiadomienie o przyjęciu do realizacji propozycji zakupu (KUP_R), anulowaniu propozycji zakupu (KUP_A) oraz zakończeniu obsługi propozycji zakupu (KUP_Z):

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_KUP_R	Tytuł	Powiadomienie
MAIL_TXT_KUP_R	Treść	Złożone zlecenie dotyczące zakupu "${opis}" zostało przyjęte do realizacji.
MAIL_T_KUP_A	Tytuł	Powiadomienie
MAIL_TXT_KUP_A	Treść	Złożona propozycja zakupu "${opis}" została odrzucona.<br/>Powód odrzucenia: ${reason}
MAIL_T_KUP_Z	Tytuł	Powiadomienie
MAIL_TXT_KUP_Z	Treść	Złożona propozycja zakupu "${opis}" została zrealizowana w "${agenda}".

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
opis	Opis propozycji zakupu
reason	Powód odrzucenia
agenda	Agenda realizacji propozycji zakupu

Zmiana statusu wypożyczenia międzybibliotecznego

W przypadku gdy jest wdrożony mechanizm obsługi wypożyczeń międzybibliotecznych, są wysyłane powiadomienia o zmianie statusu. Służy do tego jeden szablon:

Parametr	Miejsce	Domyślna wartość parametru

Parametr	Miejsce	Domyślna wartość parametru
MAIL_T_MBSTAT	Tytuł	Powiadomienie
MAIL_TXT_MBSTAT	Treść	Złożone zamówienie międzybiblioteczne dotyczące "${opis}" ${status}

Dostępne zmienne:

Nazwa	Zawartość zmiennej

Nazwa	Zawartość zmiennej
opis	Skrócony opis pozycji
status	Tekstowy status wypożyczenia

Formatowanie wiadomości w HTML

Wszystkie wiadomości generowane są wiadomości w formacie HTML. Można zdefiniować dodatkowe elementy HTML lub formatowania CSS w wiadomości przy pomocy poniższych parametrów.parametry bazy czytelników (ustawiane za pomocą komendy W# w programie administratora):

Parametr	Znaczenie

Parametr	Znaczenie
MAIL_HTML_STYLE	Style CSS dla całej wiadomości
MAIL_HTML_STYLE_BODY	Style CSS dla wygenerowanej treści wiadomości
MAIL_HTML_STYLE_FOOTER	Style CSS dla stopki
MAIL_HTML_CODE_HEADER	Opcjonalny statyczny kod HTML umieszczany w nagłówku wiadomości (powyżej wygenerowanej treści)
MAIL_HTML_CODE_FOOTER	Opcjonalny statyczny kod HTML umieszczany w stopce wiadomości (poniżej wygenerowanej treści)

Szablon wiadomości wygląda następująco:

Szablon wiadomości w HTML

<div style="{MAIL_HTML_STYLE}">
	{MAIL_HTML_CODE_HEADER}
	<div style="{MAIL_HTML_STYLE_BODY}">
		{wygenerowana treść wiadomości}
	</div>
	<br/>
	<div style="{MAIL_HTML_STYLE_FOOTER}">
		{MAIL_TXT_FOOTER}
	</div>
    {MAIL_HTML_CODE_FOOTER}
 </div>

Domyślnie style CSS są puste.