Integraatio organisaation omasta aineistojen metatietovarannosta aloitetaan aina suunnittelu- ja käyttöönottoprojektilla yhdessä CSC:n Fairdata-tiimin kanssa (fairdata (at) csc.fi).
Projektin aikana integraatio toteutetaan Metaxin demoympäristöön, ja sovittuna ajanhetkenä otetaan demoympäristössä testattu toteutus käyttöön tuotantoympäristössä.
Aloituskokouksessa sovitaan yhdessä organisaation kanssa tarkemmat projektivaiheet ja aikataulu.
Alla on esitetty esimerkki, millaisin vaihein projekti yleensä etenee.
Esimerkkiprojekti tehtävittäin
| Tehtävä | Kuvaus | Ympäristö | Vastuu |
|---|---|---|---|
| Organisaation oman aineistokatalogin luominen, demo | CSC luo organisaatiolle oman aineistokatalogin, jonne aineistojen kuvailutiedot tuodaan. Sovitaan yhdessä katalogin nimi ja muut perustiedot. | Demo | CSC |
| Organisaation Service-tunnuksen luominen, demo | CSC luo organisaatiolle käyttäjätunnuksen ja salasanan, joilla on oikeus tuoda ja päivittää organisaation aineistokatalogiin aineistojen kuvailutietoja | Demo | CSC |
| Sanomamallit, API-rajapintojen dokumentaatio, reunaehdot integraatiolle | CSC toimittaa sanomamallit ja API-rajapintojen dokumentaation, sekä sopii yhdessä organisaation kanssa integraation reunaehdoista (PID-käytännöt, ym.) | - | CSC |
| Sanomamalleihin ja API-rajapintoihin tutustuminen ja sanomien suunnittelu | Organisaatio tutustuu Metaxin API-rajapintoihin ja sanomamalleihin, ja kerää avoimet kysymykset yhdessä läpikäytäväksi | - | Organisaatio |
| Tarkempi sanomasisältöjen ja API-rajapintojen läpikäynti yhdessä ja mäppäystarpeiden tunnistaminen | Käydään yhdessä läpi organisaation tunnistamat API-rajapintojen käyttöön ja sanomien muodostamiseen liittyvät avoimet kysymykset. Tunnistetaan tässä vaiheessa myös mäppäystarpeet (käytettyjen koodistojen ja tunnisteiden muuntaminen organisaation käyttämistä arvojoukoista Metaxin tunnistamiin arvojoukkoihin sekä muutostarpeet metadatamallien välillä). | - | Organisaatio (CSC vahvasti tukena) |
| Mäppäykset | Tehdään mäppäystaulukot kuhunkin muunnosta vaativaan koodiarvojoukkoon liittyen. (Organisaation käyttämä arvo <-> Metaxin tunnistama arvo)
Metadatamallien välinen mäppäys voidaan tehdä joko yhteistyössä organisaation ja CSC:n välillä, tai organisaatio voi tehdä sen itsenäisesti. | - | CSC / Organisaatio |
| Sanomien muodostus | Organisaatio toteuttaa sanomat mäppäysmuunnoksineen | - | Organisaatio |
| Testaus | Organisaatio testaa sanomamuodostuksen ja API-rajapintojen käytön Metaxin demo-ympäristöön. CSC auttaa tarvittaessa tuotujen aineistojen kuvailutietojen katselmoinnissa. Huom! Aineistojen kuvailutietojen tuonnin lisäksi testataan myös tietojen päivitys ja poistaminen. | Demo | Organisaatio |
| Testaushavaintoihin reagoiminen | Organisaatio kommunikoi CSC:lle, jos testauksessa havaitaan sellaisia haasteita tai muutostarpeita, joissa CSC:n tukea tarvitaan. Esim. sanomasisällöissä tai rajapintojen kutsuissa, | Demo | Organisaatio (CSC vahvasti tukena) |
| Tuotantoonmenosta sopiminen | Testauksen loppuvaiheessa sovitaan yhdessä tuotantoonmenon ajankohta. | Tuotanto | Organisaatio |
| Organisaation oman aineistokatalogin luominen, tuotanto | CSC luo organisaatiolle oman aineistokatalogin, jonne aineistojen kuvailutiedot tuodaan. | Tuotanto | CSC |
| Organisaation Service-tunnuksen luominen, tuotanto | CSC luo organisaatiolle käyttäjätunnuksen ja salasanan, joilla on oikeus tuoda ja päivittää organisaation aineistokatalogiin aineistoja | Tuotanto | CSC |
| Aineistojen kuvailutietojen tuonti tuotantoon, vaihe 1 | Organisaatio tuo ensimmäiset aineistojen kuvailutiedot tuotantoympäristöön (1 tai korkeintaan muutama). | Tuotanto | Organisaatio |
| Aineistojen kuvailutietojen katselmointi tuotannossa | Varmistetaan, että 1-vaiheessa tuodut aineistojen kuvailutiedot ovat siirtyneet tuotantoon oikein ja hyvälaatuisina. Huom! Tässä vaiheessa varmistetaan myös, miltä aineistojen kuvailutiedot näyttävät Tiedejatutkimus.fi-portaalissa. | Tuotanto | Organisaatio (CSC vahvasti tukena) |
| Aineistojen kuvailutietojen tuonti tuotantoon, vaihe 2 | Organisaatio käynnistää integraation täysimittaisesti (aineistojen kuvailutietojen tuonti, päivitys, poistaminen) | Tuotanto | Organisaatio |
Joihinkin operaatioihin vaaditaan käyttäjätunnus, jota ei sellaisenaan voi sivulle antaa. Ilman käyttäjätunnustakin pääsee kuitenkin näkemään oikean syntaxin kutsulle.
Referenssidatat: https://koodistot.suomi.fi/registry;registryCode=fairdata
Yleinen Metaxin dokumentaatio: https://metax.demo.fairdata.fi/docs/