Szczegółowy Opis Interfejsu Wymiany Danych. Załącznik nr 1.8.

Podobne dokumenty
SZCZEGÓŁOWY OPIS INTERFEJSU WYMIANY DANYCH

ZZP ZAŁĄCZNIK nr 11

elektroniczna Platforma Usług Administracji Publicznej

CELAB. Specyfikacja protokołów przesyłania wyników badań

Dokumentacja podłączeniowa dla procesu przenoszenia danych osobowych. Czyli opis jak skorzystać z usługi: rodotransferservice

Dokumentacja techniczna interfejsu komunikacyjnego Cyfrowego Urzędu z systemami EOD

Technologie internetowe laboratorium nr 4. Instalacja i uruchomienie usługi sieciowej w serwerze Tomcat/AXIS

Integracja Obieg Dokumentów - GiS Spis treści

Wykonanie funkcjonalności Zaufany Profil w ramach rozbudowy epuap

Techniczny opis rozwiązania dla udostępniania danych pomiarowych i zagregowanych z wykorzystaniem standardu AS4

SPECYFIKACJA USŁUG WEBOWYCH OFEROWANYCH PRZEZ ZUS

SCHEMAT DOKUMENTU POTWIERDZENIA GENEROWANEGO PRZEZ ZUS

Katedra Architektury Systemów Komputerowych Wydział Elektroniki, Telekomunikacji i Informatyki Politechniki Gdańskiej

Załącznik nr 10 do SOPZ: Protokół wymiany danych (Interface) Protokół wymiany danych pomiędzy Systemem Wykonawcy a Systemem Przekazywania Zgłoszeń

SPECYFIKACJA USŁUG WEBOWYCH OFEROWANYCH PRZEZ ZUS

RA H L WYMIANA DANYCH. Wersja z dnia Numer dokumentu 2006/IT-P/004. Kategoria dokumentu. Projekt. Status dokumentu.

SCHEMAT DOKUMENTÓW OTRZYMYWANYCH Z ZUS ZAWIERAJĄCYCH INFORMACJE ZGROMADZONE W SYSTEMIE INFORMATYCZNYM ZUS

SCHEMAT DOKUMENTÓW OTRZYMYWANYCH Z ZUS ZAWIERAJĄCYCH INFORMACJE ZGROMADZONE W SYSTEMIE INFORMATYCZNYM ZUS

Spis treści INTERFEJS (WEBSERVICES) - DOKUMENTACJA TECHNICZNA 1

PL URZĄD MIASTA SZCZECIN N NOF WPiOL/1111/W/123456/2013 KOWALSKI JAN, FELCZAKA 1A SZCZECIN PLN

XML extensible Markup Language. część 4

Uradni list Republike Slovenije

SPECYFIKACJA WYMIANY DANYCH POMIĘDZY PROGRAMEM KS-APTEKA WINDOWS I SKLEPEM INTERNETOWYM FIRMY ZEWNĘTRZNEJ

Ministerstwo Finansów

XML Schema. Bartłomiej Świercz. Łódź, 19 listopada 2005 roku. Katedra Mikroelektroniki i Technik Informatycznych. Bartłomiej Świercz XML Schema

Urzędowa Poczta Elektroniczna (UPE)

INSTRUKCJA DLA INTEGRATORA SYSTEMU DOSTAWCA TOŻSAMOŚCI

SOAP i alternatywy. 1. WSDL. 2. Protokoły tekstowe XML-RPC. JSON-RPC. SOAPjr. 3. Protokoły binarne Google Protocol Bufers. Apache Thrift.

Ministerstwo Finansów

Dokumentacja. Wersja: 1.5 Ostatnio zmodyfikowano: Strona 1

Dictionaries. <?xml version="1.0" encoding="utf-8"?> <xs:schema attributeformdefault="unqualified" elementformdefault="unqualified"

Otwarte protokoły wymiany informacji w systemach ITS

Dokumentacja API Stacja z Paczką ver. 2.09

- wewnątrz elementów prostych występuje tylko jeden typ danych, wewnątrz złoŝonych nie moŝemy dokładnie określić liczby wystąpień elementu

Język XML Schema. UEK w Krakowie Janusz Stal & Grażyna Paliwoda-Pękosz. UEK w Krakowie Janusz Stal & Grażyna Paliwoda-Pękosz

Warszawa, dnia 6 sierpnia 2018 r. Poz. 1487

Integracja Comarch e-sprawozdania

Spis treści DOKUMENTACJA TECHNICZNA. STS API wersja 1.1

Gatesms.eu Mobilne Rozwiązania dla biznesu

LAB 7. XML EXtensible Markup Language - Rozszerzalny Język Znaczników XSD XML Schema Definition Definicja Schematu XML

Warszawa, dnia 14 kwietnia 2017 r. Poz. 787 ROZPORZĄDZENIE MINISTRA ROZWOJU I FINANSÓW 1) z dnia 12 kwietnia 2017 r.

Załącznik Nr 1 do Uchwały Nr XX/356/11 Rady Miasta Gdańska z dnia 24 listopada 2011 r.

System DiLO. Opis interfejsu dostępowego v. 2.0

Wymagania techniczne w zakresie Systemu Okresowego Raportowania Parametrów Pracy Pojazdu, Rejestru obsady zadań przewozowych oraz Rejestru Pojazdów

DPDInfoServices. Specyfikacja biznesowa. Version DPD Polska Sp. z O.O. Warszawa

API przekazy masowe - Dokumentacja. v 1.1, czerwiec 2014 KIP S.A. ul. Św. Marcin 73/ Poznań.

Cennik dot. integracji z firmami wywozowymi i oprogramowania urządzeń mobilnych. Opis rozwiązania dla firm wywozowych.

PHP5 WebServices vs MS.NET vs Java vs Java Mobile

SSL Reseller. Dokumentacja techniczna v.1.0 z dnia

Płatności CashBill - SOAP

SoftVig Systemy Informatyczne Sp. z o.o. Szczecin , ul. Cyfrowa 4

Wymagania techniczne w zakresie Systemu Okresowego Raportowania Parametrów Pracy Pojazdu, Rejestru obsady zadań przewozowych oraz Rejestru Pojazdów

XML Schema. Typy proste, wyprowadzanie typów, modularyzacja schematu. Patryk Czarnik. Instytut Informatyki UW

Sprawdzenie stanu opłacenia pakietu Zlecenie sprawdzenia stanu opłacenia... 23

(Dz. U. z dnia 17 listopada 2006 r.)

Opis wymagań dotyczących wyposażenia pojazdów, w tym oznakowania pojemników, oraz rejestracji zdarzeń i wymiany informacji.

Dokumentacja API serwisu KurierSerwis.com

Obsługa aplikacji Walne Zgromadzenia. Instrukcja użytkownika. wersja 6.1

Geovertical Map Server API 1.2

Dokumentacja API Stacja z Paczką ver. 2.14

extensible Markup Language, cz. 4 Marcin Gryszkalis, mg@fork.pl

1. Wstęp 2. Adres usługi 3. Konfiguracja 4. Metody 5. Typy danych 6. Przykład wywołania metody przy użyciu php i biblioteki nusoap 7.

z dnia 2018 r. w sprawie zgłoszeń przewozu towarów

Dokumentacja API serwisu epaka.pl

Proces dwukierunkowej wymiany danych

Nazwa pliku XSD:

Automatyczne generowanie kodu. 4Developers, 26 marca 2010

XML extensible Markup Language. część 2

Równoległość w środowisku rozproszonym. Jarosław Kuchta Programowanie Współbieżne

Kielce, dnia roku. HB Technology Hubert Szczukiewicz. ul. Kujawska 26 / Kielce

MINISTERSTWO FINANSÓW PLAN INTEGRACJI SYSTEMU ZAŁĄCZNIK NR 6 SEAP SPECYFIKACJA KANAŁ DLA PODMIOTÓW ZEWNĘTRZNYCH PL PROJEKT ECIP/SEAP

Załącznik nr 14 Struktura logiczna korekty informacji podsumowującej o dokonanych wewnątrzwspólnotowych dostawach/nabyciach towarów (VAT-UEK)

WYMAGANIA TECHNICZNE W ZAKRESIE SYSTEMÓW OKRESOWEGO RAPORTOWANIA PARAMETRÓW PRACY POJAZDU. Załącznik nr 2 do SIWZ.

UCHWAŁA NR XXXVI RADY MIEJSKIEJ W ANDRYCHOWIE. z dnia 20 czerwca 2013 r.

Terytorialna analiza danych

Proces obsługi deklaracji Intrastat w systemie Celina WebCel

DOKUMENTACJA TECHNICZNA KurJerzyAPI wersja 1.0

1.1 Podłączenie Montaż Biurko Montaż naścienny... 4

Specyfikacja sms-api.pl

Specyfikacja modułu API systemu LimApi platformy limtel.pl

ipfon Web Services API wersja 1.0.3

Warszawa, dnia 27 lutego 2017 r. Poz. 366

XML Schema. Motywacja, struktura schematu, typy złożone. Patryk Czarnik. Instytut Informatyki UW

Wprowadzenie do XML schema

Specyfikacja HTTP API. Wersja 1.6

techniczne warunki przekazu danych przetwarzanych i gromadzonych przez Krajowy System Informatyczny

Specyfikacja techniczna interfejsu do obsługi Profilu Kandydata na Kierowcę.

