Testausohjeet
Organisaationne tulee testata liityntäänsä osana Suomi.fi-viestien käyttöönottoprosessia näiden testausohjeiden mukaisesti.
Tälle sivulle on koottu ohjeet Suomi.fi-viestien päätoiminnallisuuksien testaamiselle. Jos haluatte testata jotain tarkempaa toiminnallisuutta, esimerkiksi osoitesivun muodostamista osana paperipostin lähetystä, tutustukaa kyseisen toiminnallisuuden käyttöohjeisiin sen sivulla Toiminnallisuudet-osiossa. Esimerkiksi osoitesivun muodostamisen käyttöohjeet on kuvattu sivulla Osoitesivun muodostaminen.
Testausta on hyvä tehdä organisaationne käyttötapausten mukaisesti, mutta huomaattehan että testiympäristöön ei tule lähettää aineistoja, jotka sisältävät henkilötietoja tai salaista tietoa. Testiympäristö on kaikille yhteinen, joten testiympäristössä on samanaikaisesti useiden organisaatioiden testiaineistoja.
Tällä sivulla ei ole kuvattu testausohjeissa lueteltujen päätepisteiden käytön tarkempia yksityiskohtia. Ohjeet päätepisteiden käyttämiseen löydätte Testiympäristön rajapintadokumentaatiosta (api.messages-qa.suomi.fi, englanniksi)Avautuu uuteen ikkunaan.. Huomaattehan myös, että jokaisen päätepisteen käyttäminen vaatii token-päätepisteestä saatavan autentikaatiotokenin.
Testihenkilötunnukset
Digi- ja väestötietovirasto (DVV) toimittaa organisaatiollenne kaksi testihenkilötunnusta Suomi.fi-viestien testausta varten.
Suosittelemme teitä tekemään Suomi.fi-viestien käyttöönoton ainakin yhdelle näistä henkilötunnuksista, jotta saatte muodostettua käytössä olevan postilaatikon. Käytössä oleva postilaatikko tarvitaan esimerkiksi sähköisten viestien lähettämisen ja viestien vastaanottamisen testaamiseen. Tehkää käyttöönotto seuraavasti:
- Kirjautukaa Suomi.fi-verkkopalvelun testiympäristöön. Olette saaneet testiympäristön osoitteen ja ympäristöön pääsemiseen vaadittavat tunnukset DVV:ltä käyttöönottoprosessin yhteydessä.
- Kirjautumisen jälkeen tunnistautukaa Suomi.fi-verkkopalveluun. Valitkaa tunnistustavaksi "Testitunnistaja" ja käyttäkää sitä testihenkilötunnusta, jolle haluatte ottaa Suomi.fi-viestit käyttöön.
- Siirtykää Suomi.fi-viestien osioon Suomi.fi-verkkopalvelussa. Sivulla lukee "Et ole ottanut Suomi.fi-viestejä käyttöön".
- Klikatkaa painiketta ”Ota Suomi.fi-viestit käyttöön” ja seuratkaa käyttöönoton ohjeita. Asettakaa pyydetyksi sähköpostiosoitteeksi se osoite, jonka avulla haluatte testata viesteihin liittyvien ilmoituksien toimintaa.
- Vahvistakaa asettamanne sähköpostiosoite siihen lähetetyn kuusinumeroisen vahvistuskoodin avulla. Vahvistuksen jälkeen Suomi.fi-viestien käyttöönotto on tämän henkilötunnuksen osalta valmis.
Jos ette ota Suomi.fi-viestejä käyttöön toiselle vastaanottamistanne henkilötunnuksista, tämä toimii valmiiksi sellaisena vastaanottajana, jota voitte käyttää paperipostin lähetyksen testaamiseen. Jos otatte Suomi.fi-viestit käyttöön molemmille testihenkilötunnuksillenne, voitte kuitenkin myöhemmin ottaa postilaatikon pois käytöstä ja siirtää sen paperipostia vastaanottavaan tilaan.
Voitte halutessanne muuttaa testihenkilötunnukseen kytketyn postilaatikon tilaa seuraavasti:
- Kirjautukaa Suomi.fi-verkkopalvelun testiympäristöön. Olette saaneet testiympäristön osoitteen ja ympäristöön pääsemiseen vaadittavat tunnukset DVV:ltä käyttöönottoprosessin yhteydessä.
- Kirjautumisen jälkeen tunnistautukaa Suomi.fi-verkkopalveluun. Valitkaa tunnistustavaksi "Testitunnistaja" ja käyttäkää sitä testihenkilötunnusta, johon kytketyn postilaatikon tilaa haluatte muuttaa.
- Siirtykää Suomi.fi-viestien osioon Suomi.fi-verkkopalvelussa.
- Tarkastelkaa ja muuttakaa postilaatikon tilaa muuttamalla viestien toimitustapaa Asetukset-kohdasta.
Tarkemmat ohjeet postilaatikon käytön lopettamisesta ja käyttöönottamisesta uudelleen on koottu loppukäyttäjien ohjeisiin sivulle Suomi.fi-viestien käytön lopettaminenAvautuu uuteen ikkunaan..
Voitte käyttää saamianne testihenkilötunnuksia myös testiautomaation rakentamiseen. Huomatkaa kuitenkin, että Digi- ja väestötietovirasto ei voi aukottomasti varmistaa, että mikään muu taho ei käytä saamianne testihenkilötunnuksia testiympäristössä ja mahdollisesti muuta niihin kytkettyjen postilaatikoiden tilaa. Mikäli huomaatte muiden käyttävän teidän testikäyttöönne liittyviä henkilötunnuksia, olkaa yhteydessä osoitteeseen viestit-kayttoonotot@dvv.fi asian ratkaisemiseksi.
Päätoiminnallisuuksien testitapaukset
Testatkaa vähintään koko viestin lähetysputki. Jos organisaationne aikoo ottaa käyttöön viestien tilatietojen hakemisen, loppukäyttäjien lähettämien viestien hakemisen tai loppukäyttäjän postilaatikon tilan tarkistamisen, testatkaa myös nämä toiminnallisuudet. Tarkemmat ohjeet testaukseen löytyvät alta: