2024 release 12

Yleistä

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• Lisätty kunta tai maakunta parametri tiedostojen tuontiin.
• Lisätty uudet yksittäiskyselyjen rajapinnat (GET):

  • HUOM! Rajapinnat ovat hyvin aikaisen vaiheen versioita ja tarkoitettu vain niihin tutustumiseen ja alustavaan testaamiseen.

  • /api/Building/{permanentBuildingIdentifier}

    • valmiin rakennuksen tiedot pysyvällä rakennustunnuksella (PRT)

  • /api/BuildingOwners/{permanentBuildingIdentifier}

    • valmiin rakennuksen karkeutetut tiedot pysyvällä rakennustunnuksella (PRT)

  • /api/BuildingPermit/{buildingPermitId}

    • rakentamisluvan tiedot pysyvällä lupatunnuksella (PLT)

  • /api/BuildingPermitGeneralized/{buildingPermitId}

    • rakentamisluvan karkeutetut tiedot pysyvällä lupatunnuksella (PLT)

  • /api/BuildingOwnersAll/{permanentBuildingIdentifier}

    • rakennuksen omistajatiedot (ml. turvakiellolliset omistajat) pysyvällä rakennustunnuksella (PRT)

  • /api/BuildingOwners/{permanentBuildingIdentifier}

    • rakennuksen omistajatiedot (pl. turvakiellolliset omistajat) pysyvällä rakennustunnuksella (PRT)

    /api/ForemenPlanners/{permanentPermitIdentifier}

    • rakentamislupaan liittyvät työnjohtajat ja suunnittelijat pysyvällä lupatunnuksella (PLT)

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

• OpenAPI-kuvauksen pakollisuudet eivät näy oikein niissä tilanteissa, joissa luokan/attribuutin pakollisuus riippuu käytettävästä endpointista (esim. RakennuskohdeAsia) tai rakennuskohteen lajista (esim. rakennus vs. rakennelma).

Rakennustietojen muutostietopalvelu

Rakennustietojen muutostietopalvelun tiedossa olevat virheet ja tulossa olevia muutoksia

• VTJ-integraation kautta tulleen luvan hankkeessa syntyvien uusien huoneistojen lukumäärää ei näytetä muutostietopalvelussa luvilla, joihin ei ole tullut muutoksia syyskuun alun jälkeen
• VTJ-integraation kautta tulleen henkilötunnuksettoman omistajan onHenkilö-tieto saattaa joissain tilanteissa olla ristiriidassa tämän omistajalajiin
• VTJ-integraation kautta tulleen valmiin rakennuksen purkaminen (poisto) ei näy oikein kaikissa tilanteissa muutostietopalvelussa

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

Kaavasuunnitelmien julkinen validointirajapinta

• Validoinnin CaseSensitiivisyys kytketty päälle.

Kaavatietojen validointi- ja tallennus-API

• AttributeValue-objectille lisätty TimePeriod- ja TimePeriodDateOnly-objectit
• Lisätty validointisääntö, joka tarkistaa, että http://uri.suomi.fi/codelist/rytj/RY\_Kaavamaarayksen\_Lisatiedonlaji/code/valiaikainenMaarays määräyksen arvolle on annettu AttributeValue (TimePeriodDateOnly) begin ja end.
• Lisätty validointisääntö, joka tarkistetaa, että jos kaavamääräyslaji on http://uri.suomi.fi/codelist/rytj/RY\_Kaavamaarayslaji/code/maaraAikainenKieltoRakennuksenRakentamiseksi tai http://uri.suomi.fi/codelist/rytj/RY\_Kaavamaarayslaji/code/maaraAikainenRakentamisrajoitus
  niin lisätiedon lajiksi on asetettu http://uri.suomi.fi/codelist/rytj/RY\_Kaavamaarayksen\_Lisatiedonlaji/code/valiaikainenMaarays

Kaavatiedon tallennuskäyttöliittymä

Tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

2024 release 11

Yleistä

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• OpenApi kuvaukseen korjattu virheelliset scopet

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

• Ei muutoksia.

Rakennustietojen muutostietopalvelu

• Suorituskykyparannuksia
• Korjattu tilanne, jossa valmiiden rakennusten muutostietopalveluun tulee mukaan myös hankerakennuksia
• Korjattu tilanne, jossa muutostietopalvelun Diff-objekteihin (muutostiedot) tulostuu tyhjiä alikohdelistoja
• Korjattu tilanne, jossa VTJ-integraation kautta tullut valmiin rakennuksen muutos (esim. omistajatiedot) näkyi muutoksena valmiilla hankerakennuksella muutos
• OpenApi kuvaukseen korjattu virheelliset scopet

Rakennustietojen muutostietopalvelun tiedossa olevat virheet ja tulossa olevia muutoksia

• VTJ-integraation kautta tulleen muutosluvan valmistuminen ei kaikissa tilanteissa päivitä tietoja oikein valmiille rakennukselle

Kaavatieto

Kaavasuunnitelmien julkinen validointirajapinta

Rikkovat muutokset:

• CancelledGroupRelationsDto:ta koskien planObjectKey, planRegulationGroupKey muutettu guid-arvosta Uri-muotoiseksi. Uudet nimet planObjectUri ja planRegulationGroupUri
• Uudelleen nimetty PartiallyCancellationPlanObjectInfo -> PartiallyCancelledPlanObjectInfo
• PartiallyCancelledPlanObjectInfo lisätty pakollinen tieto cancelledPlanUri sekä poistettu vanhat id pohjaiset viittaukset
• Uudelleen nimetty partiallyCancellationPlanObjects -> partiallyCancelledPlanObjects
• PlanCancellationInfo pakollisuuksia poistettu ja muutettu Uri muotoon. cancelledPlanId -> cancelledPlanUri, cancelledPlanObjectId -> cancelledPlanObjectUris

Muut muutokset:

• Lisätty luokkien pysyvät Uri-tunnisteet get-rajapintoihin: generalRegulationGroupUri, otherPlanMaterialUri, planUri, planAttachmentDocumentUri, planCancellationInfoUri, planMapUri, planObjectUri, relatedPlanSourceDataUris, planOperatorUri, planRecommendationUri, planRegulationUri, planRegulationGroupUri, planReportUri
• Poistettu virheelliset scope tiedot rajapinta kuvauksesta.

Kaavatietojen validointi- ja tallennus-API

Muut muutokset:

• Muutettu sitovan tonttijaon tietorakenteita ja otettu Uri-viittaukset käyttöön vastaavasti kuin julkisessa kaavavalidointi rajapinnassa. Sitovan tonttijaon rajapintoja ei olla vielä julkaistu.
• Uri-viittaukseen liittyviä kenttiä lisätty. Kentät vain luku kenttiä ja liittyvät tiedon jakamiseen Ryhdistä.
• Muutettu PlanHadlingEvent -> HandlingEvent.
• Uudelleen nimetty PartiallyCancellationPlanObjectInfo -> PartiallyCancelledPlanObjectInfo
• PartiallyCancelledPlanObjectInfo lisätty pakollinen tieto cancelledPlanUri sekä poistettu vanhat id pohjaiset viittaukset.
• Uudelleen nimetty partiallyCancellationPlanObjects -> partiallyCancelledPlanObjects
• OpenApi kuvaukseen korjattu virheelliset scopet.

2024 release 10

Yleistä

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• LanguageString kuvauksia päivitetty.
• fileKey määritelty pakolliseksi tiedoksi BuildingAttachmentDocument sanomalle OpenApi kuvauksessa.
• buildingSite sanomalle määritelty tenure pakolliseksi.
• Rakennuspaikan hallintaperuste koodistolle (tenure) lisätty minimipituus 1
• Korjattu tilanne, jossa muutosluvan vallmistuminen antoi virheen valmiin rakennuksen tunnisteista

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