Paczkomaty API XML D-ST D - Informacja publiczna DOCUMENT ID:

EMCS4B / Nowy Konektor EMCS PL

Model Wymiany Danych dla dostępu do aplikacji CHECK przy użyciu WebService Telekomunikacja Polska S.A. - Przedsiębiorca telekomunikacyjny

Schematy XML. Tomasz Traczyk.

Warszawa, dnia 2 marca 2017 r. Poz. 461 ROZPORZĄDZENIE MINISTRA ROZWOJU I FINANSÓW 1) z dnia 27 lutego 2017 r.

WEBSERVICE SIDDIN 2.1 PROTOKÓŁ NICCI 3.1 PRZYKŁADY ZAPYTAŃ I ODPOWIEDZI ŚCIEŻKA DODANIA INFORMACJI GOSPODARCZEJ

Specyfikacja API Runtime BAS 3.0

MINISTERSTWO FINANSÓW PLAN INTEGRACJI SYSTEMU ZAŁĄCZNIK NR 2 SEAP SPECYFIKACJA XML INTERFEJS WEBSERVICE DLA PODMIOTÓW ZEWNĘTRZNYCH PL

COMMAX CDV-70UX - USTAWIENIE PRACY URZĄDZEŃ MOBILNYCH

Instrukcja wytwarzania adapterów dla systemów dziedzinowych

XML extensible Markup Language. część 4

Transkrypt:

Szczegółowy Opis Interfejsu Wymiany Danych Załącznik nr 1.8.

Spis treści: 1 Wstęp... 3 2 Schemat wymiany danych:... 3 3 Opis wymagań dla transmitowanych danych... 4 4 Metody... 4 4.1 Logowanie... 4 4.1.1 Klucz sesyjny... 4 4.1.2 Funkcja: Login()... 5 4.1.3 Rozpoczęcie wymiany danych... 5 4.2 GetVehicleList... 5 4.3 GetVehicleById... 7 4.4 GetVehicleListLastState... 9 4.5 GetVehicleEvents... 11 4.6 GetFuncModificationStatus... 14 4 Opis typów danych... 16 5 WSDL... 18 1/2015 Strona 2 z 20

1 Wstęp Niniejsza specyfikacja określa wymagania Zamawiającego dla zakresu danych otrzymywanych od operatorów dotyczących systemu utrzymania dróg oraz sposobu ich wymiany między systemami informatycznymi Wykonawcy i Zamawiającego. Jako zakres wymaganych informacji transmitowanych poprzez interfejs wymiany danych, należy przyjąć zakres danych zawartych w poszczególnych metodach szczegółowo opisanych w kolejnych rozdziałach. 2 Schemat wymiany danych: Celem wymiany danych jest przekazanie do Systemu Zamawiającego, danych zarejestrowanych przez pojazdy Wykonawców. Wszelkie rejestrowane dane i opisane w niniejszym dokumencie informacje, powinny być na bieżąco (w trybie online) przekazywane w oparciu o interfejs wymiany danych wykonany w technologii webservice. Transfer danych odbywa się za pomocą interfejsu wymiany danych opartym o usługę internetową udostępnioną przez Wykonawcę i działającym w oparciu o żądania HTTPS. Rys. 1. Realizacja wymiany danych między Systemami wykonawców a zamawiającego 1/2015 Strona 3 z 20

3 Opis wymagań dla transmitowanych danych Transmisja danych z urządzeń o których mowa poniżej musi być jednoczesna z transmisją danych z systemu monitoringu GPS. Wszystkie zarejestrowane zdarzenia (Płużenie, posypywanie, polewanie, zamiatanie)muszą być rozszerzone o dokładną datę i czas [zgodny z uniwersalnym czasem koordynowanym UTC(PL)] oraz współrzędne geograficzne zdarzeń wyznaczone na podstawie systemu GPS Tabela 1. Wymagania odnośnie częstotliwości rejestracji danych przez pojazdy wykonawców. Typ zdarzenia Punkty Jazdy Zmiana kierunku przemieszczania się pojazdu Punkty postoju Zdarzenie płużenia Zdarzenie posypu Zdarzenia polewania Zdarzenie zamiatania Moment Rejestracji Gdy pojazd jest w ruchu nie rzadziej niż co 100m lub co 5 sekund Zmiana kąta o 30 stopni Gdy pojazd stoi, nie rzadziej niż co 5 minut Natychmiast po wystąpieniu zdarzenia Natychmiast po wystąpieniu zdarzenia Natychmiast po wystąpieniu zdarzenia Natychmiast po wystąpieniu zdarzenia 4 Metody 4.1 Logowanie 4.1.1 Klucz sesyjny Celem zagwarantowania bezpieczeństwa na przesyłane przez wykonawców dane, wprowadzono autoryzację polegającą na wpisaniu nazwy użytkownika oraz hasła wraz z numerem Rejonu. Po uzupełnieniu danych pod warunkiem ich poprawności, zwracany jest tzw. klucz sesyjny, który jest niezbędny do wywołania poszczególnych funkcji (poza Login). Dzięki niemu uzyskiwany jest dostęp do danych Operatorów. W przypadku podania błędnego lub klucza który utracił ważność, wywoływana funkcja nie zwróci danych, lecz zasygnalizuje problem odpowiednim statusem. Klucz sesyjny ma swój okres ważności. W przypadku, gdy przez pewien określony czas nie będzie wywołana żadna funkcja przy jego użyciu, zostanie uznany za nieważny. 1/2015 Strona 4 z 20

4.1.2 Funkcja: Login() Opis Funkcja zwraca klucz sesyjny wykorzystywany do komunikacji z webservices Operatora. Wejście Nazwa użytkownika, hasło oraz identyfikator Rejonu: User: string, Pass: string, CustomerNumber: Integer. Wyjście Klucz sesyjny jako ciąg znaków (string) pozwalający na wywołanie pozostałych funkcji. 4.1.3 Rozpoczęcie wymiany danych W celu ustalenia zakresu i ilości danych do pobrania z Systemu Operatora, System zamawiającego rozpoczyna wymianę danych od ustalenia momentu ostatniej zmiany danych w Systemie Operatora (w podziale na typy danych i dokumentów). Jeżeli data ostatniej zmiany danych jest późniejsza, niż data ostatniego pobrania danych, system zamawiającego pobiera nowe dane, wykorzystując stosowne funkcje. 4.2 GetVehicleList Funkcja zwraca listę pojazdów używanych przez Operatora. Wejście: - Klucz sesyjny służący do uwierzytelnienia. - ModifiedAfter: DateTime data i czas od którego system powinien pobrać zmiany danych. Nazwa funkcji: Opis: Wyjście: GetVechicleList Lista pojazdów. Lista pojazdów w postaci dokumentu XML <?xml version="1.0" encoding="utf-8"?> <result> <vehicle id="1"> <name>przykładowy pojazd</name> <plate-number>kr 12345</plate-number> <mark>fiat</mark> <model>panda</model> <production-date>2006</production-date> <kerb-weight>1250</kerb-weight> <side-number>...</side-number> <last-modification>...</last-modification> </vehicle> <vehicle id="2"> </vehicle> <vehicle id="n"> </vehicle> </result> Rys. 2 Struktura pliku XML zwracanego przez funkcję GetVehicleList() 1/2015 Strona 5 z 20

Tabela 2. Opis parametrów zwracanych przez wywołanie metody GetVehicleList. Parametr: vehicle id name plate-number mark model production-date kerb-weight side-number Opis parametru: Identyfikator pojazdu Nazwa Numer rejestracyjny Marka Model Data produkcji Masa własna Numer boczny last-modification Data i czas ostatniej modyfikacji rekordu <xs:schema attributeformdefault="unqualified" elementformdefault="qualified" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="result"> <xs:element name="vehicle"> <xs:element type="xs:string" name="name"/> <xs:element type="xs:string" name="plate-number"/> <xs:element type="xs:string" name="mark"/> <xs:element type="xs:string" name="model"/> <xs:element type="xs:short" name="production-date"/> <xs:element type="xs:short" name="kerb-weight"/> <xs:element type="xs:string" name="side-number"/> <xs:element type="xs:datetime" name="last-modification"/> 1/2015 Strona 6 z 20

<xs:attribute type="xs:int" name="id" use="required"/> </xs:schema> Rys. 3 Diagram XSD dla metody GetVehicleList 4.3 GetVehicleById Funkcja zwraca parametry pojazdu o wskazanym identyfikatorze. Wejście: -Klucz sesyjny służący do uwierzytelnienia (SessionId) -IDPojazdu: (VevicleID) Nazwa funkcji: Opis: Wyjście: GetVehicleById Pobranie informacji tylko o jednym pojeździe. Opis pojazdu w postaci dokumentu XML <?xml version="1.0" encoding="utf-8"?> <result> <vehicle id="1"> <name>przykładowy pojazd</name> <plate-number>kr 12345</plate-number> <mark>fiat</mark> <model>panda</model> <production-date>2006</production-date> <kerb-weight>1250</kerb-weight> <side-number>...</side-number> <last-modification>...</last-modification> </vehicle> </result> Rys. 4 Struktura pliku XML zwracanego przez funkcję GetVehicleById() 1/2015 Strona 7 z 20

