Elinkaarisäännöt

1. Johdanto
   1. HTTP URI -tunnukset
   2. UUID-tunnukset
2. Tietomallien kohteiden elinkaaren hallinnan periaatteet
3. Tunnukset ja niiden hallinta
   1. Identiteettitunnus
   2. Paikallinen tunnus
   3. Nimiavaruus
   4. Viittaustunnus
   5. Tuottajakohtainen tunnus
   6. Maankäyttörajoituksen tunnus
   7. Pysyvien tunnusten palauttaminen tuottavalle järjestelmälle
   8. Maankäyttörajoituksen tietokohteisiin viittaaminen ja viitteiden ylläpito
4. Muutokset ja tietojen versionti
   1. Muutosten leviäminen viittausten kautta
   2. Yksittäisen maankäyttörajoituksen elinkaaren vaiheisiin liittyvät muutokset
   3. Maankäyttörajoituksen käsittelytapahtumien elinkaari
   4. Maankäyttörajoituksen voimaantulo
   5. Maankäyttörajoituksen jatkaminen, raukeaminen ja kumoaminen
5. Maankäyttörajoituksen elinkaaren vaiheet ja elinkaaritila-attribuutin käyttötavat
   1. Sallitut maankäyttörajoituksen voimaantulotavat maankäyttörajoituksen lajeille
   2. Sallitut maankäyttörajoituksen elinkaaren tilan muutokset
   3. Maankäyttörajoituksen elinkaaritilan muutoksiin liittyvät käsittelytapahtumat

Johdanto

Tietomalleilla on elinkaari, joka määrää niiden sisältämien tietokohteiden:

• Syntytavan
• Sen, voivatko ne muuttua
• Miten ne voivat muuttua
• Miten ne raukeaa tai kumoutuu johtaen niiden voimassaolon päättymiseen

Elinkaarisääntöjen määrittely liittyy olennaisesti tietokohteiden versionhallintaan, eli miten yksittäisten tietokohteiden niiden elinkaaren aikana muodostettavat versiot voidaan tallentaa ja yksilöidä viittauskelpoisten pysyvien tunnusten avulla.

Tässä annetut säännöt pohjautuvat paikkatietokohteiden yksilöivien tunnusten ja elinkaarisääntöjen periaatteisiin, jotka on kuvattu jukishallinnon suosituksessa JHS 193 - Paikkatiedon yksilöivät tunnukset.

HTTP URI -tunnukset

HTTP URI -muotoiset tunnukset ovat RFC 3986 -standardiin perustuvia HTTP(S) -protokollan mukaisia URI-osoitteita (Uniform Resource Identifier), joiden globaali yksilöivyys varmistetaan Internetin DNS-nimipalveluun rekisteröityjen domain-nimien avulla. Kullakin DNS-palveluun rekisteröidyllä domain-nimellä (esim. uri.suomi.fi) on yksiselitteinen omistaja, joka on suoraan tai välillisesti vastuussa ko. domain-nimen alla julkaistavasta sisällöstä. Nimen omistaja on myös ainoa taho, joka voi päättää ko. domain-nimeä käyttävien osoitteiden ohjautumisesta haluttuihin resursseihin, mikä tekee siitä luontevan perustan yksilöivien tunnusten nimiavaruuksille (esim. http://uri.suomi.fi/object/rytj/kaava). HTTP URI -muotoisen tunnuksen yksilöivyys perustuu siis domain-nimien ja siten niihin perustuvien nimiavaruuksien keskitettyyn hallintaprosessiin.

URI-tunnuksen ei tarvitse viitata konkreettiseen sijaintiin internetissä, vaan se voi olla abstraktimpi tunnus. JHS 193 Paikkatiedon yksilöivät tunnukset määrittelee paikkatiedon yksilöiville tunnuksille muodon http://paikkatiedot.fi/{tunnustyyppi}/{aineistotunnus}/{paikallinen tunnus}, jossa paikkatietokohteiden tunnustyyppi on so. Maankäyttörajoitusten tietomallissa on esimerkkinä käytetty tunnusmuotoa http://uri.suomi.fi/object/rytj/{aineistotyyppi}/{TietotyypinNimi}/{paikallinenTunnus}. HTTP URI -muotoisen tunnuksen etuna on luettavuus sekä DNS- ja HTTP-protokollien tarjoama kyky ratkaista (resolve) tunnus ja ohjata kysyjä sitä kuvaavaan Internet-resurssiin ilman tarvetta erityiselle keskitetylle tunnusrekisterille ja siihen perustuvalle ratkaisupalvelulle.

Maankäyttörajoitusten tietomallissa HTTP URI -muotoa käytetään viittaustunnus-attribuutissa, jonka avulla viitataan tiettyyn versioon tietokohteesta maankäyttörajoitusten ulkopuolelta.

UUID-tunnukset

UUID (Universally Unique Identifier) on OSF:n (Open Software Foundation) määrittelemä standardoitu tunnusmuoto, jonka avulla voidaan luoda vakiokokoisia, hyvin suurella todennäköisyydellä yksilöiviä tunnuksia ilman keskitettyä hallintajärjestelmää. UUID-tunnukset voivat perustua satunnaislukuihin, aikaleimoihin, tietokoneiden verkkokorttien MAC-osoitteisiin tai merkkijonomuotoisiin nimiavaruuksiin eri yhdistelmissä. UUID-tunnukset erityisen hyvin tietojärjestelmissä, joissa uusia globaalisti pysyviä ja yksilöiviä tunnuksia on tarpeen luoda hajautetusti ilman keskitettyä tunnusrekisteriä.

Maankäyttörajoitusten tietomallissa UUID-muotoisia tunnuksia suositellaan käytettäväksi identiteettiTunnus-, maankäyttörajoituksenTunnus-attribuuttien arvoina.

Tietomallien kohteiden elinkaaren hallinnan periaatteet

Maankäyttörajoitusten tietomallin elinkaarisäännöt mahdollistavat tietomallin tietokohteiden käsittelyn, tallentamisen ja muuttamisen hallitusti sekä niiden eri voimassaolovaiheissa. Maankäyttörajoitusten tietomallin mukaiset tietosisällöt ovat merkittäviä oikeusvaikutuksia aiheuttavia, juridisesti päteviä aineistoja, joita käsitellään hajautetusti eri toimijoiden tietojärjestelmissä. Tämän vuoksi niiden tunnusten, viittausten ja versionnin hallintaan on syytä kiinnittää erityistä huomiota.

Seuraavat keskeiset periaatteet ohjaavat maankäyttörajoitusten elinkaaren hallintaa:

• Kukin maankäyttörajoitusten tietovarastoon tallennettu versio maankäyttörajoituksesta saa pysyvän, versiokohtaisen tunnuksen.
• Kuhunkin maankäyttörajoitusten tietovarastoon tallennetun tietokohteen versioon voidaan viitata sen pysyvän tunnuksen avulla.
• Maankäyttörajoitusten tietomallin tietokohteiden väliset viittaukset toteutetaan hallitusti sekä maankäyttörajoitustietoa tuottavissa tietojärjestelmissä että yhteisissä maankäyttörajoitusten tietovarastoissa.
• Maankäyttörajoitusten tietovarasto vastaa pysyvien tunnusten luomisesta ja antamisesta tallennettaville tietokohteille.

Maankäyttörajoitusten tietomallin mukaisten aineistojen tallentamisessa erotetaan toisistaan tietojen tuottaminen ja muokkaus sisäisesti niiden tuottamiseen ja muokkaamiseen käytettävissä tietojärjestelmissä ja niiden hallinta yhteisessä versiohallitussa maankäyttörajoitusten tietovarastoissa. Maankäyttörajoitusten tietomallin ei ole mielekästä asettaa vaatimuksia maankäyttörajoitustietoa tuottavien tietojärjestelmien tunnusten ja versioiden hallintaan, vaan tietomallissa tulee varautua siihen, että yhteiseen tietovarastoon tallennettavia tietoja on muokattu ja tallennettu sisäisesti tuntematon määrä kertoja ennen ensimmäistä viemistä yhteiseen tietovarastoon, ja samoin tuntematon määrä kertoja kunkin yhteiseen varastoon vietävän version välillä. Näin ollen on mahdollista, että maankäyttörajoituksesta voi olla joissain tietojärjestelmissä tallennettuna paikallisia versiota, joita ei ole koskaan viety yhteiseen maankäyttörajoitusten tietovarastoon.

Tunnukset ja niiden hallinta

Identiteettitunnus

Identiteettitunnus yhdistää saman tunnistettavan tietokohteen kehitysversiot toisiinsa.

Yksittäisen tietokohteen koko ko. tietojärjestelmään tallennettu kehityshistoria saadaan noutamalla kaikki ko. tyyppisen tietokohteen objektit, joilla on sama identiteettiTunnus-attribuutin arvo.

Yhteinen tietovarasto on vastuussa uusien identiteettitunnusten luomisesta tarvittaessa tallennustapahtumien yhteydessä, ja niiden välittämisestä tiedoksi tallentavalle tietojärjestelmälle. Tallentavan tietojärjestelmän tulee tallentaa itselleen kopiot tietovaraston tallennustapahtuman yhteydessä palautamista maankäyttörajoitusten tietokohteiden identiteettitunnuksista, sillä ne tulee sisällyttää ko. tietokohteiden seuraavien versioden tallennettavaksi lähetettäviin objekteihin.

Esimerkki: 640bff6b-c16a-4947-af8d-d86f89106be1

Paikallinen tunnus

Paikallinen tunnus yksilöi tietokohteen yhden version tietovaraston sisällä.

Tallennusajanhetkeen päättyvää paikallista tunnusta voidaan käyttää ilman sekaannusmahdollisuuksia samalla logiikalla myös paikallisissa versionneissa, eli sellaisissa tietokohteen versioiden tallennuksissa, joita ei viedä lainkaan tietovarastoon.

Esimerkki:640bff6b-c16a-4947-af8d-d86f89106be1.b05cf48d46d8c905c54522f44b0a12daff11604e

Nimiavaruus

Nimiavaruus on syytä valita huolella siten, että se olisi mahdollisimman pysyvä, eikä sitä tarvitsisi tulevaisuudessa muuttaa esimerkiksi valtionhallinnon virastojen tai ministeriröiden mahdollisten uudelleenorganisointien ja -nimeämisten johdosta. Valittu URL-osoite tulee myös voida aina tarvittaessa ohjata kulloinkin käytössä olevaan rajapintapalveluun (HTTP redirect).

Esimerkki: http://uri.suomi.fi/object/rytj/mkr

Viittaustunnus

Tallentavan tietojärjestelmän ei siis tarvitse tallentaa luotuja viittaustunnuksia itselleen seuraavia tallennuksia varten.

Esimerkki: http://uri.suomi.fi/object/rytj/mkr/maankayttorajoitus/640bff6b-c16a-4947-af8d-d86f89106be1.b05cf48d46d8c905c54522f44b0a12daff11604e

Tuottajakohtainen tunnus

Tietojärjestelmät voivat käyttää tuottajakohtaisia tunnuksia kohdistamaan tietovarastoon ja paikallisiin tietojärjestelmiin tallennettuja tietokohteita toisiinsa esimerkiksi päivitettäessä niiden tallennuksen yhteydessä syntyneitä tunnuksia, vertailtaessa tietovarastoon tallennettuja kohteita ja paikallisia kohteita toisiinsa, sekä esitettäessä validointipalvelun tuloksia suunnitteluohjelmiston käyttäjälle.

Tuottajakohtaisilta tunnuksilta ei vaadita yksilöivyyttä tai mitään tiettyä yhtenäistä muotoa, mutta UUID-muodon käyttäminen tarjoaa hyvin määritellyn ja standardoidun tavan luoda tuottajakohtaisista tunnuksista yksilöiviä eri tietojärjestelmien kesken. Tästä saattaa olla etua haluttaessa tehdä tuotettavista tietokohdetiedoista mahdollisimman järjestelmäriippumattomia ja esimerkiksi taata tuottajakohtaisten tunnusten yksilöivyys yli mahdollisten tietoa tuottavien tietojärjestelmien vaihdosten ja päivitysten.

Esimerkki: mkr-123445

Maankäyttörajoituksen tunnus

Käytännössä myönnetyt maankäyttörajoitusten tunnukset kannattaa tallentaa valmiiksi maankäyttörajoitusten tietovarastoon, jotta voidaan tarkistaa, onko tallennettavaksi tarkoitettu maankäyttörajoituksen tunnus myönnetty organisaatiolle, jonka maankäyttörajoitusta ollaan tallentamassa. Kuntakoodin tai muun hallinnollisen alueen tunnuksen käyttö osana maankäyttörajoituksen tunnus tunnusta ei ole suositeltavaa, sillä hallinnolliset alueet muuttuvat ajan kuluessa. Kun sidos tunnuksen ja hallinnollisen alueen välillä ei näy tunnuksessa, voidaan maankäyttörajoituksen hallinnollista aluetta muuttaa joustavammin maankäyttörajoituksen elinkaaren aikana.

Esimerkki: df5b2d6f-d6d6-4695-938c-dd7c4c784c28

Pysyvien tunnusten palauttaminen tuottavalle järjestelmälle

Versionhallinnan näkökulmasta on tärkeää, että maankäyttörajoituksen tuottava tietojärjestelmä käyttää saman maankäyttörajoituksen seuraavan version tallentamisessa maankäyttörajoituksen ensimmäisen version tallennuksen yhteydessä luotua identiteettitunnusta. Vastaavasti kaikkien maankäyttörajoituksen tietokohteiden osalta käytetään niiden ensimmäisen tallennuksen yhteydessä luotuja identiteettitunnuksia, mikäli objektin katsotaan kuvaavan ko. tietokohteen uutta versiota.

Maankäyttörajoituksen tietokohteisiin viittaaminen ja viitteiden ylläpito

Muutokset ja tietojen versionti

Näin taataan ulkoisten viittausten eheys, sillä maankäyttörajoituksen kaikkien kohteiden paikalliset ja viittaustunnukset viittaavat aina vain tietyn, sisällöllisesti muuttumattomaan versioon viittatusta kohteesta. Suositeltavaa on, että kaikki tallennusversiot myös pidetään pysyvästi tallessa, jotta mahdolliset keskenäiset ja ulkopuolelta tulevat linkit eivät mene rikki muutosten yhteydessä.

Muutosten leviäminen viittausten kautta

Maankäyttörajoitusten tietomallin tietokohteiden keskinäiset viittaukset kohdistuvat aina viitattavien tietokohteiden tiettyyn versioon, ja toisaalta kaikki kohteiden sisällölliset muutokset johtavat uusien versioiden tallentamiseen. Siten kohteiden välisten linkkien kohdetietoa täytyy muuttaa mikäli halutaan viitata jollain tapaa muuttuneeseen kohteeseen. Tämä päivitystarve johtaa edelleen myös viittaavan tietokohteen uuden version luomiseen, vaikka ainoa muuttunut tieto olisi linkki uuteen versioon viitatusta tietokohteesta. Molempiin suuntiin tietokohteiden välillä tehty linkitys saattaa siten johtaa hyvin laajalle leviävään muutosketjuun.

Yksittäisen maankäyttörajoituksen elinkaaren vaiheisiin liittyvät muutokset

Maankäyttörajoitusten tietomalli mahdollistaa tunnistettavien maankäyttörajoitusten tietokohteiden eri kehitysversioiden erottamisen toisistaan. Kullakin tietomallin kohteella on sekä sen tosimaailman identiteettiin liittyvä ns. identiteettitunnus että yksittäisen tallennusversion tunnus (paikallinen tunnus). Tallennettaessa uutta versiota samasta maankäyttörajoituksesta, sen identiteettitunnus pysyy ennallaan, mutta sen paikallinen tunnus muuttuu. Tallennettaessa Maankayttorajoitus-luokan objektia se katsotaan saman tietokohteen uudeksi versioksi, mikäli sen maankäyttörajoituksen tunnus on sama. Muiden maankäyttörajoitusten tietomallin versioitavien objektien suhteen samuuden määritteleminen on tietoja tuottavien järjestelmien vastuulla: mikäli objektilla on tallennettavaksi lähetettäessä saman identititeettiTunnus-attribuutin arvo kuin aiemmin tallennetulla, samantyyppisellä tietokohteella, katsotaan uusi objekti on saman tietokohteen uudeksi versioksi.

Yksittäisen tietokohteen yksityiskohtainen muutoshistoria maankäyttörajoitusten tietovarastossa saadaan seuraamalla sen korvattuObjektilla- ja korvaaObjektin-assosiaatioita. Ainoa muutos, joka ei näy tietokohteen omana versionaan, on kohteen kumoaminen, jolloin sen viimeisimmän version tietoja päivitetään sen elinkaaritilan, voimassaolon ja tallennusajan osalta.

Attribuutin viimeisinMuutos arvo kuvaa ajanhetkeä, jolloin ko. tietokohteeseen on tehty sisällöllinen muutos tiedontuottajan tietojärjestelmässä. Tiedontuottajan järjestelmän osalta ei vaadita tiukkaa versiointipolitiikkaa, eli paikallinenTunnus-attribuutin päivittämistä jokaisen tietokohteen muutoksen johdosta. viimeisinMuutos-attribuutin päivittämien riittää kuvaamaan tiedon todellisen muuttumisajankohdan.

Maankäyttörajoituksen käsittelytapahtumien elinkaari

Maankäyttörajoitusprosessin historian yhdessä kuvaavat AbstraktiTapahtuma-luokasta perityt Kasittelytapahtuma-luokan tietokohteet linkitetään yksisuuntaisesti AbstraktiMaankayttoasia-luokkaan (Maankayttorajoitus-luokan yläluokka) päin. Tapahtumatietokohteiden uusina versiona tallennettavat muutokset eivät koskaan johda uuden version luomiseen Maankayttorajoitus-luokan tietokohteesta. Syy tähän on se, että käsittelytapahtumien on tärkeää kohdistua nimenomaan tiettyyn, pysyvään versioon maankäyttörajoituksesta.

Maankäyttörajoituksen voimaantulo

Kaavoitus- ja rakentamislaissa säädetään tavoista tai menettelyistä, joiden johdosta maankäyttörajoitus voi tulla voimaan. Kun maankäyttörajoitus tulee voimaan, tallennetaan maankäyttörajoitusten tietovarastoon ensimmäinen versio, jonka elinkaaritila-attribuutin arvo on Voimassa. Maankäyttörajoitus voi syntyä tässä luvussa kuvatuilla tavoilla.

Maankäyttörajoituksen jatkaminen, raukeaminen ja kumoaminen

Kaavoitus- ja rakentamislaissa säädetään maankäyttörajoituksen jatkamisesta, raukeamisesta ja kumoamisesta.

Voimassaoleva maankäyttörajoitus raukeaa sen voimassaoloajan mennessä umpeen. Päätöksellä annettu maankäyttörajoitus voi kumoutua kokonaan tai osittain päätöksellä, jos alueelle tulee voimaan kaava kokonaan tai osittain, jonka toteuttamiseksi maankäyttörajoitus on määrätty.

Maankäyttörajoituksen elinkaaren vaiheet ja elinkaaritila-attribuutin käyttötavat

Maankäyttörajoituksen elinkaareen liittyvää tilaa hallitaan ko. tietokohteiden elinkaaritila-attribuutin ja sen mahdolliset arvot kuvaavan Elinkaaren tila-koodiston avulla. Maankäyttörajoitus-luokan elinkaaritila-attribuutti on pakollinen.

Elinkaaren tila-koodisto kuvaa 4 mahdollista tilaa, joissa maankäyttörajoitus voi olla sen elinkaaren eri vaiheissa:

• Voimassa
• Rauennut
• Kumoutunut osittain
• Kumoutunut kokonaan

Maankäyttörajoitus, jonka elinkaaritila on Voimassa, Kumoutunut osittain, sisältää nykyajanhetkellä rajaamallaan alueella voimassa olevan maankäyttörajoituksen. Koodit Kumoutunut kokonaan ja Rauennut kuvaavat Maankäyttörajoituksen tiloja, joissa olevan maankäyttörajoituksen elinkaari on päättynyt.

Sallitut maankäyttörajoituksen voimaantulotavat maankäyttörajoituksen lajeille

Maankäyttörajoituksen voimaantulotavan ollessa Automaattinen maankäyttörajoitus, Päätöksellä annettu maankäyttörajoitus tai Voimassa olevan maankäyttöpäätöksen rajoitus voi rajoituksenLaji -attribuutin arvo esiintyä vain tässä luvussa kuvatuilla tavoilla.

Sallitut maankäyttörajoituksen elinkaaren tilan muutokset

Maankäyttörajoituksen elinkaaritila voi sen voimassaolo-, raukeamis- ja kumoutumisvaiheidensa aikana esiintyä ja muuttua vain tässä luvussa kuvatuilla tavoilla.

Maankäyttörajoituksen elinkaaritilan muutoksiin liittyvät käsittelytapahtumat

Kun maankäyttörajoituksesta viedään maankäyttörajoitusten tietovarastoon uusi versio, jossa sen elinkaaritila on muuttunut, liittyy kyseisen maankäyttörajoituksen version syntymiseen tyypillisesti jokin käsittelytapahtuma.

Yllä luetellut käsittelytapahtumat tulee tallentaa samaan aikaan elinkaaritilaltaan muuttuneen maankäyttörajoituksen kanssa.

Huomaa, että muutos tilaan Rauennut, Kumoutunut osittain tai Kumoutunut kokonaan voi liittyä kaavan Kasittelytapahtuma -luokkaan, jonka laji-attribuutin arvo voi olla maankäyttöpäätöksen voimaantuloon tai kumoaminen.