Tuonti-integraation testaus asiakastestiympäristössä

Suunnittele testaus organisaatiosi käyttötapausten pohjalta.

Älä lähetä testiympäristöön henkilötietoja tai salassa pidettäviä tietoja.

Henkilötietoihin kuuluvat esimerkiksi:

• henkilön nimi
• henkilökohtainen sähköpostiosoite
• puhelinnumero
• muut tunnistetiedot.

Asiakastestiympäristö on useiden organisaatioiden yhteisessä käytössä, joten siellä on samanaikaisesti myös muiden organisaatioiden testiaineistoja.

Jos tuot rajapinnan kautta vain osan tiedoista, huomioi tämä testauksen suunnittelussa. Esimerkiksi jos tuot vain palvelupaikat, kuvaa palvelut käyttöliittymässä ja huolehdi tarvittavista liitoksista joko rajapinnan kautta tai käyttöliittymässä.

Huom. PTV:n version 12 mukaista käyttöliittymää ei ole vielä julkaistu asiakastestiympäristössä. Aikataulu tarkentuu myöhemmin. 

• Teknisen testauksen tavoitteena on varmistaa, että integraatio toimii teknisesti oikein ja tiedot siirtyvät määritysten mukaisesti. Mahdolliset virheet on tunnistettu ja korjattu, eikä tuotantoon siirtymisen estäviä avoimia virheitä ole.
  
  Testaa kaikki sisältötyypit, joita tuot integraation kautta PTV:hen. Tuonti-integraation kautta voidaan tuoda
• palveluja
• asiointikanavia
• palvelukokonaisuuksia
• aliorganisaatioita
• liitoksia ja niiden lisätietoja.

Huomioi, että Rajapintaversion 12 kautta voit tuoda ja päivittää vain julkaistua sisältöä.

Hyödynnä testitapausten suunnittelussa käsittelysääntöjä.

Suunnittele ja toteuta testaus

Varmista, että:

1. rajapintayhteys toimii (esimerkiksi käyttöoikeudet ja palomuuriavaukset)
2. tietojen lisäys ja päivitys onnistuvat kaikille käytössä oleville sisältötyypeille. Huomioi käsittelysäännöt ja virheviestit. Ks. Lisätietoa tuonti-integraation toteuttajalle, Tietojen päivityslogiikka (linkki tarkentuu myöhemmin)
3. lähdejärjestelmästä poistuneiden tietojen arkistointi onnistuu
4. tietojen palautus arkistosta toimii. Ks. Lisätietoa tuonti-integraation toteuttajalle, Arkistointi ja arkistosta palauttaminen (linkki tarkentuu myöhemmin)
5. virhetilanteet käsitellään onnistuneesti. Dokumentoi testauksessa havaitut poikkeamat ja selvitä niiden syyt ja tee tarvittavat korjaukset.
6. palveluajat tallentuvat oikein (ks. Palveluaikojen käsittelysäännöt)
7. monikieliset sisällöt tallentuvat oikein
8. Tietojen siirto onnistuu organisaation tyypillisissä käyttötapauksissa ja tavanomaisilla tietomäärillä.

Suunnittele ja toteuta tarvittavat lisätestit

• Testaan linkin luonti palvelupaikan esteettömyystietojen lisäystä varten.

Jos käytät ulkoisen lähdejärjestelmän tunnistetta (externalId) tietosisällön luomisessa:

• Testaa että voit luoda sisältöjä externalId-tunnisteella. Tämä on mahdollista sisältötyypeille organisaatio, palvelu ja asiointikanava.
• Testaa myös, että externalId-contentId -tunnisteiden vastaavuuksien haku toimii ja että haettua contentId:tä voidaan käyttää tietojen päivittämiseen.

Suunnittele poikkeamien hallinta

Suunnittele ja kuvaa menettelyt poikkeamien havaitsemiseksi, käsittelemiseksi ja korjaamiseksi myös tuotantokäytön aikana.

Voit hyödyntää esimerkiksi:

• virhelokien seurantaa
• rajapintakutsujen valvontaa
• tiedonsiirtojen täsmäytyksiä
• muita laadunvarmistuskäytäntöjä.

Varmista, että poikkeama- tai virhetilanteessa pystyt tunnistamaan

• virheen aiheuttaneen tietosisällön
• siihen liittyvän rajapintakutsun.

