Załącznik nr 1 d OPZ Opis i specyfikacja interfejsu SI WCPR d wybranych systemów zewnętrznych Spis treści 1. OPIS I SPECYFIKACJA INTERFEJSU DO SYSTEMÓW DZIEDZINOWYCH... 2 1.1. Integracja z systemami dziedzinwymi... 2 1.2. Obsługa zdarzenia... 7 1.3. Pnwne twarcie zdarzenia... 7 1.4. Pnawianie przekazania zdarzenia / twarcia zdarzenia... 7 2. OPIS I SPECYFIKACJA INTERFEJSU DO UMM W WERSJI PILOTAŻOWEJ... 8 2.1. Opis i specyfikacja integracji SIWCPR z UMM w wersji piltażwej... 8 2.2. Integracja z UMM w wersji piltażwej... 8
1. OPIS I SPECYFIKACJA INTERFEJSU DO SYSTEMÓW DZIEDZINOWYCH W rzdziale przedstawina zstała specyfikacja raz pis działania interfejsu kmunikacyjneg Systemu Infrmatyczneg Wjewódzkich Centrów Pwiadamiania Ratunkweg z systemami dziedzinwymi typu SWD służb. 1.1. Integracja z systemami dziedzinwymi Systemy dziedzinwe psiadają płączenie z SI WCPR za pmcą Pdsystemu Integracji Danych (PID). PID jest party technlgię WebService, a systemy dziedzinwe są pdłączne w trybie dwukierunkwym. Mżna wyróżnić następujące lgiczne zestawy danych wymienianych: Zdarzenie Identyfikatr zdarzenia Miejsce zdarzenia Adres Pzycja na drdze Współrzędne gegraficzne zdarzenia Dane zgłaszająceg Numer telefnu Adres zgłaszająceg Opcjnalnie dane z PLI CBD Typ zdarzenia słwnik typów zdarzeń Opis zdarzenia Status zdarzenia (w tym w frmie wydrębnineg pwiadmienia refreshevent żądania aktualizacji wszystkich danych zdarzenia) Służby przydzielne d zdarzenia Infrmacje dyspzytrze Aktualny stan płączenia telefniczneg ze zgłaszającym Treść Zgłszenia Identyfikatr nagrania/treści zgłszenia treść ryginalneg zgłszenia WebService w PID pzwala na wymianę dwustrnną kmunikatów pmiędzy SI WCPR a systemami dziedzinwymi służb ratwniczych jak wywłania metd zdalnych interfejsów dziedzinwych SWD. Mżna wyróżnić następujące metdy interfejsu: P strnie SI WCPR getoriginalcall pbranie infrmacji treści zgłszenia updateevent aktualizacja zdarzenia ze strny SWD, w tym także aktualizacji statusu i zakńczenia zdarzenia setstatus aktualizacja statusu zdarzenia ze strny SWD, bez mdyfikacji pzstałych właściwści createevent utwrzenie zdarzenia przez SWD w systemie SI WCPR. Metda zwraca status utwrzenia zdarzenia raz identyfikatr zdarzenia utwrzneg p strnie SI WCPR. attachservicetevent dłączenie d zdarzenia innej dyspzytrni lub pnwne twarcie zdarzenia d bsługi przez dyspzytrnię już dłączną d zdarzenia ping weryfikacja działania systemu
P strnie systemu dziedzinweg SWD putevent wysłanie zdarzenia d służby dziedzinwej. ping weryfikacja działania systemu. Rzmieszczenie mdeli jest następujące: putevent przyjmuje EventMdel, zwraca OperatinStatusMdel, getoriginalcall zwraca OriginalCallMdel, jak argument przyjmuje riginalcallrequest, updateevent przyjmuje UpdateableEventMdel i zwraca OperatinStatusMdel setstatus przyjmuje EventStatusMdel i zwraca OperatinStatusMdel, każda zmiana statusu jest prpagwana d pzstałych dłącznych d zdarzenia służb. createevent przyjmuje CreateEventMdel, zwraca CreateEventStatusMdel attachservicetevent przyjmuje AttachServiceEventMdel zwraca OperatinStatusMdel ping jest bezparametrwe, zwraca OperatinStatusMdel Dla pól pcjnalnych typu prsteg nieprzekazanie wartści w kmunikacie znacza, że system ustawia wartść pustą. Rzróżniamy dwa typy aktualizacji: pełna lub cząstkwa. Aktualizacja pełna zawiera zarówn pis zdarzenia jak i infrmacje dtyczące aktualnych stanów płączeń dla wszystkich zgłszeń zawartych w zdarzeniu. Aktualizacja cząstkwa zawiera tylk sekcję parametrów i dtyczy zawsze tylk knkretneg zgłszenia, któreg stan telefniczny uległ zmianie. Ddatkw aktualizacja tylk parametrów nie wpływa na sequencenumber zdarzenia. Długść i szerkść gegraficzna dla elementu CallerLcatinInfrmatin jest wartścią wprwadzną ręcznie przez peratra lub przybliżną szerkścią bliczną na pdstawie bszaru pchdząceg z PLI-CBD, przy czym lkalizacja wprwadzna ręcznie psiada wyższy prirytet. Mżliwe przejścia dla stanu płączenia prezentuje pniższy diagram: stm Stany płączenia telefniczneg dla SWD Start Płączenie peratra zstał zakńczne. W przypadku trjpłączenia znacza t przekazanie zarządzania płączeniem dyspzytrwi i wyłączenie się peratra z rzmwy. W przypadku zwykłej rzmwy peratra ze zgłaszającym znacza t rzłączenie się przez peratra lub zgłaszająceg. EMCALL_END [Zakńczenie płączenia przez zgłaszająceg lub peratra (bez przekazania płączenia d dyspzytra)] [Nawiązanie płączenia wychdząceg d zgłaszająceg] EMCALL_TALKING [Nawiązanie płączenia 3PTY] EMCALL_TPTY Operatr prwadzi rzmwę ze zgłaszającym. [Nieudane nawiązanie trójpłączenia] [Wyłączenie się peratra z trójpłączenia] Kniec Zgłszenie jest w trakcie nawiązywania płączenia 3PTY z dyspzytrem. Stan trwa d mmentu rzpczęcia próby nawiązania płączenia d wyknania jednej z peracji: - rzłączenia się peratra z przekazanej d dyspzytra rzmwy (przejście d EMCALL_END), - nieudaneg zestawienia płączenia (pwrót d EMCALL_TALKING). Rys. Diagram stanów płączenia telefniczneg dla SWD
Sekwencja wymiany kmunikatów jest zbrazwana na pniższych diagramach: sd 05.01 Interfejs d SWD System dziedzinwy SWD putevent(eventmdel) peratinstatusmdel() par [Obsługa zdarzenia] lp pt Aktualizacja zdarzenia przez SI WCPR Pdsystem Integracji Danych SI WCPR Diagram pisuje spsób kmunikacji pmiędzy Służbą Ratwiczą w systemem SI WCPR. Diagram kmunikacji będzie taki sam niezależnie d teg, czy Służba d kmunikacji z SI WCPR będzie wykrzystywałą swój system, czy dedykwaną frmatkę udstępnianą przez SI WCPR. Scenariusz kmunikacji ma następujący przebieg. System dziedzinwy udstępnia WebService z metdą putevent i czekuje na zdarzenia z SI WCPR. Jeżeli w systemie SI WCPR znajduje się nwe zdarzenie t zstaje n wysłane d systemu dziedzinweg. Nwe zdarzenie trafia d klejki zdarzeń systemu dziedzinweg. putevent(eventmdel) peratinstatusmdel() lp alt [Aktualizacja statusu zdarzenia] setstatus(statusmdel) peratinstatusmdel() [Aktualizacja treści zdarzenia] updateevent(updateableeventmdel) peratinstatusmdel() [Pbranie URL nagrania] getoriginalcall(riginalcallrequest) riginalcallmdel() setstatus(closed) peratinstatusmdel() Rys. Sekwencja kmunikacji WebService SWD
sd 05.01.01 Interfejs d SWD System dziedzinwy SWD Pdsystem Integracji Danych SI WCPR pt Przydzielenie nwej służby d zdarzenia [służba przydzielająca pzstaje w bsłudzie zdarzenia] attachservicetevent (AttachServiceEventMdel) OperatinStatusMdel() [służba przydzielająca kńczy bsługę zdarzenia] attachservicetevent(attachserviceeventmdel ) OperatinStatusMdel() setstatus(transferred) pt Utwrzenie zdarzenia przez SWD createevent (CreateEventMdel) CreateEventStatusMdel() Rys. Sekwencja kmunikacji WebService SWD - kmunikaty twrzenia zdarzenia i dłączania służb przez SWD Otrzymanie zdarzenia bądź zdarzeń dla służby pwinn skutkwać niezwłcznym ustawieniem dpwiednieg statusu, następnie mże następwać sekwencja metd ustawiających status, aktualizujących zdarzenie bądź pbierających treść nagrania głsweg. Zakńczeniem prcesu bsługi zdarzenia pwinn być ustawienie statusu zakńczenia zdarzenia przez służbę. Każda służba (widąca lub nie) mże przekazać zdarzenie d dyspzytrni innej służby lub dłączyć inną służbę d zdarzenia. W tym celu wywłuje metdę attachservicetevent i p pzytywnym dłączeniu (trzymanie statusu rzpczęcia działań - INPROGRESS) mże zakńczyć zdarzenie statusem TRANSFERRED lub CLOSED.
W klejnych aktualizacjach zdarzenia zstaną zaktualizwane listy służb/dyspzytrni zadyspnwanych d zdarzenia. Służba mże przekazać zdarzenie d systemu SI WCPR. W tym celu zstanie wywłana metda createevent. Metda ta zwraca w strukturze identyfikatr zdarzenia nadany w SI WCPR. Klejna wymiana kmunikatów dbywa się za pmcą teg identyfikatra. W strukturze twrzneg zdarzenia mże zstać dłączna klekcji struktur zgłszeń. W tym przypadku SI WCPR nada identyfikatry również dla zgłszeń i przekaże je w strukturach CreateEventStatusMdel. W utwrznym zdarzeniu służba mże przekazać klekcję służb d zadyspnwania (maksymalnie p jednej dyspzytrni z każdeg rdzaju służb). Skutkiem takiej peracji jest przekazanie zadyspnwanym dyspzytrnim zdarzenia analgicznie d takiej peracji wyknanej przez peratra SI WCPR. Diagram stanów zdarzenia jest pkazany na pniższym rysunku: stm SWD Stany zdarzenia DELIVERROR Start [Błąd pdczas dstarczenia d służby] [Błąd pdczas dstarczenia d służby] REOPENED [Pprawne dstarczenie] STARTED [Dstarczenie pprawne d służby] DELIVERED [Dstarczenie pprawne d służby] [Pnwne twarcie zamknięteg zdarzenia] [Rzpczęcie bsługi zdarzenia] INPROGRESS [Pwrót d bsługi] [Pnwne twarcie przekazaneg zdarzenia] [Zakńczenie bsługi zdarzenia] [Pwrót d bsługi] [Pwrót d bsługi] [Przekazanie bsługi d innej służby i zakńczenie zdarzenia] [Odrzucenie bsługi] CLOSED TRANSFERRED REJECTED [Pnwne twarcie drzucneg zdarzenia] Kniec Rys. Diagram stanów zdarzenia Sygnalizacja pprawnści (DELIVERED) lub niepprawnści (DELIVERROR) dstarczenia zdarzenia d służby realizwana jest w ramach: dstarczenia zdarzenia p raz pierwszy d danej służby, pnwneg twarcia zdarzenia dla służby.
Pprawnść lub błąd dstarczenia późniejszych aktualizacji zdarzenia nie jest prezentwany w atrybutach statusu bsługi zdarzenia przez pszczególne służby. System dziedzinwy ma praw ustawiać status swjej bsługi zdarzenia na stany: INPROGRESS, CLOSED, REJECTED i TRANSFERRED. Pzstałe stany ustawiane są wyłącznie przez SI WCPR. 1.2. Obsługa zdarzenia Przydzielenie służby d zdarzenia skutkuje ustawieniem dla danej służby statusu STARTED. P tym statusie SI WCPR pdejmie próby dstarczenia d punktu styku danej służby zdarzenia metdą putevent. W przypadku pprawneg dstarczenia (wynik w OperatinStatusMdel = OK) status zdarzenia dla danej służby zstanie zmieniny przez SI WCPR na DELIVERED. W przeciwnym przypadku status zstanie zmieniny na DELIVERROR. Status ten zstanie zmieniny dpier w przypadku, gdy służba prawidłw dbierze zdarzenie przy klejnej próbie. Każda mdyfikacja zdarzenia rzsyłana jest d wszystkich służb zaangażwanych w zdarzenie. Rzesłanie aktualizacji zwiększy ple sequencenumber, które jest glbalnym licznikiem zmian w zdarzeniu. System SWD, który chce zdarzenie zmdyfikwać lub dłączyć nwą służbę d nieg, musi wysłać aktualizację z plem sequencenumber zwiększnym 1 w stsunku d aktualneg. W przypadku gdy ten parametr jest mniejszy bądź równy aktualizacja nie jest przyjmwana, a errrcde w OperatinStatusMdel przyjmie wartść 007. SequenceNumber nie występuje w przypadku zmiany statusu służby ze względu na fakt, że w tym przypadku nie występuje ryzyk nadpisania teg parametru przez inny system. SI WCPR uzna zdarzenie za pdjęte w przypadku gdy służba zmieni status na INPROGRESS. Zakńczenie zdarzenia t statusy CLOSED, TRANSFERRED (przekazane), REJECTED (drzucenie bsługi).aktualizacja stanu płączenia nie spwduje zmian pla sequencenumber. 1.3. Pnwne twarcie zdarzenia System SWD ma mżliwść pnwneg twarcia zdarzenia już zamknięteg. Rzważane są tu 2 przypadki: pnwne twarcie dla własnej służby raz pnwne twarcie dla innej służby. Dla pnwneg twarcie dla własnej służby system SWD pwinien ustawić status INPROGRESS i wznwić bsługę zdarzenia. Dla pnwneg twarcia dla innej służby system SWD służby wywłuje metdę dłączenia innej służby d zdarzenia. Jeżeli służba była już zaangażwana w t zdarzenie i zakńczyła jeg bsługę (w stanie CLOSED, TRANSFERRED lub REJECTED) zdarzenie dla służby dłącznej dstanie status REOPENED i służba dłączająca mże czekiwać na zmianę statusu przez SI WCPR na DELIVERED (w przypadku pprawneg dstarczenia d punktu styku danej służby) lub DELIVERROR (w przypadku błędu). W przypadku żądania pnwneg twarcia zdarzenia dla służby, której status bsługi jest inny niż CLOSED, TRANSFERRED lub REJECTED, w dpwiedzi na żądanie zwracany jest błąd kdzie 008. 1.4. Pnawianie przekazania zdarzenia / twarcia zdarzenia W przypadku dyspzycji inicjwanych w SI WCPR system psiada mechanizm autmatyczneg pnawiania (d skutku) wysłania zdarzenia d SWD w przypadku niedstarczenia. Niezaleznie d teg, wyknanie, przez system, akcji generującej klejną dyspzycję, pwduje natychmiastwe pnwienie wysłania zdarzenia d SWD. W przypadku dłączenia służby inicjwaneg przez SWD systemy dziedzinwe muszą mieć mżliwść pnwneg dłączenia służb d zdarzenia (attachservicetevent) w przypadku niepwdzenia pprzedniej peracji, c skutkuje pnwnym przesłaniem zdarzenia d wszystkich służb (c znacza także pinfrmwanie służby dłączającej inną służbę statusie przekazania). Jeśli Służba A dłącza Służbę B d zdarzenia i jedncześnie kntynuuje bsługę teg zdarzenia, t status błsugi Służby A nie zmienia się (wynika z aktualneg etapu bsługi przez Służbę A).
2. OPIS I SPECYFIKACJA INTERFEJSU DO UMM W WERSJI PILOTAŻOWEJ W rzdziale przedstawiny zstał pis realizacji integracji Systemu Infrmatyczneg Wjewódzkich Centrów Pwiadamiania Ratunkweg z piltażwym rzwiązaniem Uniwersalneg Mdułu Mapweg dstarczanym przez Główny Urząd Gedezji i Kartgrafii. Mduł zadyspnwanym zstał d zapewnienia wizualizacji na mapie cyfrwej lkalziacji sby zgłaszającej raz wizualizacji miejsca zdarzenia. 2.1.Opis i specyfikacja integracji SIWCPR z UMM w wersji piltażwej Na pniższym rysunku przestawiny zstał schemat integracji SI WCPR z UMM w wersji piltażwej. Rys. Schemat integracji SI WCPR z UMM w wersji piltażwej 2.2. Integracja z UMM w wersji piltażwej Uniwersalny Mduł Mapwy będzie dstępny dla rli Operatr. Integracja zstała zrealizwana za pmcą API Mdułu. W ramach integracji SI WCPR z Uniwersalnym Mdułem Mapwym w wersji piltażwej, zrealizwana zstała następująca funkcjnalnść:
Uruchmienie mdułu mapweg, Zamknięcie mdułu mapweg, Sygnalizacja stanu mdułu mapweg, Prezentacja lkalizacji sby dzwniącej za pmcą kształtu bszaru, Prezentacja lkalizacji sby dzwniącej za pmcą współrzędnych śrdka kształtu bszaru, Prezentacja lkalizacji sby zgłaszającej za pmcą adresu, Prezentacja lkalizacji sby zgłaszającej za pmcą współrzędnych, Prezentacja lkalizacji zdarzenia za pmcą adresu, Prezentacja lkalizacji zdarzenia za pmcą współrzędnych, Sygnalizacja statusu prezentacji lkalizacji, Opcje mapy, Lgwanie peracji Uniwersalneg Mdułu Mapweg. W pniższe tabeli przedstawiny zstał zbiór metd interfejsu API integracji SI WCPR z UMM, wraz ze wskazanie przekazywanych wartści w ramach każdej z metd. Metda/zdarzenie Funkcja w SIWCPR Dane z SI WCPR d UMM Dane przekazywane z UMM d SI WCPR UruchmMdulMapwy Uruchmienie mdułu mapweg. Adres URL serwera UMM. Clse Zamknięcie mdułu mapweg. Prezentacja lkalizacji sby dzwniącej za pmcą kształtu bszaru. Obiekt typu Shape Identyfikatr zadania typu string PkazLkalizacjeDzwniaceg Prezentacja lkalizacji sby dzwniącej za pmcą współrzędnych śrdka kształtu bszaru. Obiekt typu Pint Identyfikatr zadania typu string Prezentacja lkalizacji sby zgłaszającej za pmcą adresu. Obiekt typu Address Identyfikatr zadania typu string Prezentacja lkalizacji sby zgłaszającej za pmcą współrzędnych. Obiekt typu Pint Identyfikatr zadania typu string PkazMiejsceZdarzenia Prezentacja lkalizacji zdarzenia za pmcą adresu. Prezentacja lkalizacji zdarzenia za pmcą współrzędnych. Obiekt typu Address Obiekt typu Pint Identyfikatr zadania typu string Identyfikatr zadania typu string ZdarzenieZUruchmieniaMduluM apweg Uruchmienie mdułu mapweg. Lgwanie peracji Uniwersalneg Mdułu Mapweg. OdpwiedzZUruchmieniaMdulu Mapweg status uruchmienia mdułu mapweg. ZdarzenieZGekdwaniaAdresu Lgwanie peracji Uniwersalneg Mdułu Mapweg. OdpwiedzZGekdwaniaAdresu - status gekdwania adresu na współrzędne PrzyjecieZadaniaDRealizacji OdpwiedzZPrzyjeciaZadaniaDR ealizacji - identyfikatr zadania typu string PrzekazanieKmunikatuOBledzie Lgwanie peracji Uniwersalneg Mdułu Mapweg. TrescKmunikatu - kmunikat błędzie.
Rys. Diagram stanów prezentacji adresu w UMM
stm Stany wizualizacji lkalizacji wg współrzędnych Start UMM_NO_DATA [Operatr wprwadził dane z frmatki lub zstały trzymane z PLI CBD] UMM_NO_GEOCD [Wizualizacja] [Brak błędu w czekiwanym czasie] Jaki wynik wizualizacji? [Błąd inicjalizacji UMM, timeut dpwiedzi UMM, błąd wyknania peracji] [Przejście samczynne] UMM_GEOCD_OK UMM_GEOCD_ERROR [Usunięcie] [M dyfikacja] Usunięcie, czy mdyfikacja/wprwadzenie danych? Rys. Diagram stanów prezentacji kształtu bszaru lub współrzędnych w UMM