Tabela 3. Opis parametrów zwracanych przez wywołanie metody GetVehicleById Parametr: vehicle id name plate-number mark model production-date kerb-weight side-number last-modification Opis parametru: Identyfikator pojazdu Nazwa Numer rejestracyjny Marka Model Data produkcji Masa własna Numer boczny Data i czas ostatniej modyfikacji rekordu <xs:schema attributeformdefault="unqualified" elementformdefault="qualified" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="result"> <xs:element name="vehicle"> <xs:element type="xs:string" name="name"/> <xs:element type="xs:string" name="plate-number"/> <xs:element type="xs:string" name="mark"/> <xs:element type="xs:string" name="model"/> <xs:element type="xs:short" name="production-date"/> <xs:element type="xs:short" name="kerb-weight"/> <xs:element type="xs:string" name="side-number"/> <xs:element type="xs:datetime" name="last-modification"/> 1/2015 Strona 8 z 20

<xs:attribute type="xs:int" name="id" use="required"/> </xs:schema> Rys 5. Diagram XSD dla metody GetVehicleById 4.4 GetVehicleListLastState Funkcja zwraca informacje o bieżących pozycjach i stanach pojazdów. Opis: Wyjście: Informacje o bieżących pozycjach i stanu pojazdów w formie XML XML opisujący poszczególny aktualny stan wszystkich pojazdów Wejście: -Klucz sesyjny służący do uwierzytelnienia (SessionId) -ModifiedAfter: DateTime data i czas od którego pobrać dane <?xml version="1.0" encoding="utf-8"?> <result> <vehicle-state id="1"> <name>p1231</name> <datetime>2014-01-27 07:02:00</datetime> <country>pl</country> <gpscoordinates> <lat>52.3744234</lat> <long>16.2194345</long> </gpscoordinates> <state>jazda</state> <direction>282</direction> <velocity>9</velocity> <last-modification>2014-01-27 07:08:46</last-modification> <last-continous-data-event-modtime>2014-01-27 07:08:46</last-continous-data-event-modtime> <last-continous-data-event-time>2014-01-27 07:07:36</last-continous-data-event-time> </vehicle-state> </result> Rys. 6 Struktura pliku XML zwracanego przez funkcję GetVehicleListLastState Tabela 4. Opis parametrów zwracanych przez wywołanie metody GetVehicleListLastState 1/2015 Strona 9 z 20

Parametr: name Vehicle-state id datetime country latitude longitude state Opis parametru: Nazwa Identyfikator pojazdu Data Kraj Latitude Longitude Stan- (jazda, postój)- ostatnie zarejestrowane zdarzenie direction velocity last-modification Kierunek Prędkość Data i czas ostatniej modyfikacji rekordu last-continous-data-event-modtime Wskazuję datę i czas modyfikacji rekordu wskazanego przez pole Last-Continous-Data-Event-Time last-continous-data-event-time Wskazuje zarejestrowaną datę i czas wystąpienia ostatniego zdarzenia z ciągu zdarzeń które nie zostaną już zmodyfikowane. Oznacza to, że wszystkie zdarzenia zarejestrowane do tego czasu zostały już przesłane, nie występują już uzupełnienia i modyfikacje danych. Wszystkie dodane i zmodyfikowane w przyszłości rekordy będą miały datę i czas większy lub równy wskazanemu w tym polu <xs:schema attributeformdefault="unqualified" elementformdefault="qualified" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="result"> <xs:element name="vehicle-state"> <xs:element type="xs:string" name="name"/> <xs:element type="xs:datetime" name="datetime"/> 1/2015 Strona 10 z 20

<xs:element type="xs:string" name="country"/> <xs:element name="gpscoordinates"> <xs:element type="xs:float" name="lat"/> <xs:element type="xs:float" name="long"/> <xs:element type="xs:string" name="state"/> <xs:element type="xs:short" name="direction"/> <xs:element type="xs:short" name="velocity"/> <xs:element type="xs:string" name="last-modification"/> <xs:element type="xs:datetime" name="last-continous-data-event-modtime"/> <xs:element type="xs:datetime" name="last-continous-data-event-time"/> <xs:attribute type="xs:int" name="id"/> </xs:schema> Rys. 7 Diagram XSD dla metody GetVehicleListLastState 4.5 GetVehicleEvents Funkcja zwraca dane dotyczące pojazdu za zadany zakres czasu. 1/2015 Strona 11 z 20