Rakennustietojen muutostietopalvelu

• korjattu tilanne, jossa VTJ-integraation kautta tulleelle muutosluvalle ei tullut aina omistajatietoja
• korjattu tilanne, jossa VTJ-integraation kautta tulleen rakennuksen varustetiedot monistuivat

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

• LanguageString kuvauksia päivitetty.
• fileKey-attribuutti määritelty pakolliseksi tiedoksi PlanAttachmentDocument sanomalle OpenApi-kuvauksessa.
• Sitovan tonttijaon (BindingPlotDivision) alustavat sanomat lisätty OpenApi kuvaukseen. Rajapinnat tulevat myöhemmin.
• Sallitaan kaavamääräyslajikoodien käyttäminen ristiin eri kaavalajeilla.
• PlanMatterResponse-luokan relatedPlanMatters-attribuutti palauttaa URI-viittauksia

Kaavatiedon tallennuskäyttöliittymä

Tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

Asemakaavan seurantalomake

• Seurantalomakkeen neljän desimaalin tallennusongelma korjattu.
• Ruotsinkielisten aluevarauskoodien tallennusongelma korjattu.

2024 release 9 - Rakennustiedon muutostietopalvelu

Rakennustieto

Sisältää vain muutostietopalvelun julkaisun tuotantoon. Ei rajapintamuutoksia.

Rakennustietojen muutostietopalvelu

• suorituskykyparannuksia
  • HUOM! Suorituskykyparannukset jatkuvat edelleen. Jos suorituskyvyn kanssa on haasteita (esim. timeout jossain vaiheessa) asiakasjärjestelmässä, niin Ryhdin maksimivastausmäärää on mahdollista muuttaa ja näin parantaa vasteaikoja. Tämä vaatii kommunikoinnin Syken kanssa ja muutoksen Ryhdin konfiguraatioon.
• lisätty hankerakennukselle tieto hankkeessa syntyvien (numberOfNewApartments) ja poistuvien huoneistojen lukumääristä (numberOfDeletedApartments)
  • HUOM! hankkeessa syntyvien huoneistojen lukumäärä luetaan integraation kautta VTJ:stä. Hankkeessa poistuvien huoneistojen lukumäärä on uusi tieto ja syntyy vain Ryhdin tallennusrajapinnan kautta
