...
- Projektissa on mukana CSC:n puolelta tekninen yhteyshenkilö, joka toimii yhteistyössä organisaation omien teknisten kontaktihenkilöiden yhteyshenkilöiden kanssa, sekä etenemistä varmistamassa Metaxin tuoteomistaja
...
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 |
...
- Muita hyödyllisiä operaatioita:
- Lista kaikista aineistoista tietyssä katalogissa: https://metax.demo.fairdata.fi/rest/v2/datasets?data_catalog=<tähän katalogisi tunniste>&limit=1000
- Esimerkki aineistosta (pakolliset kentät täytettynä): https://metax.demo.fairdata.fi/docs/v1/datasets.html#retrieve-minimal-valid-dataset-template
- Esimerkkisisältö kutsusta, jolla aineiston kuvailutiedot tuodaan Metaxiin: Example_post.py
- Esimerkit tietosisällöittäin löydät täältä: TietosisältöTarkempi kuvaus Metaxin tietokentistä (esimerkein) ja pakollisista tiedoista löytyy täältä: https://wiki.eduuni.fi/x/7w7PCg
Muita linkkejä
Referenssidatat: https://koodistotmetax.suomifairdata.fi/registry;registryCode=fairdata/docs/v2/reference_data.html
Yleinen Metaxin dokumentaatio: https://metax.demo.fairdata.fi/docs/