Opis: Wyjście: Dane dla pojazdu za zadany zakres czasu. XML opisujący zdarzenia wykonane w zadanym przedziale czasu Wejście: - Klucz sesyjny służący do uwierzytelnienia (SessionId) - Identyfikator pojazdu (int, VehicleId) - Data początkowa zakresu czasu dla danych(datetime, DateTimeFrom) - Data końcowa zakresu czasu dla danych (DateTime, DateTimeTo) - ModifiedAfter: DateTime data i czas od którego pobrać dane <?xml version="1.0" encoding="utf-8"?> <result update-date-time="2013-01-27 10:43:01"> <event id= 1 > <vehicle-id>1</vehicle-id> <event-type-id>1</event-type-id> <gpscoordinates> <lat>52.0323</lat> <lon>19.3346</lon> </gpscoordinates> <startdatetime>2010-08-17 16:40:53</startdatetime> <enddatetime>2010-08-17 16:40:55</enddatetime> <maxspeed> </maxspeed> <distance>0</distance> <direction>0</direction> <last-modification>2010-08-17 16:40:53</last-modification> </event> </result> Rys. 8 Struktura pliku XML zwracanego przez funkcję GetVehicleEvents Tabela 5. Opis parametrów zwracanych przez wywołanie metody GetVehicleEvents Parametr: vehicle-id event id event-type-id startdatetime enddatetime gpscoordinates Maxspeed Distance Direction Last-modification Opis parametru: Identyfikator pojazdu unikalny identyfikator zdarzenia Identyfikator typu zdarzenia (wg. Tabela5) Data i czas rozpoczęcia zdarzenia Data i czas zakończenia zdarzenia (Latitude, Longitude) Długość i szerokość geograficzna Prędkość maksymalna od poprzedniego zarejestrowanego punktu w km/h Dystans przebyty od ostatniego zdarzenia w metrach Kierunek jazdy (azymut) w stopniach. Data i czas ostatniej modyfikacji rekordu 1/2015 Strona 12 z 20

Tabela 6. Opis identyfikatorów zdarzeń zwracanych poprzez wywołanie metody GetVehicleEvents Event-Type-Id Zdarzenie 1 Jazda 2 postój 3 płużenie 4 posypywanie 5 polewanie 6 zamiatanie <xs:schema attributeformdefault="unqualified" elementformdefault="qualified" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="result"> <xs:element name="event"> <xs:element type="xs:int" name="vehicle-id"/> <xs:element type="xs:long" name="event-type-id"/> <xs:element name="gpscoordinates"> <xs:element type="xs:float" name="lat"/> <xs:element type="xs:float" name="long"/> 1/2015 Strona 13 z 20

<xs:element type="xs:datetime" name="startdatetime"/> <xs:element type="xs:datetime" name="enddatetime"/> <xs:element type="xs:byte" name="maxspeed"/> <xs:element type="xs:short" name="distance"/> <xs:element type="xs:byte" name="direction"/> <xs:element type="xs:datetime" name="last-modification"/> <xs:attribute type="xs:byte" name="id"/> <xs:attribute type="xs:string" name="update-date-time"/> </xs:schema> Rys. 9 Diagram XSD dla metody GetVehicleEvents 4.6 GetFuncModificationStatus Nazwa funkcji: Opis: Wyjście: GetFuncModificationStatus Pobranie informacji o ostatniej aktualizacji danych dostępnych przez interfejsy do integracji Lista funkcji ze statusem modyfikacji w postaci dokumentu XML 1/2015 Strona 14 z 20

Wejście: - Klucz sesyjny służący do uwierzytelnienia (SessionId) - ModifiedAfter: DateTime data i czas od którego pobrać dane <?xml version="1.0" encoding="utf-8"?> <result> <functions> <function> <name>getvehiclelist</name> <last-modification>2014-12-14 15:46:20</last-modification> </function> <function> <name>getvehicleevents</name> <last-modification>2014-11-14 15:46:20</last-modification> </function> </functions> </result> Rys. 10 Struktura pliku XML zwracanego przez funkcję GetFuncModificationStatus Tabela 7. Opis parametrów zwracanych przez wywołanie metody GetFuncModificationStatus Parametr: Name Last-modification Opis parametru: Nazwa metody Data modyfikacji <xs:schema attributeformdefault="unqualified" elementformdefault="qualified" xmlns:xs="http://www.w3.org/2001/xmlschema"> <xs:element name="result"> <xs:element name="functions"> <xs:element name="function"> <xs:element type="xs:string" name="name"/> 1/2015 Strona 15 z 20

<xs:element type="xs:string" name="last-modification"/> </xs:schema> Rys. 11 Diagram XSD dla metody GetFuncModificationStatus 4. Opis typów danych Tabela 8. Opis typów danych. Parametr: Opis parametru: Typ vehicle id Identyfikator pojazdu int name Nazwa pojazdu string plate-number Numer rejestracyjny string mark Marka string model Model string production-date Data produkcji short kerb-weight Masa własna short side-number Numer boczny string last-modification Data i czas ostatniej modyfikacji rekordu datetime datetime Data datetime country Kraj string 1/2015 Strona 16 z 20

