RAJAPINTAKUVAUS 1 (5) 11.9.2009 RAJAPINTAKUVAUS Itella Customer Connection MBS2010 Itella Information Oy Kotipaikka: Helsinki Y-tunnus: 1465570-2, ALV rek.
RAJAPINTAKUVAUS 2 SISÄLLYSLUETTELO 1. YLEISTÄ... 3 2. AINEISTON SIIRTOTAPA... 3 2.1 Asiakasjärjestelmä aktiivinen...3 3. YHTEYKSIEN NIMEÄMINEN... 3 3.1 Tunnus...3 3.2 Hakemistot...3 3.3 Tiedostojen nimeäminen...4 3.4 Testiympäristö...4 4. HAKEMISTOT... 5 5. VIITTEET... 5 VERSIOHISTORIA Versio Päivämäärä Tekijä Kommentti 1.0 11.9.2009 Simo Kaartinen
RAJAPINTAKUVAUS 3 1. YLEISTÄ Tämä dokumentti kuvaa tiedostonsiirtorajapinnan ulkoisen asiakasjärjestelmän, tässä tapauksessa raportointivelvollisen (myöhemmin asiakas) ja Itella Informationin tiedonkeruupalvelun välillä. Järjestelmien välillä siirretään määrämuotoisia sanomia jotka on kuvattu Suomen Pankin tietuekuvauksissa /1/ ja /2/. 2. AINEISTON SIIRTOTAPA 2.1 Asiakasjärjestelmä aktiivinen Tässä tapauksessa toteutustapa on se, että asiakasjärjestelmä on molempiin suuntiin aktiivinen ts. asiakasjärjestelmä noutaa (pollaa) Itellan palvelusta saapuvan aineiston kuten raportit ja se myös siirtää (spoolaa) Itellan järjestelmään raportit. Tämä mahdollistaa sen, ettei asiakkaan tarvitse avata ylimääräisiä reittejä omaan sisäverkkoonsa vaan asiakkaan järjestelmä huolehtii kaikista tiedonsiirtotapahtumista. Ainoana ongelmana tässä vaihtoehdossa voi olla mahdolliset vasteaikakysymykset jos siirrot asiakkaan järjestelmään halutaan tehdä reaaliaikaisesti. Tällöin siirron vasteajat riippuvat lähinnä siitä kuinka usein asiakkaan järjestelmä käy pollaamassa Itellan siirtopalvelua. 3. YHTEYKSIEN NIMEÄMINEN 3.1 Tunnus Siirrettäessä aineistoa Itellan suuntaan, Itellan tiedonsiirtopalvelimille perustetaan asiakkaalle tunnus (esim. ftp tunnuksen tapauksessa acmeftp). Tunnukseen liittyvä salasana toimitetaan asiakkaalle ja hävitetään Itellan ympäristössä. Näin tunnus- ja salasanapari on vain asiakkaalla. 3.2 Hakemistot Kyseisen käyttäjän kotihakemistoon perustetaan alihakemistot niin, että siirrettävien tietojen siirtosuunnat ja aineistotyypit on erotettavissa toisistaan hakemistojen nimien perusteella. Tiedostot nimetään kuten Suomen Pankin tietuekuvauksissa /1/ ja /2/ on määritelty. Alihakemistot rakennetaan seuraavalla periaatteella: ~<tunnus>/<suunta>/<aineistotyyppi>/data/ jossa <tunnus> kertoo käyttäjätunnuksen, jota käyttäen tieto siirretään <suunta> kertoo asiakkaan palvelun näkökulmasta mihin suuntaan aineisto on siirtymässä. Vaihtoehtoina ovat in out. <aineistotyyppi> on Itellan välityspalvelun sisäinen nimi aineistotyypille. Esimerkkejä:
RAJAPINTAKUVAUS 4 Hakemisto Selitys Suunta ~<ftptunnus>/out/tyviorati/data RATI-kyselyn lähtevä tuotantomateriaali ~<ftptunnus>/in/tyviirati/data Raportti saapuva 3.3 Tiedostojen nimeäminen Tiedostojen siirron yhteydessä Itellan palvelimelle käytetään väliaikaistiedostoja tiedonsiirron onnistumisen varmistamiseksi. Tiedostot tulee siirtää Itellan palvelimelle väliaikaisnimellä ja kun siirto on kokonaisuudessaan tehty, tiedosto siirretään lopulliselle nimelle. Itellan palvelu ei koske väliaikaisiin tiedostoihin vaan ottaa jatkokäsittelyyn vain lopulliselle nimelle siirretyt tiedostot. Tällä estetään se, että Itellan palvelu ottaisi jatkokäsittelyyn vielä siirrossa olevan tiedoston. Ohessa on esitetty nimeämiskäytäntö. Siirrettäessä tiedosto on väliaikaistiedosto, joka nimi on <uniikki osa>.tmp, jossa uniikki osa on vapaasti määriteltävissä. Siirretty tiedosto uudelleennimetään mv komennolla (atominen operaatio) lopulliselle nimelle, joka on: <uniikki osa>.[pääte] jossa uniikki osa on määritelty Suomen Pankin tietuekuvauksissa /1/ ja /2/. 3.4 Testiympäristö Testaamiseen käytetään muutoin samaa ympäristöä kuin tuotantoon, mutta käytetty hakemisto on merkitty suuntaa kuvaavaan ison kirjaimen I (saapuva) tai O (lähtevä) lisäksi kirjaimella T (testi). Alla on kuvaava esimerkkitaulukko. Hakemisto Selitys Suunta ~<ftptunnus>/out/tyviotrati/data Testiaineisto siirretään lähtevä tänne Kaikki tuotantoa koskevat käytännöt, kuten tiedostojen nimeäminen (3.3) ovat voimassa myös testiympäristössä.
RAJAPINTAKUVAUS 5 4. HAKEMISTOT Tiedonkeruun kaikki hakemistot on kuvattu taulukoissa 4.1 ja 4.2. Taulukko 4.1: Hakemistot testiympäristössä Välitettävät tiedostot RATI-testiraportit KOTI-testiraportit Itellaan toimitettavat testiraportit ~<acmeftp>/out/tyviotrati/data ~<acmeftp>/out/tyviotkoti/data Raportintivelvolliselle saapuvat tiedostot RATI palauteraportit KOTI palauteraportit ~<acmeftp>/in/tyviitrati/data ~<acmeftp>/in/tyviitkoti/data Taulukko 4.2: Hakemistot tuotantoympäristössä Välitettävät tiedostot RATI-raportit KOTI-raportit Itellaan toimitettavat tuotantoraportit ~<acmeftp>/out/tyviorati/data ~<acmeftp>/out/tyviokoti/data RATI palauteraportit KOTI palauteraportit Raportointivelvolliselle saapuvat tiedostot ~<acmeftp>/out/tyviirati/data ~<acmeftp>/out/tyviikoti/data 5. VIITTEET 1. Tietuekuvaus RATI_FI_Tietuemuoto_1.0, Suomen Pankki 2. Tietuekuvaus KOTI_FI_Tietuemuoto_1.0, Suomen Pankki