Instrukcja obsługi programu Klient SMS v.1.0 Rozpoczęcie pracy z programem Aby rozpocząć pracę z aplikacją kliencką należy uruchomić dowolną przeglądarkę internetową i wpisać adres: lub http://<adres ip serwera gsm>:8080/gsm http://<adres ip serwera gsm>:8443/gsm Gdy serwer gsm działa poprawnie powinna pojawić się strona startowa programu: Komunikat w ramce pojawi się tylko wówczas, gdy do serwera GSM nie został poprawnie dołączony choć jeden modem GSM lub telefon komórkowy. W innym przypadku ten komunikat nie pojawia się. Pracę z aplikacją możemy rozpocząć logując się na użytkownika admin (hasło: admin). Po podaniu poprawnych danych pojawi się menu główne programu: Oczywiście pierwszą rzeczą, która powinna być wykonana, to zmiana hasła administratora. Aby to uczynnić należy wybrać funkcję Administracja, Lista użytkowników. Z listy należy wybrać użytkownika admin i użyć opcji Edytuj: str. 1
W polu hasło wpisz nowe hasło i zapisz zmiany. Zarządzanie użytkownikami Jeśli z aplikacji będzie korzystać kilka lub kilkanaście osób, to warto dla każdej z nich założyć osobne konto. Dzięki temu każdy uzyska możliwość prowadzenia własnej księgi kontaktów. Możliwe jest zarządzanie widocznością wysyłanych obiektów poprzez nadanie odpowiednich poziomów uprawnień. Rejestracja nowego użytkownika. Do rejestracji nowego użytkownika służy funkcja w menu Administracja Dodaj użytkownika. Po wybraniu tej opcji pojawi się formatka do wprowadzenia podstawowych danych użytkownika. Najważniejszym elementem jest ustalenie przyszłej roli użytkownika (pole Typ), gdyż częściowo będzie to związane z posiadanymi uprawnieniami. W aplikacji przewidziano następujące role: Administrator - osoba o najwyższych uprawnieniach w systemie, Koordynator osoba o nieco mniejszych uprawnieniach niż Administrator, np. nie może korygować słowników, Użytkownik osoba o podstawowych uprawnieniach w systemie. Większość osób oczywiście będzie przeważnie zarejestrowana jako zwykły użytkownik. Administratorem powinna być osoba techniczna, zaś Koordynatorem - osoba merytoryczna, którą str. 2
wyznaczymy np. do rejestracji nowych użytkowników, blokowania użytkowników (poprzez zmianę hasła), czy też do nadawania uprawnień i obsługi grup. Nadanie uprawnień użytkownikowi. Nowemu użytkownikowi możemy (ale nie musimy) nadać uprawnienia związane z widocznością wysyłanych lub odbieranych obiektów. Wyobraźmy sobie sytuację, że chcemy aby nie wszyscy użytkownicy widzieli wszystkie SMSy, które są wysyłane do klientów, kontrahentów. Jeśli tak jest, wówczas możemy zastosować mechanizm ograniczenia widoczności. W pierwszym kroku osobom które będą takie SMSy wysyłać nadajemy uprawnienie do obiektów: SMSout i MAILout dla poziomu, który wybraliśmy jako znacznik dla tychże SMSów (w systemie standardowo jest zdefiniowanych 6 poziomów od 0 do 5, ale listę można poszerzyć edytując słownik LVL patrz rozdział Słowniki aplikacji ). Od tej pory SMSy o tym poziomie będą widzieć tylko osoby, które mają nadane takie uprawnienie. Uprawnienie nadajemy w opcji Administracja, Lista użytkowników, Uprawnienia: Możemy stosować opcję pojedynczego nadawania uprawnień Dodaj uprawnienie lub też opcję masowego dodawania uprawnień Dodaj masowo uprawnienia. Należy podkreślić, że jeden użytkownik może być przypisany do kilku poziomów. Jeśli nadamy uprawnienie all będzie to oznaczało, że użytkownik widzi wszystkie poziomy. W przypadku nadawania uprawnień do obiektów SMSin i MAILin w słowniku LVL administrator bądź koordynator powinien dodać nowe poziomy, przy czym w przypadku SMSin powinny być to numery telefonów w formacie +48xxxyyyzzz zaś w przypadku MAILin powinny być to adresy mailowe. Jeśli użytkownikowi nadamy uprawnienie SMSin o poziomie zgodnym z numerem telefonu zdefiniowanych w słowniku LVL: str. 3
Oznaczać to będzie, że dany użytkownik będzie widział SMSy odebrane przez serwer gsm tylko z tego numeru telefonu. Analogiczne w przypadku MAILin użytkownik będzie widział maile odebrane tylko z adresów, które zostały wsazane w uprawnieniach MAILin tegoż użytkownika. Obsługa kontaktów Każdy użytkownik może prowadzić własną księgę kontaktów, ale też może korzystać z kontaktów zarejestrowanych jako kontakty publiczne. Rejestracja nowego kontaktu Aby zarejestrować nowy kontakt należy wybrać opcję Kontakty, Dodaj kontakt: Po podaniu nazwy kontaktu (może być to imię i nazwisko, pseudonim, nazwa firmy, itp.) należy podać email i numer telefonu kontaktowego. Jeśli chcemy, aby nasz kontakt był widziany przez str. 4
innych użytkowników systemu, to wybieramy typ Public, gdy zaś chcemy mieć kontakt prywatny wybieramy typ Private. Lista kontaktów Jeśli chcemy przejrzeć listę dostępnych dla nas kontkatów, możemy użyć opcji Kontakty, Lista kontkatów. Tutaj też jest dostępna funkcja edycji kontaktu oraz usuwania kontaktów. Edycja kontaktu Jeżeli chcemy zmienić dane dotyczące wcześniej zarejestrowanego kontaktu, możemy to osiągnąć wybierając funkcję Kontakty, Lista kontaktów a następnie opcję Edytuj wskazanego rekordu danych. Usunięcie kontaktu Jeżeli chcemy usunąć wcześniej zarejestrowany kontakt, możemy to wykonać wybierając funkcję Kontkaty, Lista kontaktów a następnie opcję Usuń wskazanego rekordu danych. Import kontaktów z pliku Aplikacja umożliwia również import kontaktów z pliku w formacie *.csv. Poniżej opisano format pliku z danymi: Pole Typ Przykładowa wartość Opis Nazwa VARCHAR(60) Jan Kowalski Nazwa kontaktu Firma VARCHAR(80) Firma s.j. Nazwa firmy Nr telefonu VARCHAR(12) +48601222333 Numer telefonu E-mail VARCHAR(200) jank@wp.pl E-mail Typ kontaktu VARCHAR(20) Public Private Typ kontaktu. Dozwolone tylko dwie wartości: - Public - Private Pola powinny być oddzielone średnikiem (znak ; ), np.: Jan Kowalski;Firma s.j.;+48601222333;jank@wp.pl;private str. 5
Po wskazaniu plików z kontaktami i użyciu przycisku Importuj rozpocznie się proces importu kontaktów do bazy systemów. Po zaimportowaniu będzie wyświetlona stosowna informacja: Klikając na link Lista odrzuconych kontaktów możemy sprawdzić, czy w aplikacja odrzuciła jakieś kontakty, gdyż dane nie były pełne: str. 6
UWAGA! Ze względu na fakt, iż każdy kontakt ma swój indywidualny numer możliwe jest zaimportowanie kilkukrotne tego samego pliku. Jest to raczej sytuacji niepożądana i należy jej unikać. Nie ma jednak to wpływu na działanie aplikacji. Eksport kontaktów do pliku Każdy użytkownik systemu w dowolnej chwili może wyeksportować swoje kontakty do pliku w formacie *.csv. Układ pól w pliku jest identyczny z plikiem w opcji importu. Obsługa grup Mechanizm grup wprowadzono, aby umożliwić użytkownikom zbiorowe wysyłanie SMSów (lub innych obiektów). Jeśli wiemy, że do pewnej grupy ludzi zdarza się nam wysyłać SMSa o tej samej treści, to warto zastanowić się, czy nie utworzyć grupy, aby ułatwić sobie pracę. Do grupy można z jednej strony przypisać pulę kontaktów, z drugiej zaś listę użytkowników, którzy z danej grupy mogą korzystać. Rejestracja grupy Do rejestracji grupy używamy funkcji Obsługa grup, Dodaj grupę: str. 7
Po rejestracji grupy należy w opcji Obsługa grup, Lista grup ustalić dla nowej grupy przypisane do grupy kontakty oraz użytkowników. Dodanie do grupy kontaktów Po rejestracji grupy należy wskazać kontakty, które będą przypisane do grupy. Można to uczynić w opcji Obsługa grup, Lista grup a następnie Kontakty. Po wyborze tej opcji wyświetlona zostanie lista kontaktów już przypisanych do grupy (oczywiście w przypadku nowej grupy lista będzie pusta). Aby dodać nowy kontakt wybierz opcję Dodaj kontakt do grupy: Zostanie wyświetlona lista dostępnych kontaktów, które jeszcze nie są przypisane do tej grupy. Należy wybrać interesujące nas kontakty i klawiszem Dodaj dokonać wpisu. Dodanie członków do grupy Podobnie jak w przypadku kontaktów do grupy należy przypisać użytkowników, którzy będą mogli z niej korzystać (tzw. Członków grupy). Aby to uczynić należy wskazać na poziomie listy grup opcję Członkowie. Zostanie wyświetlona lista członków (użytkowników) korzystających z grupy. Po wyborze opcji Dodaj członka grupy wyświetlona jest lista użytkowników, którzy nie są przypisani go grupy. Należy zaznaczyć wybranych użytkowników i użyć klawisza Dodaj. Po wykonaniu tej akcji wybrani użytkownicy zostaną przypisani do grupy. Obsługa szablonów str. 8
Szablony wprowadzono, by ułatwić częste wysyłanie SMSów (lub innych obiektów) o tej samej treści. Wysyłając SMS lub maila można skorzystać z wcześniej zarejestrowanego szablonu treści. Rejestracja nowego szablonu. Do rejestracji szablonu służy opcja Obsługa szablonów, Dodaj szablon. Podobnie jak w przypadku kontaktów szablon możemy zarejestrować jak prywatny (pole Typ: Private ) lub publiczny (pole Typ: Public ). Jeśli zarejestrujemy szablon jako prywatny, to inni użytkownicy nie będą mogli z niego korzystać, gdy zaś zarejestrujemy szablon jako publiczny, to wszyscy użytkownicy będą mieli dostęp do takiego szablonu. Edycja szablonu Aby poddać edycji wcześniej zarejestrowany szablon należy użyć funkcji Obsługa szablonów, Lista szablonów a następnie Edytuj odpowiedniego szablonu. Usunięcie szablonu Szablon można usunąć z poziomu listy szablonów poprzez wykorzystanie klawisza Usuń po zaznaczeniu szablonów do usunięcia. Obsługa SMSów Rejestracja SMSa do wysłania przez telefon/modem gsm Jeśli nasz serwer gsm ma podłączone modemy gsm lub telefony komórkowe pełniące rolę modemów, wówczas możliwe jest wysyłanie smsów z wykorzystaniem tych urządzeń. Aby tego dokonać należy wybrać funkcję SMSy, Wyślij SMSa TEL. Po wyborze tej opcji zostanie wyświetlona formatka do wprowadzenia danych SMSa. Jeśli serwer gsm nie ma podłączonych urządzeń, bądź wszystkie podłączone urządzenia pracują nieprawidłowo, wówczas wyświetlany jest komunikat jak na poniższym ekranie: str. 9
Pole Szukaj jest polem pomocniczym służącym do ograniczania listy kontaktów. Wpisując w tym polu ciąg znaków ograniczamy listę kontaktów do takich, w których dana fraza występuje. Jeśli wybierzemy szablon z listy, wówczas w polu Treść SMS automatycznie pojawi się treść z szablonu. Oczywiście tak wyświetloną treść można poddać edycji. Treść SMS może mieć więcej niż 160 znaków. W przypadku gdy z listy kontaktów wybierzemy jako adresata grupę, wówczas pole Numer tel. jest wyświetlane jako puste. Istotnym polem jest pole Poziom. W polu tym wyświetlana jest lista poziomów, z jakimi może dany użytkownik wysyłać SMSy z ograniczoną widocznością (patrz punkt Nadawanie uprawnień użytkownikowi ). Rejestracja SMSa do wysłania przez INTERNET Serwer GSM obsługuje również wysyłanie SMSów przez bramki internetowe. Jeśli chcemy wysłać SMSa przez Internet powinniśmy wybrać opcję SMSy, Wyślij SMSa INT. Proces wysyłania SMSa z wykorzystaniem bramki internetowej niczym się nie różni od wysyłania SMSa przez modem lub telefon. Import SMSów do wysłania z pliku str. 10
Aplikacja daje możliwość wysyłania SMSów po zaimportowaniu ich z pliku w formacie *.csv. Format pliku jest bardzo prosy i składa się tylko z dwóch pól: Pole Typ Przykładowa wartość Opis Nr telefonu VARCHAR(12) +48601222333 Numer telefonu Treść VARCHAR(160) Testowy sms Treść SMSa Pola powinny być oddzielone średnikiem (znak ; ), np.: +48601222333;Testowy sms UWAGA! Treść SMS nie może zawierać polskich znaków. Oddzielnie przygotowano opcje do wysłania SMSów z pliku przez telefon lub modem (Import SMSów TEL) a osobno do wysyłki internetowej (Import SMSów INT). Przeglądanie SMSów wyłanych Do przeglądania SMSów wyłanych służy opcja SMSy, Wysłane SMSy. Po wybraniu tej opcji pojawi się formatka pozwalająca określić zakres dat, który nas interesuje: Akceptując daty przechodzimy do listy SMSów: str. 1 1
Na prezentowanej liście ważną informację niosą pola: Info informuje, czy SMS został wysłany i w której próbie ( 1:OK. oznacza że SMS wysłano w 1 próbie bez wystąpienia błędu, 3:ERROR oznacza, że wysłano SMSa w 3 próbie. Jeśli występuje wpis 7:ERROR oznacza to, że SMS nie został wysłany, gdyż Serwer gsm podejmuje max 7 prób wysłania SMSa, GSMS informuje o bramie, przez którą SMS został wysłany, ODP w przypadku SMSów internetowych zawiera informację zwrotną od operatora bramki. Istnieje możliwość wyeksportowania informacji do pliku *.xls. Przeglądanie SMSów odebranych Funkcja SMSy, Odebrane SMSy służy do przeglądania SMSów, które zostały odebrane przez modemy lub telefony podłączone do serwera gsm. Dla danego użytkownika lista może być zawężona ze względu na jego uprawnienia (patrz punkt Nadanie uprawnień użytkownikowi ). str. 12
Obsługa e-maili Serwer gsm potrafi również obsługiwać wysyłanie i odbiór mail (o ile zostanie odpowiednio skonfigurowany). Do tego celu wykorzystuje wybrane konto na dowolnym serwerze pocztowym. Można skonfigurować kilka kont pocztowych na kilku serwerach pocztowych. Wówczas wysyłając maile serwer gsm będzie zapewniał rozproszenie wysyłki korzystając równomiernie ze zdefiniowanych kont pocztowych. Rejestracja e-maila do wysłania Do rejestracji e-maila od wysłania służy opcja E-mail, Wyślij e-mail. Podobnie jak przy wysyłaniu SMSów, tak i tutaj jest dostępne pole Szukaj, które w znakomity sposób ułatwia znalezienie nam odpowiedniego kontaktu. W przypadku, gdy wybrany kontakt nie miał podaniego e-maila, wówczas w polu Adres jest wyświetlany znak @, a wysłanie maila nie będzie możliwe. Po wybraniu z listy kontaktów grupy, będzie wysłany do każdego kontaktu z grupy osobny mail. Do maili można załączyć max trzy pliki. Przy wysyłaniu mail można korzystać z wcześniej przygotowanych szablonów. str. 13
Przeglądanie e-mail wyłanych Funkcja analogiczna do Przeglądania SMSów wysłanych. Przeglądanie e-mail odebranych Funkcja analogiczna do Przeglądania SMSów odebranych str. 14