Instrukcja Oprogramowania Pośredniczącego SDK demo Elementy Aplikacja demo W podkatalogu Bin znajduje się aplikacja umożliwiająca użycie funkcjonalności z biblioteki Oprogramowania Pośredniczącego: Middleware.Services.Gui.exe Kody źródłowe aplikacji znajdują się w podkatalogu Sources\Gui W celu uruchomienia ewentualnej kompilacji należy zaktualizować odpowiednie referencje do dostarczanego katalogu z Oprogramowaniem Pośredniczącym Bin Biblioteka operacyjna Oprogramowania Pośredniczącego W podkatalogu Bin znajduje się komplet plików DLL biblioteki Oprogramowania Pośredniczącego w wersji operacyjnej. Biblioteka integracyjna Oprogramowania Pośredniczącego W podkatalogu Integrators znajduje się plik DLL biblioteki Oprogramowania Pośredniczącego w wersji dla programistów. Ze względu na udostępnianą funkcję bezwzględnego kasowania wszystkich rekordów biletów elektronicznych oraz ich historii nie należy tej biblioteki dostarczać wraz z produkcyjną wersją oprogramowania. Użytkowanie demo w trybie operacyjnym 1. W systemie Windows należy uruchomić program: Bin\ Middleware.Services.Gui.exe 2. Ekran startowy aplikacji Windows demo
3. Podłączenie do aplikacji czytników kart Smart Card. a. Należy użyć przycisku New b. W sekcji czytnika SAM należy użyć przycisku Create przy domyślnym ustawieniu PC/SC Device Driver (Middleware)
c. Z dostępnej listy czytników należy wybrać ten, w którym umieszczona jest karta SAM d. Należy użyć przycisku Connect. Czytnik powinien otrzymać status ready. e. W sekcji czytnika Contactless należy użyć przycisku Create przy domyślnym ustawieniu PC/SC Device Driver (Middleware) f. Z dostępnej listy czytników należy wybrać ten, na którym umieszczona jest spersonalizowana Karta Biletu Elektronicznego g. Należy użyć przycisku Connect. Również ten czytnik powinien otrzymać status ready. h. Sekcja czytnika Contact może być używana zamiennie z sekcją czytnika Contactless 4. Załadowanie operacyjnej biblioteki Oprogramowania Pośredniczącego. a. Należy użyć przycisku Load i wybrać odpowiedni plik biblioteki Middleware.dll
b. Z listy dostępnych bibliotek należy wybrać jedyną dostępną pozycję Middleware.OperationalMiddleware c. Po wybraniu odpowiedniej biblioteki należy użyć przycisku Create. Wyświetlone zostaną zakładki z obsługą kart oraz uaktywni się przycisk Use oraz checkbox ready. 5. Uruchomienie skanowania czytników.
a. Należy użyć przycisku Use b. Należy zaznaczyć checkbox ready. W obu sekcjach podłączonych czytników powinny pojawić się statusy selected o ile odpowiednie karty są dostępne. c. Jeżeli spersonalizowana Karta znajduje się w zasięgu czytnika bezstykowego w dolnej części ekranu wyświetlany będzie status card on field oraz odpowiednie informacje na zakładce Card info (Numer mifare, personalized spersonalizowana, ticket card nośnik biletów, named imienna, employee pracownicza, owner na okaziciela, Numer seryjny Karty, wersja mapy karty. Gwiazdkami oznaczone są zakładki, które w danym momencie udostępniają swoje funkcjonalności. d. Przykładowa zawartość ekranu po zbliżeniu karty na okaziciela. Podstawowa różnica zamiast statusu named wyświetlany jest status owner. 6. Uwierzytelnienie się do karty SAM. a. Należy otworzyć zakładkę Sam Manager
b. Należy wprowadzić kod PIN posiadanej karty SAM c. Należy użyć przycisku Authenticate. Jeżeli podano prawidłowy kod PIN status zakładki powinien się zmienić na authenticated oraz powinien zostać odczytany i wyświetlony Numer Identyfikacyjny karty SAM oraz numer Generacji kluczy karty SAM. Na zakładce Ticket Card powinna pojawić się gwiazdka. d. Zakładka Sam Manager umożliwia również zmianę kodu PIN uwierzytelnionej karty SAM. 7. Obsługa Karty jako nośnika biletów a. Należy otworzyć zakładkę Ticket Card b. Poprzez użycie przycisku Read można odczytać dane osobowe zapisane na karcie imiennej. W pamięci karty przechowywane są jedynie imię i nazwisko oraz numer PESEL lub data urodzenia posiadacza.
c. Po wprowadzeniu odpowiednich danych i użycie przycisku Encode można zakodować na karcie dowolny bilet d. Po wprowadzeniu odpowiednich danych i użycie przycisku Legalize można zalegalizować przejazd z zakodowanego biletu abonamentowego e. W sekcji Tickets można wyświetlać zawartość pamięci Karty w trzech oddzielnych listach: i. Bilety i Legalizacje ii. Abonamenty (bilety abonamentowe) iii. Zwroty (bilety zwrócone). Nie przechowuje się informacji o zwróconych legalizacjach. f. Po wprowadzeniu odpowiednich danych i użycie przycisku Withdraw można zwrócić zakodowany bilet, legalizację lub abonament g. Po wprowadzeniu odpowiednich danych i użycie przycisku Control można zapisać w pamięci Karty fakt wykonania kontroli biletów h. W sekcji Controled można wyświetlać listę kontroli biletów zapisanych w pamięci Karty 8. Zakodowanie przykładowego biletu przejazdowego a. W sekcji Ticket należy ustawić datę i czas transakcji time =2012-12-31 12:15:00, numer seryjny biletu serial number =ABC0000000001, kod oferty offer =1, kod klasy class =1, kod ulgi discount =1 b. Po przewinięciu zestawu kontrolek należy wypełnić początkową datę ważności biletu valid from =2012-12-31 12:30:00, końcową datę ważności biletu valid to =2013-01-01 00:00:00, cenę brutto price = 123,45, procent podatku VAT tax =8. Po zaznaczeniu checkbox a before dis. można uzupełnić cenę brutto przed ulgą. c. Pozostawiając domyślną wartość typu biletu przejazdowego Journey należy wypełnić kody IBNR stacji od, stacji do. Można również wypełnić kody dla maksymalnie czterech stacji przez. Należy wypełnić długość trasy w metrach distance =123000, liczbę pasażerów passengers =1
d. Pozostałe pozycje dotyczą biletów abonamentowego lub grupowego więc nie należy ich wypełniać dla biletu przejazdowego. e. Po sprawdzeniu kompletności danych należy uruchomić kodowanie biletu poprzez użycie przycisku Encode. f. Po kilku sekundach można użyć przycisku Tickets w sekcji Tickets w celu odczytania i wyświetlenia biletów zapisanych w pamięci karty. Należy używać suwaka w celu przewijania całej dostępnej listy biletów. 9. Zakodowanie przykładowego biletu abonamentowego a. Analogicznie jak dla zwykłego biletu przejazdowego należy ustawić datę i czas transakcji time =2012-12-31 12:15:00, numer seryjny biletu serial number =ABC0000000002, kod oferty offer =110, kod klasy class =1, kod ulgi discount =1 b. Po przewinięciu zestawu kontrolek należy wypełnić początkową datę ważności biletu abonamentowego valid from =2012-12-31 12:30:00, końcową datę ważności biletu valid to =2013-03-01 00:00:00, cenę brutto price = 987,65, procent podatku VAT tax =8. c. Pozostawiając domyślną wartość typu biletu przejazdowego Journey należy wypełnić kody IBNR stacji od, stacji do. Można również wypełnić kody dla maksymalnie czterech stacji przez. Należy wypełnić długość trasy w metrach distance =123000 oraz leg validity =1 co oznacza ilość dni ważności dla legalizowanego w przyszłości przejazdu d. W części Subscription należy wypełnić ilość przejazdów rides =12, pozostawić liczbę pasażerów passengers =0 e. Po sprawdzeniu kompletności danych należy uruchomić kodowanie biletu poprzez użycie przycisku Encode. f. Po kilku sekundach można użyć przycisku Subscriptions w sekcji Tickets w celu odczytania i wyświetlenia biletów abonamentowych zapisanych w pamięci karty. Należy
używać suwaka w celu przewijania całej dostępnej listy abonamentów i aktualnej liczby dostępnych do wykorzystania przejazdów. 10. Legalizacja przejazdu z przykładowego biletu abonamentowego a. W sekcji Legalization należy ustawić datę i czas transakcji time =2012-12-31 12:45:00, numer seryjny zakodowanego wcześniej biletu abonamentowego serial number =ABC0000000002, początkową datę ważności legalizowanego przejazdu legalized from =2012-12-31 13:00:00, końcową datę ważności przejazdu legalized to =2013-01-01 00:00:00, liczbę pasażerów dla których wykonywana jest legalizacja rides =1 b. Po sprawdzeniu kompletności danych należy uruchomić kodowanie legalizacji przejazdu poprzez użycie przycisku Legalize. c. Po kilku sekundach można użyć przycisku Tickets w sekcji Tickets w celu odczytania i wyświetlenia biletów i legalizacji zapisanych w pamięci karty. Legalizacje są wyświetlane na końcu listy z biletami. 11. Zwrot biletu lub abonamentu (biletu abonamentowego) a. W sekcji Withdrawn należy ustawić datę i czas transakcji time =2012-12-31 14:00:00, numer seryjny zakodowanego wcześniej biletu serial number =ABC0000000001. Można wypełnić dodatkowe informacje o wartości brutto zwracanego biletu, procencie podatku VAT oraz procencie potrącenia (do wyliczenia zwracanej kwoty). b. Po sprawdzeniu kompletności danych należy uruchomić kodowanie zwrotu biletu poprzez użycie przycisku Withdraw. c. Po kilku sekundach można użyć przycisku Withdrawns w sekcji Tickets w celu odczytania i wyświetlenia listy zwracanych biletów zapisanych w pamięci karty. Po użyciu przycisku Tickets można sprawdzić, że zwróconego biletu nie ma już na liście biletów i legalizacji. 12. Zwrot legalizacji przejazdu
a. Podobnie jak dla zwrotu biletu w sekcji Withdrawn należy ustawić datę i czas transakcji time =2012-12-31 14:00:00, numer seryjny zakodowanego wcześniej biletu abonamentowego serial number =ABC0000000002, taką samą liczbę osób jaką użyto przy legalizacji przejazdu rides =1, taką samą datę i czas początku ważności legalizacji przejazdu jaką użyto przy jej kodowaniu datę from =2012-12-31 13:00:00 b. Po sprawdzeniu kompletności danych należy uruchomić kodowanie zwrotu legalizacji przejazdu poprzez użycie przycisku Withdraw. c. Po kilku sekundach można użyć przycisku Subscriptions w sekcji Tickets w celu odczytania i wyświetlenia listy abonamentów zapisanych w pamięci karty. Wartość rides powinna zostać powiększona o ilość rides =1 ze zwracanej legalizacji. Po użyciu przycisku Tickets można sprawdzić, że zwróconej legalizacji nie ma już na liście biletów i legalizacji. 13. Zapisanie na Karcie faktu wykonania kontroli biletów a. W sekcji Control należy ustawić kod stacji (lub przystanku) najbliższej do miejsca wykonywania kontroli biletów station =20, kod lub numer pociągu (pojazdu) w którym wykonywano kontrolę train =76, datę i czas transakcji time =2012-12-31 15:00:00 b. Po sprawdzeniu kompletności danych należy uruchomić kodowanie kontroli poprzez użycie przycisku Control. c. Po kilku sekundach można użyć przycisku Read w sekcji Controled w celu odczytania i wyświetlenia listy kontroli biletów zapisanych w pamięci karty. Użytkowanie demo w trybie integracyjnym 1. Poniższe działania można stosować jedynie w środowisku programistycznym: a. Do katalogu Bin należy przekopiować Integrators\Middleware.Services.Integrators.dll b. W katalogu Bin należy utworzyć skrót do programu: Middleware.Services.Gui.exe c. We właściwościach skrótu należy dodać parametr do uruchamianego programu "...\Bin\Middleware.Services.Gui.exe" Middleware.Services.Integrators.dll d. Demo należy uruchamiać poprzez zmodyfikowany skrót do programu. e. Wszystkie czynności zmierzające do podłączenia czytników wykonuje się identycznie jak w trybie operacyjnym. Jedyną różnicą jest wybranie do załadowania ( Load ) zamiast biblioteki Middleware.dll bibliotekę dla integratorów Middleware.Services.Integrators.dll a następnie z listy dostępnych bibliotek należy wybrać jedyną dostępną pozycję Middleware.IntegratorMiddleware
f. Po uruchomieniu skanowania czytników i uwierzytelnieniu się do karty SAM dostępna będzie dodatkowa zakładka Integrators Middleware udostępniająca tylko jedną dodatkową funkcjonalność: bezwzględne kasowanie wszystkich rekordów biletów, abonamentów, zwrotów i rekordów kontroli z Karty. g. Użycie przycisku Erase Records usuwa wszystkie rekordy z Karty.