25.5.2012 Sivu 1 Muutoshistoria Versio Päiväys Tekijä Kuvaus 0.1 15.2.2012 NMu Luonnos korjattujen ratkaisujen tietojen välittämisen muutoksesta 0.2 12.3.2012 NMu Lisätty uusia metatietokenttiä 0.3 25.5.2012 NMu Korjatun ratkaisun metatietomuutoksen käsittelyn tarkennus (luku 3) Tarkastushistoria Versio Päiväys Tarkastaja Hyväksyminen Päiväys Hyväksyjä Allekirjoitus
25.5.2012 Sivu 2 Sisällysluettelo 1 Johdanto...3 1.1 Tarkoitus...3 2 Hakupalvelun toiminnalliset muutokset...3 2.1 Useita ratkaisuja samalla asialla...3 2.2 Uusia ratkaisun metatietoja...3 2.3 Korjattujen ratkaisujen tietojen välitys...3 3 Hakupalvelun rajapinnan muutos...4
25.5.2012 Sivu 3 1 Johdanto 1.1 Tarkoitus Tämä dokumentti kuvaa Tuomiorekisterin ratkaisujen hakupalveluun suunniteltuja muutoksia, jotka parantavat tiedon kulkua korjattujen ratkaisujen osalta. 2 Hakupalvelun toiminnalliset muutokset 2.1 Useita ratkaisuja samalla asialla Aiemmin Tuomiorekisteri on sallinut vain yhden voimassaolevan ratkaisun asiaa kohti. Tämä ei ole kuitenkaan toiminut kaikissa yhteyksissä ja tarkoituksena onkin sallia useampia ratkaisuja asiaa kohti. Käytännössä tämä tarkoittaa sitä, että diaarinumerolla tehty ratkaisuhaku voi palauttaa useampia hakutuloksia. Lisäksi ratkaisun mitätöinnin seurauksena uusia ratkaisuja voi tulla enemmän kuin yksi. 2.2 Uusia ratkaisun metatietoja Tuomiorekisterin hakupalveluun lisätään seuraavat uudet kentät: lainvoimainen: saa arvon 'K', jos ratkaisu on lainvoimainen. vaatimuksiamuutettu -kenttä kertoo onko ratkaisun saataviin tullut muutoksia suhteessa haastehakemukseen. Jos vaatimuksia on muutettu, kenttä saa arvon 'K'. 2.3 Korjattujen ratkaisujen tietojen välitys Tuomiorekisterin ratkaisujen hakupalvelu palauttaa asiakkaalle tunnistetiedot ratkaisuista, jotka ovat muuttuneet sen jälkeen kun asiakas on noutanut ne omaan järjestelmäänsä. Tällä hetkellä Tuomiorekisteri antaa tiedon siitä, että jokin ratkaisu on muuttunut, mutta ei kerro mitään siitä kuinka ratkaisu on muuttunut. Tuomiorekisterin hakupalvelun muutoksessa halutaan tuoda tarkempaa tietoa ratkaisun muutoksen luonteesta. Käytännössä ratkaisu voi muuttua seuraavilla tavoilla:
25.5.2012 Sivu 4 Annettu ratkaisu mitätöidään. Kun annettu ratkaisu mitätöidään, Tuomiorekisterin kannalta tilanne voi olla seuraavanlainen: Uusi ratkaisu on toimitettu samalla kun vanha ratkaisu on mitätöity. Uutta ratkaisua ei vielä ole Tuomiorekisterissä Annetun ratkaisun metatiedoissa on tapahtunut muutoksia. Muuttuvia metatietoja ovat seuraavat tiedot: Huomautustiedot Ratkaisukoodi Lähetetty hovioikeuteen Osa- vai lopullinen ratkaisu Valitustieto Ratkaisun lainvoimaisuus Hakupalvelun uusi korjattujen ratkaisujen toiminnallisuus pohjautuu tähän edellä kuvattuun luokitteluun. 3 Hakupalvelun rajapinnan muutos Tuomiorekisterin ratkaisujen hakupalvelun rajapinnan kuvausta (XML Skeema) muutetaan tukemaan ratkaisujen uusia metatietoja (lainvoimaisuustieto ja tieto vaatimuksien muuttumisesta) ja korjausten luokittelua. Rajapinta ei ole taaksepäin yhteensopiva aiemman rajapinnan kanssa. Sen sijaan se tulee siirtymäajaksi vanhan rajapinnan rinnalle. Kummatkin rajapinnat ovat siis samanaikaisesti toiminnassa, mikä mahdollistaa joustavan siirtymisen vanhasta uuteen. Uuden rajapintakuvauksen nimiavaruus (namespace-määritys) muuttuu. Tämä toimii vanhan ja uuden rajapinnan erottimena. Uusi nimiavaruus on http://www.om.fi/tuore-haku/v1.1. Tuomiorekisterin hakupalvelun rajapinnan versiossa v1 korjattujenratkaisujen määrittely on ollut hyvin yksinkertainen: <xs:element name="korjatturatkaisu" minoccurs="1" maxoccurs="unbounded"> <xs:sequence> <xs:group ref="tns:ratkaisutunniste"/>
25.5.2012 Sivu 5 </xs:sequence> Määrittely on tukenut ainoastaan tunnistetietojen välittämistä ratkaisuista, jotka ovat jotenkin muuttuneet. Uudessa rajapintakuvauksessa on muutettu korjatturatkaisu-elementin rakennetta seuraavasti (alustava luonnos, muutokset mahdollisia): <xs:element name="korjatturatkaisu" minoccurs="1" maxoccurs="unbounded"> <xs:choice> <xs:element name="mitatoity"> <xs:sequence> <xs:group ref="tns:ratkaisutunniste"/> <xs:element name="thuomautus" type="xs:string" minoccurs= 0 /> </xs:sequence> <xs:element name="muutos"> <xs:sequence> <xs:group ref="tns:ratkaisutunniste"/> <xs:element ref="tns:parametri" maxoccurs="unbounded"/> </xs:sequence> </xs:choice> Kuvatussa muutoksessa mitatoity-elementti sisältää tietoa kun ratkaisu on mitätöity. Elementti sisältää mitätöidyn ratkaisun tunnistetiedot sekä lisätietokentän (thuomautus), joka kertoo mitätöinnin syyn. Tapauksessa, jossa Tuomiorekisteriin on toimitettu uusi ratkaisu mitätöidyn tilalle, asiakasjärjestelmän pitää tehdä uusi kysely Tuomiorekisteriin uusilla tunnistetiedoilla. Tosin, on mahdollista, että kyseinen ratkaisu on jo saadun vastauksen mukana, koska se tuoreen saapumispäivänsä ansiosta jää normaalien hakutekijöidenkin piiriin. Koska Tuomiorekisteri voi nyt sisältää useamman voimassaolevan ratkaisun asiaa kohti, on vastausviestin käsittelyssä varauduttava siihen, että ratkaisuja tulee useita. Metatietojen muutos on käsitelty omalla erillisellä muutos-elementillään. Elementin sisällä on parametri-elementillä määritelty mikä parametri on muuttunut ja mikä on sen uusi arvo. Mikäli
25.5.2012 Sivu 6 metatietokentän arvo poistuu (eli käytännössä muuttuu tietokannan null-arvoksi), parametri-elementin arvona käytetään NULL_VALUE -merkkijonoa (normaalisti ratkaisun metatietojen esityksessähän null-arvoinen kenttä puuttuu kokonaan xml-rakenteesta, mutta tässä tapauksessa se ei ole mahdollista, koska muuttuneen metatietokentän nimi pitää kuitenkin tuoda esille). Metatietojen muutoksen tapauksessa asiakasjärjestelmän ei siis tarvitse tehdä uutta kyselyä Tuomiorekisteriin, vaan kaikki tarvittava tieto on saatavilla viestissä. Vastausviestissä palautuva korjatutratkaisut-osio voisi näyttää siis tältä: <ratkaisut> </ratkaisut> <ratkaisu>...</ratkaisu> <ratkaisu>...</ratkaisu> <ratkaisu>...</ratkaisu> <korjatutratkaisut> <korjatturatkaisu> <mitatoity> </mitatoity> <tuomioistuintunnus>706</tuomioistuintunnus> <rnovv>2010</rnovv> <rno>1234</rno> <dnovv>2009</dnovv> <dno>1111</dno> </korjatturatkaisu> <korjatturatkaisu> <muutos> <thuomautus>vapaamuotoinen selite mitätöinnin syystä</thuomautus> <tuomioistuintunnus>708</tuomioistuintunnus> <rnovv>2010</rnovv> <rno>9876</rno> <dnovv>2010</dnovv> <dno>2222</dno> <parametri nimi="valitustietokdi">01</parametri> </muutos> </korjatturatkaisu> </korjatutratkaisut>