latitude Latitude double longitude Longitude double state Stan- (jazda, postój)- ostatnie zarejestrowane zdarzenie string direction Kierunek double velocity Prędkość double last-modification Data i czas ostatniej modyfikacji rekordu datetime last-continous-dataevent-modtime last-continous-dataevent-time Wskazuję datę i czas modyfikacji rekordu wskazanego przez pole Last-Continous-Data-Event- Time Wskazuje zarejestrowaną datę i czas wystąpienia ostatniego zdarzenia z ciągu zdarzeń które nie zostaną już zmodyfikowane. Oznacza to, że wszystkie zdarzenia zarejestrowane do tego czasu zostały już przesłane, nie występują już uzupełnienia i modyfikacje danych. Wszystkie dodane i zmodyfikowane w przyszłości rekordy będą miały datę i czas większy lub równy wskazanemu w tym polu datetime datetime vehicle-id Identyfikator pojazdu int event id unikalny identyfikator zdarzenia long event-type-id Identyfikator typu zdarzenia (wg. Tabela5) int startdatetime Data i czas rozpoczęcia zdarzenia datetime enddatetime Data i czas zakończenia zdarzenia datetime Maxspeed Prędkość maksymalna od poprzedniego zarejestrowanego punktu w km/h short Distance Dystans przebyty od ostatniego zdarzenia w metrach short Direction Kierunek jazdy (azymut) w stopniach. short Last-modification Data i czas ostatniej modyfikacji rekordu datetime 1/2015 Strona 17 z 20

5. WSDL <wsdl:definitions xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://localhost/" xmlns:intf="http://localhost/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns1="urn:uxmlremotable" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/xmlschema" targetnamespace="http://localhost/"> <wsdl:types> <schema xmlns="http://www.w3.org/2001/xmlschema" targetnamespace="urn:uxmlremotable"> <import namespace="http://schemas.xmlsoap.org/soap/encoding/"/> <complextype name="txmlremotable"> <sequence> <element name="status" type="xsd:int"/> <element name="xml" type="xsd:string"/> </sequence> </complextype> </schema> </wsdl:types> <wsdl:message name="getvehiclelistlaststaterequest"> <wsdl:part name="sessionid" type="xsd:string"></wsdl:part> <wsdl:part name="modifiedafter" type="xsd:datetime"></wsdl:part> <wsdl:message name="getvehiclelistresponse"> <wsdl:part name="return" type="tns1:txmlremotable"></wsdl:part> <wsdl:message name="getvehiclebyidrequest"> <wsdl:part name="sessionid" type="xsd:string"></wsdl:part> <wsdl:part name="vehicleid" type="xsd:int"></wsdl:part> <wsdl:message name="getvehiclelistrequest"> <wsdl:part name="sessionid" type="xsd:string"></wsdl:part> <wsdl:part name="modifiedafter" type="xsd:datetime"></wsdl:part> <wsdl:message name="loginresponse"> <wsdl:part name="return" type="xsd:string"></wsdl:part> <wsdl:message name="getvehicleeventsresponse"> <wsdl:part name="return" type="tns1:txmlremotable"></wsdl:part> <wsdl:message name="getvehicleeventsrequest"> <wsdl:part name="sessionid" type="xsd:string"></wsdl:part> <wsdl:part name="vehicleid" type="xsd:int"></wsdl:part> <wsdl:part name="modifiedafter" type="xsd:datetime"></wsdl:part> <wsdl:part name="datefrom" type="xsd:datetime"></wsdl:part> <wsdl:part name="dateto" type="xsd:datetime"></wsdl:part> <wsdl:message name="loginrequest"> <wsdl:part name="user" type="xsd:string"></wsdl:part> <wsdl:part name="password" type="xsd:string"></wsdl:part> <wsdl:part name="customernumber" type="xsd:int"></wsdl:part> <wsdl:message name="getvehiclebyidresponse"> <wsdl:part name="return" type="tns1:txmlremotable"></wsdl:part> <wsdl:message name="getvehiclelistlaststateresponse"> <wsdl:part name="return" type="tns1:txmlremotable"></wsdl:part> <wsdl:message name="getfuncmodificationstatusresponse"> <wsdl:part name="return" type="tns1:txmlremotable"></wsdl:part> <wsdl:message name="getfuncmodificationstatusrequest"> 1/2015 Strona 18 z 20