Raportoi teknisen testauksen tulokset DVV:lle

• Hyödynnä raportoinnissa raportointiohjetta ja -pohjaa: Integraation teknisen valmiuden raportointipohja (DOCX, 223,62 kt)Avautuu uuteen ikkunaan.
• Laadi testausraportti ja lähetä se Digi- ja väestötietovirastolle osoitteeseen ptv-tuki@dvv.fi.
• DVV arvioi raportin perusteella, voidaanko organisaatiollesi myöntää tuontirajapinnan tuotantotunnukset teknisen testauksen osalta.
• Kun tekninen testaus on hyväksytysti suoritettu eikä uusia testauskierroksia ei enää tarvita, voitte siirtyä testauksessa seuraavaan vaiheeseen, jonka vastuuhenkilönä on organisaation PTV-pääkäyttäjä.

Tietosisällön testauksen tavoitteena on varmistaa, että PTV:hen siirtyvät tiedot:

• vastaavat lähdejärjestelmän tietoja
• ovat ajan tasalla
• täyttävät PTV:n sisältö- ja laatuvaatimukset
• ovat asiakkaalle selkeitä ja ymmärrettäviä.

Korjaa havaitut laatupoikkeamat lähdejärjestelmässä ja varmista, että korjaukset toimivat myös PTV:ssä.

Voit siirtyä tuotantokäyttöön vasta, kun tuotantoon siirtymisen estäviä avoimia laatupoikkeamia ei ole.

Suunnittele testaus

Testaa kaikki sisältötyypit, joita tuot integraation kautta PTV:hen.

Tuonti-integraatiolla voidaan tuoda:

• palveluja
• asiointikanavia
• palvelukokonaisuuksia
• alaorganisaatioita
• liitoksia ja niiden lisätietoja.

Suunnittele ennen testausta:

• tarkastatko kaikki tiedot vai edustavan otoksen eri sisältötyypeistä
• mitä käyttäjärooleja tarvitset testaukseen.

Useimmissa tapauksissa pääkäyttäjärooli riittää.

Tarkista tietojen asiasisältö

• Palvelu- ja asiointikanavakuvaukset on laadittu selkeästi, oikeakielisesti ja asiakaslähtöisesti.
• Palvelun kuvauksessa ei ole osoite- tai puhelinnumerotietoja, www-osoitteita tai muita asiointikanaviin kuuluvia tietoja.
• Pohjakuvaukset on liitetty palveluihin oikein silloin, kun niitä on käytetty.
• Jos pohjakuvauksia on käytetty, pohjakuvauksien tietoja ei ole kopioitu omaan palvelukuvaukseen, vaan pohjakuvausten tietoja on täydennetty itse tehdyllä kuvauksella.
• Palveluiden ja asiointikanavien välille on tehty liitokset.
• Asiointikanavien aukioloajat, osoitetiedot ja muut tiedot näkyvät oikein.
• Palvelun ja asiointikanavan väliset liitoksen lisätiedot näkyvät oikein.
• Mahdolliset koneellisesti tuotetut sisällöt ovat ymmärrettäviä ja asiakaslähtöisiä.

Käsittele havainnot ja poikkeamat

• Varmista, että tietosisällön osalta tarvittavat korjaustoimenpiteet tehdään lähdejärjestelmään ja testaa korjauksen vaikutus.

Raportoi tietosisällön laadun testaus

• Kun olet tehnyt tietosisällön laadun testauksen, kokoa tulokset raportiksi ja toimita raportti Digi- ja väestötietovirastolle
• Hyödynnä raportoinnissa tietosisällön laadun raportointiohjetta ja -pohjaa: Integraation tietosisällön laadun raportointipohja (DOCX, 217,28 kt)Avautuu uuteen ikkunaan.
• Raportin perusteella DVV arvioi, voidaanko sisällön laadun varmistamisen osalta organisaatiolle myöntää tuontirajapinnan tuotantotunnukset.
• Poista raportointipohjasta tai jätä tyhjiksi ne kohdat, jotka eivät koske testattua integraatiota.

Mikäli uusia testauksen iteraatiokierroksia ei enää tarvita, DVV lähettää tuontirajapinnan tuotantotunnuksen (API-käyttäjätunnus) tuontirajapinnan käyttölupahakemuksella ilmoitettuun sähköpostiosoitteeseen.