Integraatiosuunnitelma 1 (33) n integraatio Tiedonvälitysjärjestelmään Integraatiosuunnitelma
Integraatiosuunnitelma 2 (33) Versiohistoria Versio Pvm Laatijat Kommentti 0.1 29.08.2003 TVe Ensimmäinen versio 0.2 05.09.2003 TVe Ensimmäisen projektipalaverin asiat 0.21 23.09.2003 TVe Järjestelmän kuvausta 0.22 29.09.2003 MPi Järjestelmän kuvausta 0.23 03.10.2003 TVe Lisätty toisen projektipalaverin asiat 0.24 21.01.2004 MPi Lisätty kolmannen projektipalaverin asiat 0.25 29.01.2004 TVe Lisätty neljännen projektipalaverin asiat 0.3 30.01.2004 TVe Lisäyksiä lukuun 4 0.31 05.02.2004 TVe Täydennyksiä lukuihin 4 ja 5 0.4 20.02.2004 TVe Palaverin 13.2. kommentit ja korjaukset 0.5 23.02.2004 MPi Tarkennuksia ja uudelleen jäsentelyä lähinnä lukuun 4 0.51 25.02.2004 MPi Integraation toteutuksen kuvausta 0.52 27.02.2004 MPi Integraation toteutuksen kuvausta 0.6 02.03.2004 MPi Tarkennuksia Eijan ja Joukon kommenttien pohjalta 1.0 03.03.2004 TVe Asiakkaalle luovutettu versio TVe = Tommi Vesala MPi = Mika Pitkänen
Integraatiosuunnitelma 3 (33) Summary The aim of the projet is to make a integration plan how the road weather system will be integrated to the FinnRA s general data delivery servie (DDS). In the report the present funtionality road weather system is illustrated. Based on that the requirements for the integration are listed and the desired funtionality is planned. The road weather integration will produe three new data servies to the data delivery system. These are 1) road weather station data, 2) roadside amera pitures and 3) online traffi measurement data. In the funtional desription it is defined how the reeivers of the data an make order to the DDS and how the data requests will be handled. Also the different formats for delivering the data are defined. The plan also desribes how the road weather system will be tehnially integrated to the data delivery system and how this integration projet will be realized. The projet has been granted European Community finanial support in the field of Trans-European Networks - Transport.
Integraatiosuunnitelma 4 (33) SISÄLLYSLUETTELO 1. JOHDANTO... 6 1.1 MÄÄRITELMÄT JA LYHENTEET... 6 1.2 TIEDONVÄLITYSJÄRJESTELMÄ... 8 2. INTEGROITAVA JÄRJESTELMÄ... 9 2.1 PERUSTIEDOT... 9 2.2 KUVAUS JÄRJESTELMÄN LIITTYMISTÄ... 11 2.3 SIIRRETTÄVIEN TIETOJEN KUVAUS... 11 2.3.1 Mitä tietoa nykyisin välitetään ulospäin... 11 2.3.2 Mitä tietoa vastaanotetaan... 12 2.4 JÄRJESTELMÄN NYKYTILA JA NÄKEMYS ELINKAARESTA... 13 2.5 KUVAUS NYKYISESTÄ TOIMINNALLISUUDESTA TIEDONVÄLITYKSEEN LIITTYEN... 14 3. TOIMINTA TAVOITETILASSA... 14 3.1 UUDISTETTAVA TOIMINNALLISUUS... 14 3.2 UUSI TOIMINNALLISUUS... 14 3.3 MUUT VAATIMUKSET JA TOIVEET INTEGRAATIOLLE... 15 4. UUDEN TOIMINNALLISUUDEN MÄÄRITTELY... 15 4.1 TIETOPALVELUT... 15 4.2 TILAUSLOMAKKEET... 16 4.2.1 Yleistä... 16 4.2.2 Kelikamerakuvat... 17 4.2.3 Tiesäätiedot... 19 4.2.4 Ajantasainen liikennetieto... 23 4.2.5 Tilauslomakkeiden käsittely... 25 4.3 TIETOPYYNTÖPALVELUT...25 4.3.1 Tietopyyntöpalvelu 1 : Tiesäätieto... 25 4.3.2 Tietopyyntöpalvelu 2 : Kelikamerakuvat... 26 4.3.3 Tietopyyntöpalveluiden käsittely... 26 4.3.4 Tietopyyntöpalveluiden syöttölomake Tiehallinnon extranet:iin... 26 4.4 TIEDON FORMAATIT... 26 4.4.1 Kelikamerakuvat... 27 4.4.2 Tiesäätiedot ja Ajantasainen liikennetieto... 27 4.4.3 Tietopyyntöpalvelut... 28 5. JÄRJESTELMÄN INTEGRAATIO TIEDONVÄLITYSJÄRJESTELMÄÄN... 28 5.1 ALLI... 28 5.1.1 ALLIsta käytettävissä olevat palvelut ja toiminnallisuus... 28 5.1.2 ALLIin toiminnallisuuteen tarvittavat muutokset... 29 5.1.3 ALLIin tarvittavat uudet liittymät... 29 5.1.4 ALLIin tarvittavat uudet komponentit... 29 5.2 SONJA... 29 6. INTEGRAATION TOTEUTUKSEN KUVAUS... 30 6.1 ALLIIN TEHTÄVÄT UUDET LIITTYMÄT... 30 6.1.1 Tiesääkanta... 30 6.1.2 Kuvapalvelin... 32 6.2 ALLIIN TEHTÄVÄT UUDET KOMPONENTIT... 33
Integraatiosuunnitelma 5 (33) 6.3 SONJAAN TEHTÄVÄT KONFIGUROINNIT... 33 7. LIITTEET JA LÄHDEAINEISTO... 33
Integraatiosuunnitelma 6 (33) 1. JOHDANTO Tämä dokumentti kuvaa n integraation Tiehallinnon Tiedonvälitysjärjestelmään. Luku 2: Integroitava Järjestelmä on perusjärjestelmän esittely, jossa kuvataan mm. järjestelmän nykyiset liittymät, siirrettävät tiedot sekä nykyinen toiminnallisuus tiedonvaihtoon liittyen. Luku 3: Toiminta tavoitetilassa on perusjärjestelmän tavoitetilan kuvaus, eli vaatimukset ja uudet toiminnot. Luku 4: Uuden toiminnallisuuden määrittely sisältää tavoitetilan toiminnallisuuden määrittelyn. Luku 5: Järjestelmän integraatio Tiedonvälitysjärjestelmään on kuvaus ALLIn ja SONJAn käytettävästä toiminnallisuudesta sekä kuvaus tarvittavista muutoksista. Luku 6: Integraation toteutuksen kuvaus on integraation teknistä suunnittelua ja toteutuksen kuvausta. Luku alkaa yleisemmän tason kuvauksella ja menee vähitellen syvemmälle suunnittelun ja toteutuksen teknisiin yksityiskohtiin. Luvun lopussa kuvataan SONJAn konfigurointi. Luku 7: Liitteet ja lähdeaineisto listaa mahdolliset liitteet sekä integraatiosuunnitelman tekemisessä käytetyn lähdeaineiston. 1.1 Määritelmät ja lyhenteet Termi ALLI ALK ALK-palvelin ALK-palvelu Integraatiosuunnitelma Määritelmä Tiedonvälityksen hallintajärjestelmä Ajantasainen Liikenne ja Kelitieto HTML-sisältöä ALK-palveluun tuottava palvelu (Novou05:lla) ALKin www-palvelu Toiminnallinen ja tekninen suunnitelma kohdejärjestelmän integroimisesta Tiedonvälitysjärjestelmään.
Integraatiosuunnitelma 7 (33) Perusjärjestelmä Sanomanvälitysjärjestelmä Sanomanvälityspalvelin (Soni) SONJA SONJA tiimi Tiedonvälityksen hallintajärjestelmä LTS Tiesääasema Mittauspiste Tiedonvälitysjärjestelmä www.kalkati.net Tiedonvälitysjärjestelmään integroitava järjestelmä. = SONJA. Sanomanvälityspalvelimesta (Soni) sekä sitä tukevista palveluista ja komponenteista muodostuva kokonaisuus. Soni Softwaren sanomanvälitys- ja integraatiotuotteista muodostuva ohjelmistokokonaisuus. Tiehallinnon sanomanvälitysjärjestelmä Sanomanvälitysjärjestelmän hallintaja ohjaustiimi = ALLI. SONJAa tukeva järjestelmä, joka tarjoaa tiedonvälitykseen liittyviä palveluita operatiivisille järjestelmille. Liikennetiedon siirto-ohjelma Tiesääasemat mittaavat ajoolosuhteisiin vaikuttavia arvoja (esim. ilman lämpötila, sademäärä, tuulen nopeus, tienpinnan lämpötila) sekä ilmasta että tiestä. = Tiesääasema SONJAsta ja ALLIsta muodostuva kokonaisuus Liikenne- ja viestintäministeriön kirjastopalvelu liikenteen alan standardeille rajapinnoille.
Integraatiosuunnitelma 8 (33) 1.2 Tiedonvälitysjärjestelmä Kuva 1 Tiedonvälitysjärjestelmä Tiedonvälitysjärjestelmä muodostuu SONJA ja ALLI järjestelmistä. SONJA muodostuu Soni -sanomanvälityspalvelimesta ja sitä tukevista komponenteista, kuten palveluista ja adaptereista. ALLIn rooli on tarjota palveluita sekä SONJAlle että Tiehallinnon operatiivisille eli ns. perusjärjestelmille. Järjestelmän integraatio tiedonvälitysjärjestelmään aiheuttaa usein toimenpiteitä niin itse perusjärjestelmään, SONJAan kuin ALLIinkin.
Integraatiosuunnitelma 9 (33) 2. INTEGROITAVA JÄRJESTELMÄ 2.1 Perustiedot Järjestelmän nimi Järjestelmän omistaja (vastuuhenkilö, prosessi), yhteyshenkilöt Magnus Nygård (tienvarsiteknologiapäällikkö), Liikenteen Palvelut Yhteyshenkilöt: - tiesaatuki@tiehallinto.fi (Jouko Kantonen, Kimmo Toivonen, Eija Lahtinen) Järjestelmän toiminnallinen yleiskuvaus n tavoitteena on tuottaa luotettavaa ja oikea-aikaista sääja kelitietoa sekä ennusteita ko. tietoa tarvitseville selkeässä ja helposti hyödynnettävässä muodossa. Tiedot voidaan esittää numeerisena tai kuvainformaationa. Järjestelmä koostuu erilaisista tienvarsi-, tietojenkäsittely- ja tiedonsiirtolaitteista sekä ohjelmistoista. Järjestelmän perustana on Tiehallinnon noin 330 tiesääasemaa ja noin 245 kameraa. Tiesääasemat mittaavat ajo-olosuhteisiin vaikuttavia arvoja sekä ilmasta että tiestä. Tyypillisiä mitattavia arvoja ovat tienpinnan lämpötila ja ilman suhteellinen kosteus, sademäärä, tuulen suunta ja nopeus, ilman- ja maan lämpötila ja tienpinnan tila. Kameroita käytetään pääsääntöisesti kelin seurantaan, mutta myös liikenteen seurantaan. Kameroilta saadaan liikkuvaa kuvaa sekä pysäytyskuvia. Mitatut tiedot kerätään automaattisesti 10 keruukoneella 15-60 minuutin välein keskitettyyn tietokantaan, tiesääkantaan. Vastaavasti kelikameroilta kerätyt kuvat talletetaan kuvapalvelimelle. Tiesäätieto säilytetään tiesääkannassa 60 vrk, minkä jälkeen tiedot arkistoidaan. Tietokannan koko on noin 20 Gt. Kelikamerakuvia säilytetään kuvapalvelimella 1,5 vrk. Päivässä kuvia tulee noin 1,5 Gt. n tarkempi kuvaus löytyy mm. Tiesäätiedon laatukäsikirjasta [2].
Integraatiosuunnitelma 10 (33) Järjestelmän tekninen yleiskuvaus Käytettäessä tiesäätietoa teiden kunnossapitotoimenpiteiden ohjauksessa keskeisiä välineitä ovat Tiesää-Windows ja Web-Tiesää -ohjelmat. Tiesää-Windows on Windows-ympäristössä toimiva perinteinen työasemaohjelmisto, jolla voidaan katsella tiesäätietoja taulukkoina, käyrinä sekä karttapohjalla. Web-Tiesää -ohjelmassa on periaatteessa samat ominaisuudet toteutettuna selainpohjaisena. Lisäksi Web-Tiesääohjelmalla on mahdollista esittää kuvamateriaalia erilaisina animaatioina. Tiesää-Windows -ohjelma: - C++, Orale 8i SQL*Net, Windows XP Web-Tiesää -ohjelma: - Palvelin: C++/Java, Windows 2000 - Client: Java-appletti (JRE 1.3.1_07) Tiesääkanta: - Orale 8i (8.1.7.4.0.) Tiesäätiedot ja Ajantasainen liikennetieto ovat samassa tiesääkannassa, samassa taulussa. Kelikamerakuvat makaavat Windows NT pohjaisella tiedostopalvelimella, jolla on jaettu levyresurssi. Kuvat ovat piireittäin omissa alihakemistoissaan. Lisäksi järjestelmään kuuluu muita ohjelmistoja, kuten: - Kelianalyysiohjelmisto tiesääasemilla - Tiesääkeruuohjelmisto keruukoneilla (keruupalvelimilla) - Suosituslaskentaohjelmisto, jonka avulla tiesäätiedoista päätellään sään ja kelin mukaan ohjautuvien nopeusrajoitus- ja infomerkkien ohjausarvot - Liikennetietojen siirto-ohjelma (ftp-siirtoja valituille vastaanottajille, asii-tiedosto) Järjestelmän käyttöönottovuosi Ensimmäiset osat 1988, sen jälkeen osia aina nykyhetkeen saakka.
Integraatiosuunnitelma 11 (33) Järjestelmän tietopalvelut Tiesäätiedot Kelikamerakuvat Ajantasainen liikennetieto (Pekka Rajala, yht. henkilö) Järjestelmä välittää kunnossapidolle tietoa tieverkolla vallitsevista olosuhteista ja mahdollistaa näin kunnossapitotoimenpiteiden oikean ajoituksen ja resurssien käytön optimoinnin. Myös tienkäyttäjät saavat yhä enenevässä määrin kelitietoa tiesääjärjestelmältä TV:n, radion, Internetin sekä tienvarren muuttuvien merkkien välityksellä. 2.2 Kuvaus järjestelmän liittymistä 2.3 Siirrettävien tietojen kuvaus Järjestelmästä ei ole varsinaisia liittymiä ulospäin. Järjestelmän tietoja siirretään FTP-siirtoina määrätyille vastaanottajille. Osa siirroista on automatisoitu (ALK). Kunnossapitäjien kelikeskukset sekä Tiehallinnon liikennekeskukset, jotka ovat järjestelmän varsinaisia pääkäyttäjiä, käyttävät järjestelmän tiesäätietoa Tiesää-Windows ja Web-Tiesää -ohjelmien avulla. 2.3.1 Mitä tietoa nykyisin välitetään ulospäin Järjestelmästä välitetään ulospäin tiesäätietoja tiesääkannasta sekä kelikamerakuvia kuvapalvelimelta. Tiesäätietoja ja Liikennetietoja siirretään ftp:llä ajantasa-palvelimelle, joka tuottaa web-sisältöä Tiehallinnon ALK-palveluun. Tiesäätietoja siirretään myös toiselle webpalvelimelle ( forum Soneralla). Kelikamerakuvien koko on noin 100 kilotavua kpl, kuvat ovat jpeg-kuvia. Kuva otetaan keruuhetkellä, keruuväli vaihtelee. Tiesääkantaan tulee tiesäätietoja noin miljoona riviä päivässä. Tiesäätietoja säilytetään tiesääkannassa 60 vrk. Tämän jälkeen ne arkistoidaan (CD- ROM). Tiesäätietoja välitetään useita megatavuja päivässä.
Integraatiosuunnitelma 12 (33) Edellisten lisäksi tietoa välitetään ulospäin jonkin verran myös sähköpostilla. Sähköpostipyynnöt käsitellään manuaalisesti ja niihin vastataan sähköpostitse. Tieliikelaitokselle replikoidaan kaikki kerätyt Tiesää- ja Kelikameratiedot. Muuttuvien nopeusrajoitusten ohjaustiedot välitetään Mirosoftin OPCrajapintaa käyttäen. Nykyisiä asiakkaita: ALK Web (ladattavat tiedostot) MTV3 YLE (teksti-tv / aamulähetysten kelikamerakuvat / Eskon reitit www.yle.fi/eskonreitit) Tieliikelaitos Ilmatieteenlaitos Forea 2.3.2 Mitä tietoa vastaanotetaan SMHI (Sveriges meteorologiska oh hydrologiska institut) Viisas Oy (mobiili-palvelu www.viisasautoilija.fi ) BaltiRoads.net Sisään tuleva tieto on rajattu tämän integraation ulkopuolelle. Tässä kuitenkin yleiskatsaus vastaanotettavasta tiedosta: Tiehallinto hankkii säätietoa myös ulkopuolisilta: ennusteita numeerisina, teksti- ja karttamuotoisina, sadetutka- ja satelliittikuvia. Sääennusteet Ilmatieteenlaitokselta ja Forealta: FTP-siirtoina Volyymit n. 1 Gt / vuorokausi Ennusteet saadaan pakettina noin tunnin välein
Integraatiosuunnitelma 13 (33) Tutka- ja satelliittikuvat Ilmatieteenlaitokselta: FTP-siirtona Volyymit 100 Mt / vuorokausi Kuvat tulevat kuva kerrallaan 2.4 Järjestelmän nykytila ja näkemys elinkaaresta kehitettiin alkuaan teiden talvikunnossapidon tarpeisiin. Myös tienkäyttäjät saavat yhä enenevässä määrin kelitietoa tiesääjärjestelmältä TV:n, radion, Internetin sekä tienvarren muuttuvien merkkien välityksellä. Tienkäyttäjää palvellaan useiden välineiden kautta. Tiehallinnon Internetsivustojen käyttö tiesäätiedon seurantaan on lisääntynyt voimakkaasti. Sivustot muodostetaan osin automaattisesti määrävälein, jotta niiden ajantasaisuus säilyy. on monitahoinen kokonaisuus, joka koostuu useista erilaisista osista, kuten erityyppisistä mittalaitteistoista ja ohjelmistoista. Järjestelmä on ydinosiltaan toimiva ja vastaa hyvin nykyiseen tietojen keruu- ja hallintatarpeeseen. Laajuudesta ja monitahoisuudesta johtuen järjestelmä on kuitenkin koko ajan osittaisen kehityksen kohteena. Järjestelmän merkitys on kasvussa. Kiinnostus järjestelmän sisältämiin tietoihin nousee koko ajan niin Tiehallinnossa sisäisesti kuin ulkoisten sidosryhmienkin keskuudessa. Tällä hetkellä järjestelmän suurimmat kehityshaasteet liittyvätkin sen sisältämien tietojen hallittuun jakamiseen ulospäin. Uudet jakelukanavat (kolmansien osapuolien mobiili-palvelut), jakelumuodot (mm. XML) ja uudet sidosryhmät luovat haasteellisen näkymän kehittämiselle. Jakelun kehittämiseen liittyen nähdään, että järjestelmä tarvitsee yleisen palvelukannan tiedonvälityksen kehittämisen pohjaksi. Näin vältettäisiin varsinaisen operatiivisen kannan liika kuormitus tiedon jakeluun liittyen. Järjestelmän näkökulmasta on toivottavaa, että sen rooli olisi jatkossakin mittaustietojen kerääminen ja hallinnointi ja jakeluun liittyvät asiat voitaisiin keskittää ja hallinnoida muualla.
Integraatiosuunnitelma 14 (33) 2.5 Kuvaus nykyisestä toiminnallisuudesta tiedonvälitykseen liittyen 3. TOIMINTA TAVOITETILASSA Järjestelmässä ei ole nykyisin käyttöliittymän kautta tapahtuvaa tiedonvälitystoiminnallisuutta. Tiedonvälitystoiminnallisuutta ovat kuitenkin osin automatisoidut FTP-siirrot (LTS), joita järjestelmästä nykyisin tehdään. 3.1 Uudistettava toiminnallisuus 3.2 Uusi toiminnallisuus Kuten kohdassa 2.5 todettiin, ei järjestelmässä ole nykyistä tiedonvälitystoiminnallisuutta FTP-siirtoja lukuun ottamatta. Integraation myötä nykyiset FTP-siirrot voidaan hoitaa automatisoituina tilauksina tiedonvälitysjärjestelmän avulla. Integraatiohankkeen alussa tehtiin linjaus, jonka perusteella än ei tehdä uudistuksia. Uusi toiminnallisuus perustuu siten Tiedonvälitysjärjestelmän nykyiseen ja sinne integraation myötä rakennettavaan tiedonvälitystoiminnallisuuteen. Seuraavassa on lueteltu integraatiolle asetetut vaatimukset sekä kuvaukset halutusta toiminnallisuudesta ja toiminnoista: Ajantasaisen liikennetiedon sekä tiesäätietojen automaattinen välitys halutuille vastaanottajille halutuilta alueilta, halutussa muodossa (XML, CSV, JPG) ja halutulla jakelutavalla, esim. HTTP, sähköposti tai FTP (Huom! Jakelutapa liittyy muotovalintoihin). Kelikamerakuvien automaattinen välitys määritellyille vastaanottajille, halutuilta tieosuuksilta tai halutuilta kameroilta. Jakelutapa voidaan valita halutuksi (FTP, HTTP, sähköposti). Tietojen välittämisestä sekä siihen liittyvistä tiedoista on mahdollista saada raportteja. n tietoja on mahdollista saada tietopyynnön perusteella (automaattinen käsittely ja vastauksen lähetys). Pyyntö mahdollista tehdä Tiehallinnon www-sivuilla ja saada vastaus (pyydetty tieto) sähköpostilla.
Integraatiosuunnitelma 15 (33) Välitettävään tietoon (XML-muoto) voitava sisällyttää arvovastaavuudet (esim. anturin numero anturin nimi ). Sähköpostilla ja FTP:llä välitettävät tiesäätiedot CSV-muodossa. Dataa selittävät tiedostot välitetään liitteenä. XML-lähetykset HTTP:llä. Kaksi erilaista sisältöä: CSV:tä vastaava ja sellainen jossa arvovastaavuudet ja mittauspaikkojen attribuuttitieto mukana ( slim/fat ). Siirrettävien kuvien nimet on säilyttävä. Tilauksia tehtäessä nähtävä arvio yhden toimituksen koosta. Kaikille tilauksille on voitava määrittää toimitusten vanhenemisaika. Järjestelmän tietojen vastaanottajien lisääminen oltava vaivatonta (Huom: FTP-siirtojen dynaamisuus edellyttää SONJAn FTP Bridgen korvaamista räätälöidyllä FTP-palvelulla/adapterilla). 3.3 Muut vaatimukset ja toiveet integraatiolle Tietopalveluiden tuottaminen ei saa aiheuttaa vasteaikojen pidentymistä tai muuta haittaa n käytölle. Integraatioprojektissa on suoritettava kuormitustestaus. Edellytetään että SONJAn ja ALLIn käytettävyys on 24/7. Virheselvitykseen oltava selkeä prosessi (päivystävä tukinumero). 4. UUDEN TOIMINNALLISUUDEN MÄÄRITTELY 4.1 Tietopalvelut Integraation valmistuttua ALLIssa on käyttövalmiina seuraavat tietopalvelut: 1) Kelikamerakuvat 2) Tiesäätiedot 3) Ajantasainen liikennetieto (= Tiesäätiedot ilman historiatietoa)
Integraatiosuunnitelma 16 (33) 4.2 Tilauslomakkeet Tietopalveluiden käsittely ja hallinta on mahdollista luvussa 5.1.1. ALLIsta käytettävissä olevat palvelut ja toiminnallisuus kuvatuin tavoin. 4.2.1 Yleistä Seuraavissa kohdissa on kuvattu tietopalveluittain tilauslomakkeiden ulkoasu sekä toiminnallisuus. Kuvien ulkoasuissa ei kuitenkaan ole vielä huomioitu ALLIn visuaalista ilmettä (värit, logot, bannerit, tms.). Kaikille tilauslomakkeille tulee tietopalvelukohtaisten asioiden lisäksi toiminnallisuus, joka laskee ja kertoo arvion lähetyksen koosta (esim. n. 15 kuvaa => 1,5 Mt lähetys). Kameroiden osalta laskennassa käytetään 15 minuutin keruuväliä ja mittaustietojen osalta 20 minuutin. Tilauslomakkeiden valintalistoille tiedot haetaan tiesääkannasta ja jokaiseen tilauslomakkeeseen syötetään lisäksi tiedon formaatteihin ja jakelutapoihin (protokolliin) liittyvät tiedot.
Integraatiosuunnitelma 17 (33) 4.2.2 Kelikamerakuvat
Integraatiosuunnitelma 18 (33) 1. Käyttäjä voi määrittää rajauksen haettaville kameroille. Jos kentät ovat tyhjiä, haetaan listaan kaikki kamerat. Koordinaattien syöttäminen tuo luonnollisesti aina vain yhden kameran (lähimmän). Kamerajoukosta valitaan halutut listalle Lisää/Poista painikkein. 2. Määritetään aikajakso miltä ajalta kuvat aina lähetetään. 3. Määritetään tilaukselle voimassaoloaika, alkamisaika ja päättymisaika. Kohtien 1-3 tiedot ovat vakiot kaikille kohdan 4 aktivoitumismäärityksille. 4. Käyttäjä määrittää yhden tai useampia aktivoitumisaika määrityksiä tilaukselle. 5. Tallenna painike lisää aktivoitumisaika määrityksen listalle. Valitsemalla listan ID -sarakkeesta linkin, saa vastaavat aikamääritykset näkyville. 6. Haluttaessa voidaan rajata aineiston tuoreuteen liittyvä kriteeri, joka annetaan, jos tilaaja ei missään olosuhteissa halua ottaa vastaan tiettyä aikaa vanhempaa tietoa (eli jos toimitusprosessi jostain syystä viivästyy). Kuvassa näkyvän ja kerrotun lisäksi tilauslomakkeeseen tulee valinnat sisällön formaatista ja välitysprotokollasta (jakelutavasta). Kelikamerakuvien kohdalla mahdolliset valinnat on kuvattu seuraavassa taulukossa. Valintoja voi tehdä useamman / tilaus. Sisältöformaatti Protokolla (jakelutapa ) Sisällön kuvaus Sähköposti SMTP Kuva(t) liitteenä.zippaketissa Huomioitavaa Liitteeksi myös selitetiedosto, jossa tiedot: mikä kamera, aika, Kuvatiedostot FTP Kuva(t).zip-paketissa Jos käytetään nykyistä FTP Bridgeä, eivät vastaanottotiedot ole dynaamisesti määritettävissä XML1 HTTP Kevyt xml-rakenne XML-muodossa kuvat ovat base64-enkoodattuja XML2 HTTP XML-rakenteessa mukana kameran nimi + muuta attribuuttitietoa kannasta XML-muodossa kuvat ovat Base64-enkoodattuja
Integraatiosuunnitelma 19 (33) 4.2.3 Tiesäätiedot
Integraatiosuunnitelma 20 (33)
Integraatiosuunnitelma 21 (33) 1. Syöttölomake on vastaava kuin kelikameroissa. Ainoana lisäyksenä anturivalinnat, jotka toimivat samalla logiikalla kuin kameran- ja mittauspisteen valinta. Kuvassa näkyvän ja kerrotun lisäksi tilauslomakkeeseen tulee valinnat sisällön formaatista ja välitysprotokollasta (jakelutavasta). Tiesäätietojen kohdalla mahdolliset valinnat on kuvattu seuraavassa taulukossa. Valintoja voi tehdä useamman / tilaus. Sisältöformaatti Sähköposti (CSV1) Sähköposti (CSV2) Protokolla (jakelutapa ) SMTP SMTP Sisällön kuvaus CSV-tiedosto, jossa vaakarivillä yksi ajankohta CSV-tiedosto, jossa vaakarivillä yhden anturin mittaustieto CSV1 FTP CSV-tiedosto, jossa vaakarivillä yksi ajankohta CSV2 FTP CSV-tiedosto, jossa vaakarivillä yhden anturin mittaustieto XML1 HTTP CSV1-tiedostoa vastaava xml-rakenne XML2 HTTP Kuten edellä, mutta XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto XML3 HTTP CSV2-tiedostoa vastaava xml-rakenne XML4 HTTP Kuten edellä, mutta XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto XML1 FTP CSV1-tiedostoa vastaava xml-rakenne XML2 FTP Kuten edellä, mutta Huomioitavaa Mahdollisuus valita lähteekö liitteet mukaan Mahdollisuus valita lähteekö liitteet mukaan Jos käytetään nykyistä FTP Bridgeä, eivät vastaanottotiedot ole dynaamisesti määritettävissä Jos käytetään nykyistä FTP Bridgeä, eivät vastaanottotiedot ole dynaamisesti määritettävissä XML-rakenteessa
Integraatiosuunnitelma 22 (33) mukana kannassa oleva mittauspisteen attribuuttitieto XML3 FTP CSV2-tiedostoa vastaava xml-rakenne XML4 FTP Kuten edellä, mutta XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto
Integraatiosuunnitelma 23 (33) 4.2.4 Ajantasainen liikennetieto
Integraatiosuunnitelma 24 (33) Tietojen tilauslomake on periaatteessa samankaltainen kuin Tiesäätiedoilla, mutta tilaus koskee aina vain viimeisintä mittausta ja tilauslomakkeella on mahdollista asettaa anturin raja-arvo. 1. Jos halutaan käyttää tietyn anturin arvoa tiedon lähetyksen rajauksena, valitaan ruutu. Tällöin syötetään anturin nimi, operaattori ja arvo. Kuvan esimerkki viittaa siis tapaukseen, jossa anturin alueella on lunta (lumen syvyys > 0). Tällöin voitaisiin valinnan mukaan jättää joko kyseisen mittauspisteen tiedot pois lähetyksestä tai koko lähetys tekemättä. Huomioi, että nämä voivat tarkoittaa samaakin tilannetta, jos vain yksi mittapiste oli alun perin lähetyksen kohteena. Kuvassa näkyvän ja kerrotun lisäksi tilauslomakkeeseen tulee valinnat sisällön formaatista ja välitysprotokollasta (jakelutavasta). Ajantasaisen liikennetiedon kohdalla mahdolliset valinnat on kuvattu seuraavassa taulukossa. Valintoja voi tehdä useamman / tilaus. Sisältöformaatti Sähköposti (CSV1) Sähköposti (CSV2) Protokolla (jakelutapa ) SMTP SMTP Sisällön kuvaus CSV-tiedosto, jossa vaakarivillä yksi ajankohta CSV-tiedosto, jossa vaakarivillä yhden anturin mittaustieto CSV1 FTP CSV-tiedosto, jossa vaakarivillä yksi ajankohta CSV2 FTP CSV-tiedosto, jossa vaakarivillä yhden anturin mittaustieto XML1 HTTP CSV1-tiedostoa vastaava xml-rakenne XML2 HTTP Kuten edellä, mutta XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto XML3 HTTP CSV2-tiedostoa vastaava xml-rakenne XML4 HTTP Kuten edellä, mutta Huomioitavaa Mahdollisuus valita lähteekö liitteet mukaan Mahdollisuus valita lähteekö liitteet mukaan Jos käytetään nykyistä FTP Bridgeä, eivät vastaanottotiedot ole dynaamisesti määritettävissä Jos käytetään nykyistä FTP Bridgeä, eivät vastaanottotiedot ole dynaamisesti määritettävissä
Integraatiosuunnitelma 25 (33) XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto XML1 FTP CSV1-tiedostoa vastaava xml-rakenne XML2 FTP Kuten edellä, mutta XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto XML3 FTP CSV2-tiedostoa vastaava xml-rakenne XML4 FTP Kuten edellä, mutta XML-rakenteessa mukana kannassa oleva mittauspisteen attribuuttitieto 4.2.5 Tilauslomakkeiden käsittely 4.3 Tietopyyntöpalvelut 4.3.1 Tietopyyntöpalvelu 1 : Tiesäätieto Tiesääintegraatiossa ALLIin toteutetaan tietopalvelukohtaiset tilauslomakkeet ja niiden käsittely. Tilausten aktivoitumisesta vastaava palvelu toimii tilausten prosessoinnin herättäjänä. Aktivoituneita tilauksia vastaavat tiedot poimitaan tiesääkannasta tai kuvapalvelimelta ja muodostetaan TiedonvälitysXML -tiedosto, joka välitetään SONJAlle. SONJA puolestaan vastaa tarvittavista muunnoksista ja reitityksistä. Tilauslomakkeiden syötetietojen tarkistamisessa hyödynnetään ALLIin toteutettua sovelluslogiikkaa. Toteutetaan tietopyyntöjen rakenteen kuvaavat XML-skeemat. Skeemojen mukaisilla XML-pyynnöillä (HTTP request) voi käyttää toteutettavaa rajapintaa. Seuraavassa on kuvattu tietopyyntöjen tietosisältö. Asema [Numero/Nimi] Kellonaika [-24h - +3h ] Anturivalinta [perussetti/kaikki]
Integraatiosuunnitelma 26 (33) Sähköpostiosoite, johon data toimitetaan Data zipattuna ja mahdollista 50 vrk taaksepäin. 4.3.2 Tietopyyntöpalvelu 2 : Kelikamerakuvat 4.3.3 Tietopyyntöpalveluiden käsittely Kamera [Numero/Nimi] Kellonaika [kuvat 4h - +1h] Sähköpostiosoite, johon data toimitetaan Data zipattuna ja mahdollista 1vrk taaksepäin. Tietopyyntöjen vastausten sisällöt yhtenevät vastaavien Tietopalveluiden kanssa (sähköpostin vaakamuoto, selitteet liitteineen aina mukaan). Toteutetaan tietopyyntöpalvelut, jotka käsittelevät saapuvat tietopyynnöt ja muodostavat ja lähettävät niihin vastauksen. Rajaus: tässä integraatiossa ei toteuteta XML-vastausta tietopyyntöpalveluun. Vastaukset pyyntöihin saatavilla ainoastaan sähköpostilla. 4.3.4 Tietopyyntöpalveluiden syöttölomake Tiehallinnon extranet:iin 4.4 Tiedon formaatit Tietopyyntöjen generoimiseen toteutetaan HTML-lomakkeet, joilla voi syöttää edellä kuvattujen tietopyyntöjen tiedot. Huom! Vaikka tietopyyntöpalveluiden käyttö on ajateltu tapahtuvan Tiehallinnon extranetin kautta ns. syöttölomakkeella, toteutetaan rajapinta teknisesti siten, että se toimii xml-sanomalla riippumatta lähettäjästä. Eli syöttölomakkeeseen syötetyt tiedot generoidaan xml-tiedostoksi joka välitetään SONJAlle (ja sieltä ALLIiin pyynnön käsittelevälle palvelulle). Tiedonvälityksessä käytettävät tiedostot suunnitellaan tarkemmin toteutuksen yhteydessä. Analysoidaan vielä toteutusvaiheessa, että olisiko RWML:stä jotain hyötyä XML-tiedostojen toteutuksessa [5].
Integraatiosuunnitelma 27 (33) 4.4.1 Kelikamerakuvat Selitetiedosto kuvien mukaan laitettava selitetiedosto mikä kamera, aika, XML-tiedosto 1 kevyt xml-rakenne kuvat base64-enkoodattuina XML-tiedosto 2 xml-rakenteessa mukana kameran nimi + muuta attribuuttitietoa kannasta kuvat base64-enkoodattuina 4.4.2 Tiesäätiedot ja Ajantasainen liikennetieto CSV-tiedosto 1 vaakarivillä yksi ajankohta ( poikittain ) CSV-tiedosto 2 vaakarivillä yhden anturin mittaustieto (~ nykyinen ) ALKista löytyvän tiedoston mukainen XML-tiedosto 1 CSV-tiedostoa 1 vastaava xml-rakenne XML-tiedosto 2 CSV-tiedostoa 1 vastaava xml-rakenne + kannassa oleva mittauspisteen attribuuttitieto XML-tiedosto 3 CSV-tiedostoa 2 vastaava xml-rakenne XML-tiedosto 4
Integraatiosuunnitelma 28 (33) Liitteet 4.4.3 Tietopyyntöpalvelut CSV-tiedostoa 2 vastaava xml-rakenne + kannassa oleva mittauspisteen attribuuttitieto Liitteet ovat mittaustietojen tulkkaustietoja Esim. anturilista: 1 = ilma, Esim. anturien koodien tulkintalista: anturi 22 arvo 0 = pouta, Esim. asemalista: asema 1001 = vt1_nupuri, Tietopyyntöpalvelu1:n XML-pyyntö kts. 4.3.1 Tietopyyntöpalvelu2:n XML-pyyntö kts. 4.3.2 5. JÄRJESTELMÄN INTEGRAATIO TIEDONVÄLITYSJÄRJESTELMÄÄN 5.1 ALLI 5.1.1 ALLIsta käytettävissä olevat palvelut ja toiminnallisuus n integraatiossa hyödynnetään useita ALLIn valmiita palveluita ja tietojen välittämiseen liittyviä toimintoja. Perusasioita ovat mm. asiakastietojen, tilausten ja tietopalveluiden hallintatoiminnot. Tarkempi kuvaus ALLIn perustoiminnoista löytyy ALLIn määrittelydokumentista luvun 4.3 käyttötapauskuvauksista [1]. Tiesääintegraatiossa hyödynnetään lisäksi ALLIn yleistä aikaperustaisten tilausten aktivointipalvelua. Aktivointipalvelu vastaa siitä, että tilaus aktivoituu aina kun siihen määritelty aikamääritys täyttyy.
Integraatiosuunnitelma 29 (33) 5.1.2 ALLIin toiminnallisuuteen tarvittavat muutokset 5.1.3 ALLIin tarvittavat uudet liittymät ALLIin toiminnallisuuteen ei n integraation myötä tehdä muutoksia. Integraation myötä ALLIin syntyy kuitenkin uusi (yleinen) aikakriteerien syöttö -toiminto. Toiminto on osa n tietopalveluiden tilauslomakkeita. Sitä käytetään kaikkien kolmen tietopalvelun kohdalla ja jatkossa muidenkin tilauslomakkeiden toteutuksissa. ALLIin tarvittavat uudet liittymät on kuvattu tarkemmin luvussa Integraation toteutuksen kuvaus. 5.1.4 ALLIin tarvittavat uudet komponentit 5.2 SONJA ALLIin tarvittavat uudet komponentit on kuvattu tarkemmin luvussa Integraation toteutuksen kuvaus. SONJAn osuus tullaan kuvaamaan ALLIn toteutusprojektin alkuvaiheessa tehtävässä ALLIn integraatiosuunnitelmassa. Alustava suunnitelma on, että n ja SONJAn välillä ei olisi suoraa liittymää, vaan liittymät toteutettaisiin n ja ALLIn sekä ALLIn ja SONJAn välillä.
Integraatiosuunnitelma 30 (33) 6. INTEGRAATION TOTEUTUKSEN KUVAUS Tiesää kantapalvelin tiesääkanta JDBC ALLI SONJA X JMS Tiesää kuvapalvelin kelikamerakuvat jaettu levyresurssi Y Kuva 2 Järjestelmän integraatio Tiedonvälitysjärjestelmään 6.1 ALLIin tehtävät uudet liittymät 6.1.1 Tiesääkanta Uusien liittymien tarkoituksena on liittää ALLIin niin, että n tietoja voidaan välittää Tiedonvälitysjärjestelmän kautta. Liittymän kautta haetaan tiesäätietoja n tiesääkannasta. Liittymä toteutetaan suorana liittymänä tiesääkantaan Javan standardia JDBC-rajapintaa käyttäen. Huomioiden kohdan 3.3 vaatimus, Tietopalveluiden tuottaminen ei saa aiheuttaa vasteaikojen pidentymistä tai muuta haittaa n käytölle, on ollut keskustelua siitä, että pitäisikö ALLIn käyttää replikoitua kantaa sen sijaan, että se käyttäisi suoraan ns. tuotantokantaa. ALLIn Tiesääkantaan aiheuttama kuormitus riippuu pitkälti tulevien tilausten määrästä ja aktivoitumisfrekvenssistä. Mikäli myöhemmin päädytään replikoidun kannan käyttöön, on syytä vielä miettiä että kuinka taataan se, että ALLIn käytössä oleva tieto on riittävän ajantasaista ja että mitenkä itse replikointi vaikuttaa tiesääkannan kuormitukseen.
Integraatiosuunnitelma 31 (33) ALLIin määritellään uusi DataSoure, joka osoittaa tiesääkantaan ja jolta tietokantaa käyttävä komponentti pyytää tarvitsemansa tietokantayhteyden. Kannasta tarvittaneen ainakin seuraavia tauluja [4]: ANTURIT, jossa on kuvattu kaikki mahdolliset asemien anturit TSA_ANTURIT, jossa on kerrottu mitä antureita kullakin asemalla on TIEASEMA, jossa on havaintoasemat (tiesääasemat, kelikamerat, liikennemittausasemat), niiden nimet, koordinaatit yms. VIIME_MITTAUKSET, jossa on kunkin aseman (tiesää, liikennemittaus) viimeisin havainto, nopea käyttää kun halutaan viimeisin tieto MITTAUKSET, jossa on havaintotiedot 50 vrk taaksepäin, tätä käytetään kun haetaan historiatietoa Kelikameroiden perustiedot löytyvät TIEASEMA -taulusta: piirin nro löytyy kentästä KASEMA_NUM koordinaatit löytyvät kentästä TSA_PAIKKA_X ja TSA_PAIKKA_Y kameran nimi on kentässä TSA_NIMI Kameraan liittyvät kuntakoodi ja tienumero tulevat jatkossa löytymään taulusta ASEMAN_METATIEDOT (eivät ole siellä vielä tällä hetkellä): kuntakoodi kentästä KUNTAKOODI tienumero kentästä TIE (Vai pitäisikö olla tienumerolle, tieosalle ja etäisyydelle tieosan alusta jokaisella oma kenttä, että saadaan poimittua paremmin eri teillä olevat asemat jne. Jos on yhdessä kentässä, niin on ilmeisesti vaikeampaa.) kamerakuvan hakemisto kentästä TALLETUSHAKEMISTO kameran tunnus (osa kuvatiedoston nimeä) kentästä TUNNUS Tilauslomakkeella näytetään kameroiden nimiä (eli TIEASEMA.TSA_NIMI).
Integraatiosuunnitelma 32 (33) 6.1.2 Kuvapalvelin Kuva 3 Kelikamerakuvat kuvapalvelimella Kelikamerakuvat makaavat Windows NT pohjaisella tiedostopalvelimella, jolla on jaettu levyresurssi. Kelikamerakuvat ovat piireittäin omissa alihakemistoissaan. Oikea hakemisto löytyy käyttämällä ASEMAN_METATIEDOT -taulun kenttää TALLETUSHAKEMISTO. Ilmeisesti kuvan ajankohdan voi päätellä joko kuvan nimestä tai kuvan modified ominaisuudesta (näyttäisivät olevan samat)? Kummasta on helpompi hakea, aikaleimasta vai nimestä? Aikaleimassa on oikea arvo, tiedostoajan arvo voi vaihtua esim. huonon siirtojutun vuoksi. Tilauslomakkeella voi valita, että miltä ajalta kuvat lähetetään eli kuinka monelta edelliseltä tunnilta. Tämän ehdon täyttäviä kuvia ei ole mahdollista hakea tietokannan avulla, joten ainoaksi vaihtoehdoksi näyttäisi jäävän perustaa päättely kuvapalvelimen kuvien tietoihin. Esim. Web-Tiesääpalvelimella on sen omaa käyttöä varten ohjelman pätkä, joka tsekkaa tiedostot määrävälein ja kirjaa ne muuttuviin lokitiedostoihin. Tuota Web-Tiesään juttua ei voi kuitenkaan ottaa muuhun käyttöön.
Integraatiosuunnitelma 33 (33) 6.2 ALLIin tehtävät uudet komponentit Tarvitaan Manager-komponentti, joka tekee kantahaut tiesääkantaan ja luo hakujen perusteella tarvittavat Value Objet oliot, jotka sisältävät halutun tiedon. Varsinaiset tietokantaoperaatiot pyritään kuitenkin eristämään erilliseen apuluokkaan DAO-suunnittelumallin mukaisesti. Tarvitaan myös Manager-komponentti, joka hakee tarvittavat kuvat kuvapalvelimelta. Lisäksi tarvitaan tietopalvelukohtaiset Tilaus-komponentit, jotka sisältävät kunkin tilauksen sisältöä ja aikakriteereitä koskevat tiedot. Hakuehdot sekä Tilaus-komponenttien sisältämät tiedot saadaan tilauslomakkeista (kohta 4.2). 6.3 SONJAan tehtävät konfiguroinnit SONJAn osuus tullaan kuvaamaan ALLIn toteutusprojektin alkuvaiheessa tehtävässä ALLIn integraatiosuunnitelmassa. 7. LIITTEET JA LÄHDEAINEISTO [1] Tiedonvälityksen hallintajärjestelmä, Määrittely, v.1.0, SysOpen Oyj [2] Tiesäätiedon laatukäsikirja, V1.0, 21.5.2003 [3] Suomen n yleiskuvaus, Tiehallinto 30.9.2003 [4] Tietokantataulujen ANTURIT, TSA_ANTURIT, TIEASEMA, VIIME_MITTAUKSET ja MITTAUKSET kuvaus (SQL.do) [5] RWML (Road Web Markup Language), http://rwml.its-win.gr.jp/eng/