• korjattu tilanne, jossa muutostietopalvelun vastauksessa on päivitystapahtuma (changeType": "U"), mutta kohteen nykyisessä (objectState) ja edellisessä tilassa ei ole eroja (objectStatePrev)
• korjattu tilanne, jossa kohteen tila (objectState) muuttuu päivitysten jälkeen, jos kohde on muuttunut ja sitä haetaan uudestaan samalla muutostapahtumalla (eventID)
• korjattu tilanne, jossa muutostietopalvelu palauttaa lastSeen objectKey:n, vaikka muutostapahtuman kaikki muutokset on jo käsitelty
• korjattu tilanne, jossa rakennukselta puuttuva rakennuspaikan hallintaperuste (tenure) aiheutti virheen (500 error)
• korjattu tilanne, jossa muutostietopalvelu on antanut validointivirheen, jos muutoksia haetaan sellaisella muutostapahtumalla (eventID), johon ei kohdistu rakennustietojen muutoksia
• korjattu tilanne, jossa VTJ-integraation kautta tulleen rakennuksen pistesijainnin koordinaatit näkyivät väärässä järjestyksessä
• korjattu tilanne, jossa VTJ-integraation kautta tulleen rakentamisluvan aloitus- tai valmistumispäivä ei tule mukaan muutossanomaan
• korjattu tilanne, jossa VTJ-integraation kautta tulleen rakentamisluvan kuntatunnus (municipalityNumber) ei tule mukaan muutossanomaan
• korjattu tilanne, jossa VTJ-integraation kautta tulleen huoneiston varusteen poisto näkyi virheellisesti joissakin tilanteissa (huoneistolla edelleen varuste)
• korjattu tilanne, jossa VTJ-integraation kautta tulleen laajennusluvan muutostiedot eivät ole näkyneet oikein muutossanomassa

Korjaus releaseen 2024-release-8

Yleistä

Sisältää korjauksen julkaisuun 2024-release-8 kaavatietojen osalta.

Rakennustieto

Ei muutoksia

Kaavatieto

• Perutaan versiossa 2024-release-8 tullut rikkova muutos: "AttributeValue-objekteille lisätty pakollisuus kaikille propertyille."

2024 release 8

Yleistä

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• Poistettu huoneiston (Apartment) osoiteHuoneistoTunnus (addressApartmentIdentifier) omana entiteettinään ja siirretty tiedot suoraan huoneistolle
  • kirjainosa = apartmentIdentifierLetterSuffix
  • jakokirjain = apartmentSubdivisionLetter
  • numeroOsa = apartmentNumber

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

Rakennustietojen muutostietopalvelu

• Suorituskykyparannuksia
• Lisätty rakennukselle (building, finishedBuilding) vanhan luokittelun mukainen käyttötarkoitusluokka (mainPurpose1994)
  • HUOM! tieto luetaan vain integraation kautta VTJ:stä ja se ei ole ylläpidettävissä Ryhdin tallennusrajapinnan kautta
  • HUOM! tieto näytetään vain, jos rakennuksella ei ole nykyisen luokittelun mukaista pääasiallista rakennusluokkaa (mainPurpose)
• Poistettu huoneiston (Apartment) osoiteHuoneistoTunnus (addressApartmentIdentifier) omana entiteettinään ja siirretty tiedot suoraan huoneistolle
  • kirjainosa = apartmentIdentifierLetterSuffix
  • jakokirjain = apartmentSubdivisionLetter
  • numeroOsa = apartmentNumber
• Korjattu muutostietopalvelun palauttamien parentKey-arvojen muoto
• Korjattu tilanteita, jossa muutostietopalvelu palauttaa muutostapahtumaan kuulumattomia muutoksia
• Korjattu tilanne, jossa kohteen koordinaatit (coordinates) puuttuvat sen edellisestä versiosta (objectStatePrev)

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

• AttributeValue-objekteille lisätty pakollisuus kaikille propertyille. Rikkova muutos.
• Validointien virheviestien englannin- ja ruotsinkielisiä käännöksiä päivitetty
• Lisätty validointi DigitaalinenAlkuperä-koodiston 0401 - Rajaus useamman kunnan alueella koodiarvolle.
  • Validointi tarkistaa, että Kaavan aluerajaus on vähintään 50% tiedon tallentajan kunnan kuntarajan sisällä. Käytetään Vooka-aineistojen yhteydessä, jos tiedetään että rajaus menee useamman kunnan alueelle.
• Uusia validointisääntöjä liittyen seuraaviin kaavamääräyslajeihin:
  • Rakennusala, jolla saa sijoittaa talousrakennuksen
  • Rakennusala, jolla saa sijoittaa saunan
  • Kortteli-kaavamääräyslaji -> muutettu korttelialue tai korttelialueen osa.
    • Voivat liittyä vain kaavakohteeseen joka on geometrialtaan alue
    • Rakennusala tai Korttelialue tai korttelialueenosa tulee Liittyvä kohde -assosiaation avulla linkittää se siihen aluevaraukseen, jonka sisälle rakennusala spatiaalisesti sijoittuu
• Uusi validointisääntö liittyen Asuntojen määrä -kaavamääräyslajiin
  • Tulee arvon olla positiivinen kokonaisluku
• Muutetaan aiemmin tehtyä validointisääntöä positiivinen kokonaisluku --> positiivinen desimaaliluvuksi seuraavien kaavamääräyslajien osalta
  • pyorapaikkojenMaaraAsuntoaKohden
  • autopaikkojenMaaraAsuntoaKohde
  • aaneneristavyys
• Muutetaan aiemmin tehtyä validointisääntöä positiivinen kokonaisluku --> muutettu desimaaliluvuksi seuraavien kaavamääräyslajien osalta
  • maanpinnanKorkeusasema
  • vesikatonYlimmanKohdanKorkeusasema
  • julkisivupinnanJaVesikatonLeikkauskohdanKorkeusasema
• Lisätty validointisääntö, maakuntakaavan Kaava-luokan aluerajaus saa sisältää reiän. Kaavalajilla 11- kokonaismaakuntakaava pääkäyttötarkoitusten ei tarvitse peittää koko kaava-aluetta (sama sääntö kuin vaihekaavoilla).
• Muutetaan aiemmin tehtyä validointisääntöä string --> positiivinen kokonaisluku seuraavien kaavamääräyslajien osalta
  • korttelinNumero
  • tontinTaiRakennuspaikanNumero
  • kaupunginTaiKunnanosanNumero
• Muutetaan aiemmin tehtyä validointisääntöä desimaaliluku --> positiivinen kokonaisluku seuraavien kaavamääräyslajien osalta
  • pyorapaikkojenMaara
• Uusi validointsääntö jolla estetään Rakennusluokitus 2018 -koodiston käyttäminen käyttötarkoituskohdistus -lisätiedonlajilla.
• Uusi validointisääntö joka estää seuraavien otsikkotason koodiarvojen käyttämisen
  • viheralue
  • ymparistohairionTorjunnanRakenne
  • terminaalialue
  • vesiliikenteenAlue
  • vesivayla
  • ymparistoarvojenAlue
  • luontoarvoiltaanArvokasAlue
  • kulttuuriymparistoarvojenAlue
  • alueJotaKoskeeKehittamisperiaate
  • pysakoinninMaara
• Uusi validointisääntö, joka koskee YK ja MK kaavalajeja seuraavasti
  • rakentamisrajoitusYleiskaava koodia voi käyttää vain jos kaavalaji 21, 22, 23, 24 tai 25
  • rakentamisrajoitusMaakuntakaava koodia voi käyttää vain jos kaavalaji on 11 tai 12
• Uusi validointisääntö: kaavamääräyslajit suunnittelutarvealue ja kehittamisalue voi liittyä vain aluemaiseen kaavakohteeseen
• Muutettu Geotiff-validointia niin, että sallii alpha-kanavan käytön
• Korjattu bugi, jossa Poisluettava käyttötarkoitus -lisätieto johti 500 Internal Server Error -virheeseen avoimessa validointipalvelussa

Asemakaavan seurantalomake

• Ei muutoksia

2024 release 7

Yleistä

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• Muutettu huoneiston (Apartment) käymälätyypin tietomallia ja käsittelyä

  • poistettu käymälätyyppi (toiletType, 0..* koodistoviittaus: https://koodistot.suomi.fi/codescheme;registryCode=rytj;schemeCode=kaymalatyyppi)
  • lisätty huoneistolle uusi tieto onVesiKäymälä (isWaterCloset)
  • HUOM! Huoneistolla on edelleen varuste: '01 - WC', jolla on myös optionaalinen lkm. Näin huoneiston varusteissa voidaan kertoa tieto käymälästä ja näiden lukumäärästä ja uudella onVesiKäymälä-attribuutilla tarkentaa vielä tätä tietoa.

• Poistettu Toimijalta (Operator) tunniste (operatorKey)

  • Toimijalla on pysyvä ihmisluettava tunniste, joka on jokin näistä: henkilötunnus (personalIdentityCode), yritysJaYhteisötunnus (businessId), muuTunnus (otherId)

  Korjattu tilanne, jossa muutosluvan valmistuminen aihetti virheen valmiiin kohteen tunnisteista (uuid)

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

Rakennustietojen muutostietopalvelu

• Päivitetty ja korjattu OpenAPI-kuvausta
  • poistettu rakentamislupien (buildingPermit) perus- ja muutostietopalvelun kuvauksesta valmiin kohteen tiedot (finishedBuilding, finishedStructure, finishedAreaToBeBuiltForSpecificActivities)
• Lisätty seuraavat vain DVV:ltä integraation kautta luettavat tiedot rakentamislupien (buildingPermit) perus- ja muutostietopalveluun
  • rakentamistoimenpide.sijaitseeMääräalalla (locatedOnUnseparatedParcel)
  • huoneisto.Hallintaperuste (housingType)
  • huoneisto.Käytössäolo (occupancyOfApartment)
• Muutettu huoneiston (Apartment) käymälätyypin tietomallia
  • poistettu käymälätyyppi (toiletType, 0..* koodistoviittaus: https://koodistot.suomi.fi/codescheme;registryCode=rytj;schemeCode=kaymalatyyppi)
  • lisätty huoneistolle uusi tieto onVesiKäymälä (isWaterCloset)
  • HUOM! Huoneistolla on edelleen varuste: '01 - WC', jolla on myös optionaalinen lkm. Näin huoneiston varusteissa voidaan kertoa tieto käymälästä ja näiden lukumäärästä ja uudella onVesiKäymälä-attribuutilla tarkentaa vielä tätä tietoa.
• Poistettu Toimijalta (Operator) tunniste (operatorKey)
  • Toimijalla on pysyvä ihmisluettava tunniste, joka on jokin näistä: henkilötunnus (personalIdentityCode), yritysJaYhteisötunnus (businessId), muuTunnus (otherId)
• Korjattu ja lisätty perustietopalveluista puuttunut viimeisen tapahtuman tunniste (eventID)
• Lisätty uudet perustietopalvelut käyttötarkoitukseltaan yleistetyille rakennuksille ja luville:
  • /api/InitialInformation/BuildingGeneralized
  • /api/InitialInformation/BuildingPermitGeneralized

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

• Y-alustan koodistoihin tehty muutoksia. Seuraavat koodistot ladattu uudelleen Ryhti-järjestelmään:
  • Kaavamääräyslaji-koodisto
  • Digitaalinen alkuperä-koodisto

Kaavatiedon tallennuskäyttöliittymä

• Ei muutoksia

2024 Release 6

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• Lisätty validoinnit sille, että rakennuksen ja sen osan käyttötarkoituksen koodin tulee olla 4-numeroinen tarkka koodi (ylätasojen 2 - ja 3-numeroisia koodeja ei siis sallita)

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

• OpenAPI-kuvauksen pakollisuudet eivät näy oikein niissä tilanteissa, joissa luokan/attribuutin pakollisuus riippuu käytettävästä endpointista (esim. RakennuskohdeAsia) tai rakennuskohteen lajista (esim. rakennus vs. rakennelma).

Rakennustietojen muutostietopalvelu

• Korjattu tilanne, jossa muutostietopalvelu muutostapahtumaan kuulumattomia muutoksia
• Päivitetty rakennuslupa-asian sivutus tukemaan tilannetta, jossa samassa muutostapahtumassa on erittäin paljon muutoksia (yli 1000)

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

• Yleiskaavan oikeusvaikutteisuuden määritys: legalEffectOfLocalMasterPlan muutettu kokoelmaksi legalEffectOfLocalMasterPlans ja kentän nimi muutettu samalla.
• Lisätty rajapinta liiteasiakirjan tiedoston hakemiseen liiteasiakirjan avaimella. Uusi skeema AttachmentDocument.
• PlanHandlingEvent.eventTime muutettu ei pakolliseksi.
• Sanoma tonttijaon pysyvien tunnisteiden varaamiseen. Poistettu kenttä: ReservePermanentBindingPlotDivisionIdentifierCommand.typeOfBindingPlotDivision.
• Skeemojen kuvauksia päivitetty.

2024 Release 5

Yleistä

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• Täydennetty ja korjattu validointiviestejä ja näiden käännöksiä

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

• OpenAPI-kuvauksen pakollisuudet eivät näy oikein niissä tilanteissa, joissa luokan/attribuutin pakollisuus riippuu käytettävästä endpointista (esim. RakennuskohdeAsia) tai rakennuskohteen lajista (esim. rakennus vs. rakennelma).

Rakennustietojen muutostietopalvelu

• Parannettu edelleen suorituskykyä sekä lupien, että rakennuslupien palveluissa
  • HUOM! Kehitys jatkuu edelleen tämän suhteen
• Korjattu satunnaisia muutostietopalvelun error 500-virheitä
  • HUOM! Nämä johtuvat Ryhdin tietomallin kannalta puutteellisista DVV-tiedoista. Näitä saattaa esiintyä edelleen joissakin tilanteissa ja ne korjataan tätä mukaa.
• Korjattu tilanne, jossa muutoksien haku viimeisimmällä ajantasaisella eventId:llä palauttaa silti muutoksia
• Muutettu muutostietopalvelun sivutus tukemaan tilannetta, jossa samassa muutostapahtumassa on erittäin paljon muutoksia (yli 1000)
  • vastaussanomassa lastEventId on korvattu uudella ominaisuudella lastSeen
    • lastSeen objektia käytetään seuraavan sivun luotettavaan noutamiseen ja se sisältää on viimeksi nähdyn eventId lisäksi viimeksi nähdyn tunnisteen objectKey
  • rajapintakutsun payloadissa lastEventId on korvattu eventId kentällä ja rakenteeseen lisätty objectKey kenttä
    • rakenne on identtinen vastaussanoman lastSeen kentän sisältämän arvon kanssa
  • mikäli vastaussanoman mukaan muutoksia on edelleen saatavilla (upToDate = false) niin seuraava sivu muutoksia tulee hakea edellisen sivun lastSeen objektin arvoa käyttäen. Näin taataan sivutuksen jatkuminen oikeasta kohdasta niissä tapauksissa joissa yksittäisen tapahtuman sisältämät muutokset osuvat useammalle sivulle.
• Päivitetty ja korjattu OpenAPI-kuvaus
  • kuvauksesta puuttui objectStaten rakenne

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

• Nimeämismuutoksia rajapinnan tietorakenteissa
  • Plan.planAnnex -> Plan.planAnnexes
  • Plan.planCancellationInfo -> Plan.planCancellationInfos
  • Statute.subsection -> Statute.subsections
  • Statute.paragraph -> Statute.paragraphs
  • Statute.subparagraph -> Statute.subparagraphs
• Lisätty rajapinnat asemakaavan (LocalDetailedPlanMatter), yleiskaavan (LocalMasterPlanMatter) ja maakuntakaavan (RegionalPlanMatter) päivittämiseen.
• Lisätty kaava-asian sanomiin PlanMatterCreate, PlanMatterUpdate, PlanMatterResponse kenttä relatedPlanMatters liittyville kaava-asioiden uri viittauksille.

Kaavatiedon tallennuskäyttöliittymä

Ei muutoksia

Tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

Ei muutoksia

2024-release-4

Yleistä

• Lisätty /authenticate rajapinta tunnistaumista varten palveluihin, jotka näkyvät suomi.fi palveluväylään. Rajapintaa voidaan käyttää client credential tunnistautumiseen identity.ymparisto.fi tai identitytest.ymparisto.fi sijaan suoraan palveluväylän kautta.

Rakennustieto

Rakennustietojen validointi- ja tallennus-API

• Lisätty käännökset (ruotsi, englanti) rajapinnan virheviesteille
  • Ryhti palauttaa virheviestin kutsussa pyydetyllä kielellä. Jos pyyntö puuttuu tai se on joku muu kuin suomi, ruotsi tai englanti, niin rajapinta palauttaa suomenkielisen virheviestin
  • HUOM! VTJ:n virheviestit saadaan vain suomeksi tai ruotsiksi. Jos pyydetty kieli on joku muu, niin rajapinta palauttaa VTJ:n suomenkielisen virheviestin
• Lisätty Ryhdin ja VTJ:n välinen toiminnallisuus, joka mahdollistaa huoneiston muuttuvan tunnuksen päivittämisen

  • Tässä kutsutaan DVV:n uutta metodia: PaivitaValmisHuoneistotunnukset

  • Ryhdin sanomassa toimitetaan huoneiston uusi muuttuva huoneistotunnus, joka päivitetään VTJ:hin VTJ-PHT:n perusteella

  • Tarkennettu rakennuskohteiden geometrioiden validointeja sallittujen ja pakollisten geometriatyyppien suhteen (p = pakollinen, e = ei sallittu, s = sallittu):

    Objekti	Attribuutti	Multipolygon	Polygon	Multilinestring	Linestring	Multipoint	Point	3D
    Sisäänkäynti	geometria	e	e	e	e	e	p	e
    Hissi	geometria	e	e	e	e	e	p	e
    Väestönsuoja	geometria	s	s	e	e	e	s	e
    Kokoontumistila	geometria	s	s	e	e	e	s	e
    RakennuskohteenSijaintitiedot	sijaintikeskipiste	e	e	e	e	e	p	e
    RakennuskohteenSijaintitiedot	muuGeometria	s	s	s	s	s	e	e
    Osoite	sijainti	e	e	e	e	e	s	e
    Yhteysosoite	sijainti	e	e	e	e	e	s	e
    UlkokuorenTiedot	muoto	s	s	s	s	s	s	s
    Verkostoliittymä	liittymäpiste	e	e	e	e	e	s	e

• Muutettu talotekniikkaTiedot-, ulkokuorenTiedot- ja SisätilojenTiedot-objektien validointeja niin, että näissä ei ole mahdollista toimittaa tyhjää objektia
• Korjattu rajapinnan validointia niin, että lupaAsian toimittaminen ilman Rakentamistoimenpiteen rakennuskohdetta ei ole mahdollista
• Korjattu useampi/parannettu useampia rajapinnan palauttamia virheviestejä selkeämmiksi

Rakennustietojen validointi- ja tallennus-APIn tiedossa oleva virheet ja rajapintaan vaikuttavia tulevia muutoksia

• OpenAPI-kuvauksen pakollisuudet eivät näy oikein niissä tilanteissa, joissa luokan/attribuutin pakollisuus riippuu käytettävästä endpointista (esim. RakennuskohdeAsia) tai rakennuskohteen lajista (esim. rakennus vs. rakennelma).

Rakennustietojen muutostietopalvelu

• Lisätty uudet endpointit rakennusten ja lupien perustietoaineistojen lataamiseen (perustietopalvelu)
  • rakennukset = api/InitialInformation/Building
  • luvat = api/InitialInformation/BuildingPermit
• Korjattu seuraavat virheet:
  • Kohteen aiempi tila (objectStatePrev) ei tule mukaan vastaukseen
  • Vastauksessa on mukana joissakin tilanteissa kohteita, joissa ei ole tapahtunut muutoksia
• Parannettu suorituskykyä

Kaavatieto

Kaavatietojen validointi- ja tallennus-API

• Lisätty PlanMatterPhase GET-rajapinnat kaikille kaavalajeille mahdollistaen kaava-asian vaiheiden kyselyt

What's Changed

• Julkaisun 2024-release-3 alustavat OpenApi kuvaukset by @MattiNieminen in #10
• v2024-release-4 muutokset by @solita-markump in #11

New Contributors

• @MattiNieminen made their first contribution in #10
• @solita-markump made their first contribution in #11

Full Changelog: 2024-release-3...v2024-release-4