Käyttöönotto

Voit tuoda organisaatiosi rekisteristä tietoja Suomi.fi-verkkopalveluun loppukäyttäjän nähtäväksi suorittamalla seuraavat käyttöönoton vaiheet. Käyttöönottoon on hyvä varata aikaa neljä kuukautta.

Ohjeet käyttöönottoon

1. Tutustu Verkkopalvelun aineistoon

Lue Rekisterit-osion ohjeet huolellisesti.

2. Hyväksy käyttöehdot

Ilmoita Digi- ja väestötietovirastolle, että organisaatiosi haluaa liittää rekisterinsä Verkkopalveluun. Tee ilmoitus lähettämällä sähköpostia osoitteeseen verkkopalvelu-kayttoonotot@dvv.fi.

Ilmoita samalla, että organisaatiosi hyväksyy Verkkopalvelun käyttöehdot:

Suomi.fi-palvelunäkymien käyttöehdot (PDF, 333,59 kt)Avautuu uuteen ikkunaan.

Käyttölupa Suomi.fi-palvelut (PDF, 266,61 kt)Avautuu uuteen ikkunaan.

3. Aloita Suomi.fi-palveluväylän käyttöönotto

Rekisteri liitetään Palveluväylään liityntäpalvelimen kautta. Aloita siis myös Palveluväylän käyttöönotto.

4. Aikatauluta ja suunnittele

Määrittele Verkkopalvelun käyttöönoton vastuuhenkilöt ja liitettävä rekisteri. Kuvaa käyttötapaus yleisellä tasolla ja suunnittele käyttöönoton aikataulu. Täytä perustietolomake, jolla ilmoitat Verkkopalvelun käyttöönotossa tarvittavat tiedot: Suomi.fi-verkkopalvelu: Rekisteritiedot (DOCX, 306,62 kt)Avautuu uuteen ikkunaan.
Toimita täytetty perustietolomake sähköpostitse osoitteeseen verkkopalvelu-kayttoonotot@dvv.fi.

5. Toimita Digi- ja väestötietovirastolle rekisterisi tietomalli

Toimita Digi- ja väestötietovirastolle rekisterisi tarjoamat tiedot suomeksi, ruotsiksi ja englanniksi. Katso tietomallin tarkemmat ohjeet esimerkistä.

6. Liity Palveluväylään

Tässä vaiheessa liityntäpalvelimesi kytketään Palveluväylään. Samalla siihen liitetään tarvittavat rajapinnat ja rajapintojen sisältämälle tiedolle avataan pääsy Verkkopalveluun.

Tuloksena syntyvät

• Palveluväylän liityntäpalvelin
• Palveluväylä-liitos
• SOAP-/XML-rajapinta tai REST-rajapinta liitettävään organisaatiosi rekisteriin
• Handlebars template (Mustache-yhteensopiva) Verkkopalveluun nostoa varten.

Tutustu tarkemmin myös rajapintakyselyihin.

7. Testaa ja hyväksytä palvelusi

Testaus koostuu seuraavista vaiheista:

• testitapaukset: poikkeustilanteiden hallinta, tietojen oikeellisuuden tarkistus, testihenkilötunnusten määrittely
• palvelun testaus testitapauksia vasten
• virhekorjaukset.

Testaa liitettävää palvelua aina testiympäristössä. Palvelu on testattava hyväksytysti ennen kuin rekisteri voidaan siirtää tuotantoympäristöön. Ohjeet testaukseen löytyvät Rekisterin testaus -sivulta.

Viimeistele dokumentaatio ja hyväksytä palvelusi Digi- ja väestötietovirastolla.

8. Siirry tuotantoon

Digi- ja väestötietovirasto ja organisaatiosi tekninen asiantuntija koordinoivat yhdessä palvelun käyttöönoton tuotantoympäristössä. Tiedota organisaatiosi asiakkaille ja sidosryhmille, että rekisteritietojanne saa nyt Suomi.fi-verkkopalvelun kautta. Järjestä myös tarvittava asiakaspalvelu.