<wsdl:part name="sessionid" type="xsd:string"></wsdl:part> <wsdl:porttype name="iazwebservice"> <wsdl:operation name="login" parameterorder="user Password CustomerNumber"> <wsdl:input message="impl:loginrequest" name="loginrequest"></wsdl:input> <wsdl:output message="impl:loginresponse" name="loginresponse"></wsdl:output> <wsdl:operation name="getvehiclelist" parameterorder="sessionid ModifiedAfter"> <wsdl:input message="impl:getvehiclelistrequest" name="getvehiclelistrequest"></wsdl:input> <wsdl:output message="impl:getvehiclelistresponse" name="getvehiclelistresponse"></wsdl:output> <wsdl:operation name="getvehiclebyid" parameterorder="sessionid VehicleID"> <wsdl:input message="impl:getvehiclebyidrequest" name="getvehiclebyidrequest"></wsdl:input> <wsdl:output message="impl:getvehiclebyidresponse" name="getvehiclebyidresponse"></wsdl:output> <wsdl:operation name="getvehiclelistlaststate" parameterorder="sessionid ModifiedAfter"> <wsdl:input message="impl:getvehiclelistlaststaterequest" name="getvehiclelistlaststaterequest"></wsdl:input> <wsdl:output message="impl:getvehiclelistlaststateresponse" name="getvehiclelistlaststateresponse"></wsdl:output> <wsdl:operation name="getvehicleevents" parameterorder="sessionid VehicleId ModifiedAfter DateFrom DateTo"> <wsdl:input message="impl:getvehicleeventsrequest" name="getvehicleeventsrequest"></wsdl:input> <wsdl:output message="impl:getvehicleeventsresponse" name="getvehicleeventsresponse"></wsdl:output> <wsdl:operation name="getfuncmodificationstatus" parameterorder="sessionid"> <wsdl:input message="impl:getfuncmodificationstatusrequest" name="getfuncmodificationstatusrequest"></wsdl:input> <wsdl:output message="impl:getfuncmodificationstatusresponse" name="getfuncmodificationstatusresponse"></wsdl:output> </wsdl:porttype> <wsdl:binding name="iazwebserviceportsoapbinding" type="impl:iazwebservice"> <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="login"> <wsdlsoap:operation soapaction="urn:azwebserviceintf-iazwebservice#login"/> <wsdl:input name="loginrequest"> namespace="urn:azwebserviceintf-iazwebservice" use="encoded"/> </wsdl:input> <wsdl:output name="loginresponse"> namespace="http://localhost/" use="encoded"/> </wsdl:output> <wsdl:operation name="getvehiclelist"> <wsdlsoap:operation soapaction="urn:azwebserviceintf-iazwebservice#getvehiclelist"/> <wsdl:input name="getvehiclelistrequest"> namespace="urn:azwebserviceintf-iazwebservice" use="encoded"/> </wsdl:input> <wsdl:output name="getvehiclelistresponse"> namespace="http://localhost/" use="encoded"/> </wsdl:output> <wsdl:operation name="getvehiclebyid"> 1/2015 Strona 19 z 20

<wsdlsoap:operation soapaction="urn:azwebserviceintf-iazwebservice#getvehiclebyid"/> <wsdl:input name="getvehiclebyidrequest"> namespace="urn:azwebserviceintf-iazwebservice" use="encoded"/> </wsdl:input> <wsdl:output name="getvehiclebyidresponse"> namespace="http://localhost/" use="encoded"/> </wsdl:output> <wsdl:operation name="getvehiclelistlaststate"> <wsdlsoap:operation soapaction="urn:azwebserviceintf- IAZWebService#GetVehicleListLastState"/> <wsdl:input name="getvehiclelistlaststaterequest"> namespace="urn:azwebserviceintf-iazwebservice" use="encoded"/> </wsdl:input> <wsdl:output name="getvehiclelistlaststateresponse"> namespace="http://localhost/" use="encoded"/> </wsdl:output> <wsdl:operation name="getvehicleevents"> <wsdlsoap:operation soapaction="urn:azwebserviceintf-iazwebservice#getvehicleevents"/> <wsdl:input name="getvehicleeventsrequest"> namespace="urn:azwebserviceintf-iazwebservice" use="encoded"/> </wsdl:input> <wsdl:output name="getvehicleeventsresponse"> namespace="http://localhost/" use="encoded"/> </wsdl:output> <wsdl:operation name="getfuncmodificationstatus"> <wsdlsoap:operation soapaction="urn:azwebserviceintf- IAZWebService#GetFuncModificationStatus"/> <wsdl:input name="getfuncmodificationstatusrequest"> namespace="urn:azwebserviceintf-iazwebservice" use="encoded"/> </wsdl:input> <wsdl:output name="getfuncmodificationstatusresponse"> namespace="http://localhost/" use="encoded"/> </wsdl:output> </wsdl:binding> <wsdl:service name="iazwebserviceservice"> <wsdl:port binding="impl:iazwebserviceportsoapbinding" name="iazwebserviceport"> <wsdlsoap:address location="https://az.pl/gpsexportaz_server/services/iazwebserviceport"/> </wsdl:port> </wsdl:service> </wsdl:definitions> 1/2015 Strona 20 z 20