Asiakastestin ohjeet
Asiakastestin avulla voit harjoitella digitaalisen tietoaineiston ja niihin liittyvien kontekstimetatietojen siirtämistä Kansallisarkistoon.
Ennen kuin voit aloittaa testaamisen, tulee sinun olla yhteydessä Kansallisarkistoon: digitaalisetsiirrot@kansallisarkisto.fi.
Asiakastestiympäristö vastaa toiminnallisuuksiltaan Sapan valtionhallinnolle suunnattua tuotannon instanssissa. Jos toiminnallisuuksissa on eroja asiakastesti- ja tuotantoympäristön välillä, kerrotaan näistä tällä sivulla sekä Sähköisen arkistoinnin palvelun ohjeistuksessa.
Alta löydät tarkempaa kuvausta asiakastestiympäristön toiminnallisuuksista ja käytöstä.
Palvelu on testausta varten ja palveluun ei tulisi ladata salassa pidettävää tai turvallisuusluokiteltua tietoaineistoa. Kansallisarkisto ei vastaa palveluun ladatuista tietoaineistoista tai tiedostoista. Prosessoidut tietoaineistot poistetaan niiden käsittelyn jälkeen.
Sisäänkirjautuminen
Sapan asiakastestiin kirjaudutaan testi-Virtu -tunnistautumisen avulla. Virtu-käyttäjätunnistusjärjestelmä on Valtion tieto- ja viestintätekniikkakeskus Valtorin virastoille tarjoama palvelu, jota CSC - Tieteen tietotekniikan keskus operoi. Testi-Virtu -tunnistautumisen käyttö ei edellytä henkilökohtaisia Virtu-tunnuksia. Tunnistautumiseen käytetään ennalta luotuja testitunnuksia, jotka Sähköisen arkistoinnin palvelu toimittaa sovituille henkilöille mahdollistamaan Sapan asiakastestiympäristössä toimimista.
Kun painat Tunnistaudu -painiketta, sinut ohjataan testi-Virtu -palvelun omaan kotiorganisaation valintaan. Sapan asiakastestillä sisäänkirjautumiseen käytetään organisaatiota “Virtu Testi IdP“. Valitse tämä organisaatio, ja paina Valitse -painiketta.
Seuraavaksi sinut ohjataan varsinaiseen sisäänkirjautumisnäkymään, jossa sinulta pyydetään Käyttäjätunnus (Username) ja Salasana (Password). Sähköisen arkistoinnin palvelu toimittaa kirjautumisessa käytettävät tunnukset sovitulle testaajalle.
Kun olet syöttänyt vastaanottamasi Käyttäjätunnuksen ja Salasanan, paina Login -painiketta. Tunnistautumisen jälkeen voit alkaa testaamaan Sapa -palvelun toimintaa.
Asiakastestiympäristön toiminnallisuudet
Tietorakenteen määrittely
Asiakastestiympäristöstä löytyvät samat tietorakenteet kuin tuotantoympäristöstäkin. Saat Sähköisen arkistoinnin palvelulta metatietotunnuksen, jota voit käyttää kuvailevien kontekstimetatietojen luomista varten tietorakenteen valinnan jälkeen.
Kontekstimetatietojen luominen
Kontekstimetatietojen luominen toimii asiakastestiympäristössä samalla tavalla kuin tuotantoympäristössä. Sinulle toimitetaan metatietotunnus, jonka alle luot kuvailevia kontekstimetatietoja ja joihin tulet lataamaan kuvailuja vastaavia siirtopaketteja. Tietyt Kontekstimetatietojen luonnissa annettavat arvot, kuten mm. Käyttörajoitukset ja Käyttöluvan myöntäjä, eivät välttämättä vastaa tuotantoympäristöstä löytyviä arvoja.
Kun tuotantoympäristössä lähetettäisiin kontekstimetatietoja hyväksyttäväksi, tarkastaa Sähköisen arkistoinnin palvelu luodut kontekstimetatiedot ja hyväksyy ne jos niistä ei löydy puutteita tai virheitä. Asiakastestiympäristössä hyväksyntään lähetetyt kontekstimetatiedot kuitenkin hyväksytään automaattisesti, ilman Sähköisen arkistoinnin palvelun katselmointia välissä.
Kuvailun jatkaminen
Jos kontekstimetatietojesi kuvailu jää kesken, voit jatkaa kuvailutyötä Kuvailun jatkaminen -sivun kautta. Syöttämällä hakukenttään sinulle aiemmin toimitetun metatietotunnuksen voit etsiä keskenjääneitä kuvailuja, ja painamalla Jatka kuvailua -painiketta palaat kontekstimetatietojen luominen -näkymään.
Siirtopaketin lataaminen
Kun olet luonut kuvailevia kontekstimetatietoja, ja lähettänyt ne hyväksyttäväksi, voit lähettää näihin siirtopaketteja. Siirtopaketit nimetään kontekstimetatietojen luonnissa annettujen “Siirtopaketin yksilöivä tunniste” -arvojen mukaan, ja niiden rakenteiden tulee noudattaa Sähköisen arkistoinnin palvelun laatimia siirtopakettien määrityksiä.
Siirtopakettien lataus palveluun, prosessointi ja validointi vastaavat Sapan tuotantoympäristön työnkulkua ja määrityksiä. Tähän sisältyy sekä Sapan tekemät paketti- ja tiedostovalidoinnit sekä KP-PAS -palvelun tekemät vastaavat prosessit.
Prosessoinnin päätyttyä voi tarkastella sitä Omat siirrot -sivulta. Jos siirtopaketin prosessointi päättyy virheeseen, löydät täältä myös latauksen epäonnistumisen syyn.
Asiakastestillä lähetettyjä siirtopaketteja ei tallenneta mihinkään tallennuspalveluun. Kun siirtopaketin prosessointi valmistuu, ja jos vastaan ei ole tullut ongelmia, päätetään paketin prosessointi poistamalla se.
Siirtorajapinta
Jotta rajapinnan käyttö ja testipaketin lähettäminen on mahdollista, tulee organisaation ensin
liittyä palveluväylään yleisten ohjeiden mukaisesti
noutaa Kansallisarkiston testipalvelun tunniste https://liityntakatalogi.test.suomi.fi/dataset/sapa
vastaanottaa Sähköisen arkistoinnin palvelulta testitunnus ja metatietotunnus
noutaa API-avain testikäyttöliittymästä
tuottaa sarjaan liitetyt kuvailutiedot (toistaiseksi luotavissa vain käyttöliittymän kautta)