Viatoll Calc Instrukcja użytkownika Strona 1
Spis treści 1 Wstęp...3 2 Opis panelu głównego...3 2.1 Menu aplikacji...4 2.2 Tabela z trasami...5 2.3 Strona kalkulatora viatoll...6 2.4 Pasek statusu...7 3 Ustawienia...7 4 Pierwsze uruchomienie...9 5 Import danych...10 5.1 Punkty przejazdu z pliku CSV...10 5.2 Trasy z pliku CSV...10 5.3 Trasy z pliku XML...10 Strona 2
1 Wstęp Aplikacja Viatoll Calc jest programem wspomagającym korzystanie ze strony kalkulatora opłaty elektronicznej viatoll (dostępnej pod adresem: http://213.25.68.37/tc). Viatoll Calc nie posiada własnych map ani baz adresowych, wszystkie dostępne funkcjonalności bazuję na funkcjonalnościach strony kalkulatora viatoll. Viatoll Calc jest całkowicie zależy od strony kalkulatora opłaty elektronicznej viatoll i nie może działać bez dostępu do tej strony. Viatoll Calc funkcjonuje na zasadzie parsowania treści strony kalkulatora opłaty elektronicznej viatoll i wstawia w jej pola wartości zamiast użytkownika. Jeżeli z jakiś powodów nie będzie możliwe to możliwe, to aplikacja Viatoll Calc nie będzie mogła funkcjonować. Kalkulacja w aplikacji Viatoll Calc polega na pobieraniu zawartości witryny kalkulatora opłaty elektronicznej viatoll i symulowaniu wpisywania wartości w taki sposób jakby to robił użytkownik nie jest możliwe przeprowadzanie kalkulacji na które nie pozwala strona kalkulatora viatoll. Wymagania Do uruchomienia aplikacji konieczne jest posiadanie: 1. Komputera z zainstalowanym systemem Windows (minimum Windows XP SP3). 2. Zainstalowany.NET Framework minimum w wersji 2.0. 3. Zainstalowaną przeglądarkę internetową Internet Explorer w wersji 8.0.6001.19328. 4. Połączenie do internetu oraz działającą stronę kalkulatora opłaty elektronicznej viatoll. 2 Opis panelu głównego Aplikacja Viatoll Calc uruchamiana jest w postacie jednego okna (przedstawionego poniżej), które można podzielić na następujące elementy: 1. Menu aplikacji, w którym możliwy jest dostęp do najwarzniejszych funkcji programu. 2. Tabelę z trasami lewy panel aplikacji, w którym wyświetlane będą wyniki przeprowadzanych kalkulacji. 3. Stronę kalkulatora viatoll prawy panel aplikacji, na której wyświetlana będzie strona kalkulatora i widoczne będą aktualnie przeprwadzane operacje. 4. Pasek statusu, na którym widoczny będzie postęp w obliczeniu trasy oraz informacje o aktualnie wykonywanych czynnościach. Strona 3
Ilustracja 1: Podział panelu głównego aplikacji 2.1 Menu aplikacji Menu aplikacji służy do wykonywania najważniejszych funkcji programu, poszczególne pozycje oznaczają: Uruchom kalkulację po zaimportowaniu w aplikacji listy tras pozycja ta uruchamia proces kalkulacji. Postęp kalkulacji widoczny jest cały czas w prawym panelu aplikacji. Kalkulaja jest włączana dla wszystkich zaimportowany tras, nie ma możliwości uruchomienia kalkulacji tylko dla wybranej (jednej) trasy. Otwórz pozycja służy do importowania do aplikacji plików z trasami lub z definicjami punktów przejazdu. Z pozycji tego menu możliwe jest: Listę punktów importowanie listy punktów przejazdu (adresów) w postaci pliku CSV. Listę tras importowanie listy tras w postaci pliku CSV. Wymagane jest także zaimportowanie listy punktów. Trasy z XML importowanie listy tras w postaci pliku XML, który w swojej strukturze zawiera listę punktów przejazdu (wraz z adresami). Zapisz jako pozycja służy do zapisu pliku z wynikami kalkulacji w postaci XML. Ustawienia pozycja uruchamia okno ustawień pracy aplikacji. Strona 4
Wersja językowa wybór wersji językowej aplikacji. Dostępne są dwa języki: Polski i Angielski. O aplikacji otwiera okno informacji o aplikacji, w którym można wprowadzić i sprawdzić klucz licencyjny. 2.2 Tabela z trasami Lewy panel aplikacji zawiera informacje o: Ilości odczytanych tras i punktów przejazdu (adresów). Przy imporcie tras z pliku XML pokazują się wartości tylko w polu Odczytane trasy. Tabela z trasami wyświetlane w niej są informacje o skalkulowanych trasach. Ilustracja 2: Tabela z przykładowymi trasami W Tabeli prezentowane są dane dotyczące trasy odczytane z pliku oraz informacje pobrane ze strony kalkulatora viatoll: Cena koszt przejazdu na całej trasie. Długość trasy długość wytyczonej przez kalkulator viatoll trasy. Trasa obciążona informacja o długości całej trasy która jest obciążona opłatą. Strona 5
2.3 Strona kalkulatora viatoll Prawy panel aplikacji Viatoll Calc wyświetla stronę internetową kalkulatora viatoll na której wykonywane są operacje zdefiniowane w ustawieniach lub pliku. W trakcie postępu prac można obserwować jakie akcje są wykonywane. W zależności od wielkości okna wyświetlana będzie tylko część strony lub cała jej zawartość. Ilustracja 3: Powiększony prawy panel aplikacji w celu wyświetlenia całej zawartości strony kalkulatora viatoll Prawy panel jest oknem przeglądarki internetowej więc po zakończeniu automatycznej kalkulacji, możemy ręczenie modyfikować parametry trasy, wywoływać ponowną kalkulację aż do osiągnięcia zadowalających efektów. Strona 6
Po zakończeniu ręcznej edycji można zapisać wyniki do określonej trasy. Aby to wykonać 1. Zaznaczamy trasę lewym przyciskiem myszy. 2. Klikamy prawym przyciskiem myszy na trasę 3. Wybieramy z menu kontekstowego pozycję Odśwież wyniki kalkulacji - poprzednie dane zostaną zastąpione nowymi 2.4 Pasek statusu Pasek statusu przedstawia aktualny postęp kalkulacji zaimportowanych tras. Ilustracja 4: Pasek postępu w trakcie pracy aplikacji. Pasek możemy podzielić na podstawowe elementy: 1. Postęp całkowity pokazywany jest postęp całkowitej kalkulacji wszystkich tras. 2. Postęp trasy pokazywany jest postęp w kalkulacji aktualnej trasy. 3. Status pracy informacja o aktualnie wykonywanym kroku i ilościach prób dla danego kroku. 3 Ustawienia Po wybraniu pozycji Ustawienia z poziomu menu głównego otworzy się okno konfiguracji aplikacji (ilustracja poniżej). Strona 7
Ilustracja 5: Okno ustawień aplikacji Poszczególne pozycje oznaczają: viatoll URL adres strony kalkulatora opłaty elektronicznej viatoll. Możliwa jest praca na dwóch wersjach językowych strony: Polskiej: http://213.25.68.37/tc/?lang=pl Angielskiej: http://213.25.68.37/tc/?lang=en Automatyczny odczyt danych grupa ustawień służąca do współpracy z plikami CSV. Automatycznie odczytuj punkty z pliku po zaznaczeniu tej opcji i wybraniu (z pola poniżej) ścieżki do pliku z definicją punktów przejazdu (adresów), podczas uruchamiana aplikacji automatycznie plik zostanie zaimportowany do aplikacji. Automatycznie odczytuj trasy z pliku po zaznaczeniu tej opcji i wybraniu (z pola poniżej) ścieżki do pliku z definicją tras, podczas uruchamiania aplikacji automatycznie plik zostanie zaimportowany do aplikacji. Automatyczne odczytywanie pliku XML Ładuj plik po uruchomieniu aplikacji po zaznaczeniu tej opcji i wybraniu (z pola poniżej) ścieżki dostępu do pliku XML, podczas uruchamiana aplikacji plik zostanie automatycznie zaimportowany do aplikacji. Konfiguracja pracy grupa ustawień parametrów pracy aplikacji. Parametry te można zmieniać w zależności od prędkości łącza internetowego. Strona 8
Czas pomiędzy próbami czas wyrażony w milisekundach pomiędzy. Parametry poszczególnymi próbami. Zaleca się pozostawienie domyślnej wartości (2000 ms = 2s). Liczba prób określa maksymalną liczbę prób wykonywanych dla danego kroku (np.: dla weryfikacji czy istnieje wpisywany adres). Pokazuj tabelę z trasami opcja włącza lub wyłącza wyświetlanie lewego panelu adplikacji (zawierającego tabelę z trasami). Parametry strony grupa ustawień określających parametry pracy ze stroną kalkulatora viatoll. Szukana fraza tekst który jest wyszukiwany w celu ustalenia czy kalkulacja po stronie kalkulatora viatoll została ukończona i czy można przystąpić do odczytania wyników. Najlepiej jest stosować wartości: Dla polskiej strony viatoll: Podsumowanie trasy. Dla angielskiej strony viatoll: Route summary. Klasa emisji wartość alternatywna klasy emisji, która jest przypisywana do trasy w przypadku gdy w pliku nie ma o tym informacji lub informacja ta jest błędna. Wartość odpowiada wartości listy rozwijanej na stronie kalkulatora viatoll Klasa emisji. Dopuszczalna masa indeks listy rozwijanej ze strony kalkulaora viatoll określającej dopuszczalną masę całkowitą pojazdu. Dla poszczególnych pozycji z listy rozwijanej stosuje się wartości: 0 Samochód ciężarowy (z przyczepą lub bez), łączna DMC co najmniej 12 t 1 Samochód ciężarowy (z przyczepą lub bez) łączna DMC powyżej 3,5 t i poniżej 12 t 2 Samochód osobowy z przyczepą, łączna DMC powyżej 3,5 t 3 Autobus z liczbą miejsc powyżej 9, bez względu na DMC 4 Pierwsze uruchomienie Do uruchomienia kalkulacji konieczne jest wprowadzeni klucza licencyjnego uzyskanego przez producenta w procedurze zakupu licencji. Po pierwszym uruchomieniu należy kliknąć w pozycję O aplikacji. Strona 9 Ilustracja 6: Okno "O aplikacji" do wprowadzani klucza licencyjnego
W oknie tym wyświetlane są informacje o: Producencie aplikacji Viatoll Calc v1.3 Adresie e-mail do wsparcia w przypadku wystąpienia problemów. Linku do strony produktu, gdzie można: pobrać najnowsze wersje aplikacji, pobrać instrukcję obsługi, zapoznać się z aktualizacjami. Ważności klucza licencyjnego. Komunikatu od producenta aplikacji. W polu Wprowadź klucz licencyjny wprowadzić należy uzyskany od producenta ciąg znaków. Po wpisaniu należy kliknąć przycisk Weryfikuj klucz, który uruchomi proces weryfikacji i wyświetli datę ważności klucza. 5 Import / eksport danych 5.1 Import punktów przejazdu z pliku CSV Punkty przejazdu (adresy) trasy można przechowywać w postaci pliku CSV: oddzielonego znakami średnika. MAGAZYN1;16-400;Suwałki;Reja;51; MAGAZYN2;87-100;Toruń;Sobieskiego;1; CENTRALA;03-485;Warszawa;Radiowa;13; Kolejne kolumny w pliku powinny zawierać: 1. Nazwę (symbol) punktu przejazdu 2. Kod pocztowy 3. Nazwę miejscowości 4. Ulica 5. Numer domu Plik nie powinien zawierać nagłówka z nazwami kolumn. 5.2 Import tras z pliku CSV Trasy można przechowywać w pliku CSV oddzielanym znakami średnika: trasa1;1;0;magazyn1;magazyn2; trasa2;2;1;centrala;magazyn2; trasa3;3;2;magazyn1;centrala;magazyn1;centrala trasa4;4;0;centrala;magazyn1; Kolejne kolumny w pliku oznaczają: 1. Nazwa / identyfikator trasy 2. Indeks emisji 3. Indeks dopuszczalnej masy całkowitej. Strona 10
4. Symbole punktów przejazdu (adresów) oddzielone znakami średnika. Plik nie powinien zawierać nagłówka z nazwami kolumn. 5.3 Import tras z pliku XML Trasy mogą być importowane za pomocą plików XML: <?xml version="1.0" encoding="utf-8"?> <ArrayOfRoute xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <Route> <PointsDef> <AddressDefinition> <Symbol>MAG_SUWALKI</Symbol> <PostalCode>16-400</PostalCode> <City>Suwałki</City> <Street>Reja</Street> <HouseNumber>51</HouseNumber> </AddressDefinition> <AddressDefinition> <Symbol>MAG_TORUN</Symbol> <PostalCode>01-485</PostalCode> <City>Toruń</City> <Street>Sobieskiego</Street> <HouseNumber>1</HouseNumber> </AddressDefinition> </PointsDef> <Name>MG_SUW_TOR</Name> <Emission>4</Emission> <DMC>2</DMC> <Cost></Cost> <RouteLength></RouteLength> <RouteTolled></RouteTolled> </Route> </ArrayOfRoute> Nazwa Opis ArrayOfRoute Tablica elementów typu Route Route Definicja pojedynczej trasy PointsDef Lista definicji punktów przejazdu (adresów) AddressDefinition Definicja pojedynczego punktu przejazdu (adresu) Symbol Symbol pojedynczego punktu PostalCode Kod pocztowy pojedynczego punktu City Nazwa miejscowości pojedynczego punktu Street Nazwa ulicy pojedynczego punktu HouseNumber Numer posesji / domu pojedynczego punktu Name Nazwa / symbol / identyfikator trasy Emission Indeks poziomu emisji DMC Indeks dopuszczalnej masy całkowitej Cost Koszt przejazdu (przy imporcie pole ignorowane) RouteLength Całkowita długość (przy imporcie pole ignorowane) RouteTolled Długość obciążonej trasy (przy imporcie pole ignorowane Strona 11
5.4 Eksport pliku XML Viatoll Calc v1.3 Eksportowany plik XML ma strukturę identyczną ze strukturą pliku importowanego. Strona 12
Indeks ilustracji Ilustracja 1: Podział panelu głównego aplikacji...4 Ilustracja 2: Tabela z przykładowymi trasami...5 Ilustracja 3: Powiększony prawy panel aplikacji w celu wyświetlenia całej zawartości strony kalkulatora viatoll...6 Ilustracja 4: Pasek postępu w trakcie pracy aplikacji...7 Ilustracja 5: Okno ustawień aplikacji...8 Ilustracja 6: Okno "O aplikacji" do wprowadzani klucza licencyjnego...9 Strona 13