Page History

Lukurajapinta

Tietojen saatavuus

Rahoitushakujen tiedot ovat kaikkien käytettävissä.

Tutkimustoimijat voivat halutessaan ladata muita tutkimustietovarannon tietoja rajapinnasta. Sen avaamiseksi OKM tarvitsee tiedoksi sekä tietojen käyttötarkoituksen tai käyttötarkoitukset että tutkimustoimijan lakisääteisen tai säätiön säännöissä määrätyn tehtävän, johon tietojen käyttö perustuu.

Tutkimustoimija saa käyttöönsä kaikki tai osan seuraavista tietokokonaisuuksista: julkaisut, tutkimusaineistot, tutkimusinfrastruktuurit, tutkimustoimijat ja rahoituspäätökset. Tutkijan omat tiedot (ns. profiilitiedot ja tutkimusaktiviteetit) saa ladattua, jos tutkija on antanut suostumuksensa niiden luovuttamiseen tutkimustietovarannon rajapinnan kautta. Tutkija antaa suostumuksensa Tutkijan tiedot -työkalussa organisaatiokohtaisesti tiettyyn käyttötarkoitukseen.

Lukurajapinnan ensimmäisen version (29.3.2023) kautta haettavissa ovat tiedot

• julkaisuista,
  • Huom. tällä hetkellä ainoastaan nykyisin TTV:lle oon ladattavat julkaisut, ei kata mm. yhteisjulkaisuiden osajulkaisuja tai hylättyjä julkaisuja
  • Seuraavissa tiedoissa tyhjät tiedot kääntyvät virheellisesti arvolle 0: internationalCollaboration (YhteisjulkaisuKVKytkin), selfArchivedCode (RinnakkaistallennettuKytkin), businessCollaboration (YhteisjulkaisuYritysKytkin). Lataukseen on tulossa korjaus.
• tutkimusaineistoista ja,
• rahoituspäätöksistä

• , ja
• rahoitushauista

Rajapintaa kehitetään edelleen ja uusia tietokokonaisuuksia asetetaan tarjolle ensimmäisen version julkaisun jälkeen.

Tiedot ovat saatavissa JSON-muodossa rajapinnasta haettuna. Tiedot noudattavat tutkimutietovarannon tutkimustietovarannon tietomallia ja käytössä olevia koodistoja: https://tietomallit.suomi.fi/model/ttv. Tietojen tulkitsemisen tueksi on luotu kattava dokumentaatio: https://research.fi/api/rest/swagger/index.html ja https://wiki.eduuni.fi/x/PA6XE.

Kirjoitusrajapinta

Osalle tietokokonaisuuksista pyritään kehittämään myös kirjoitusrajapinta, jonka avulla tietoja voidaan tuoda tutkimustietovarantoon.

Käyttöoikeuden hakemisen prosessi

1. Selvitä mihin organisaation lakisääteiseen tai säätiön säännöissä määrättyyn, tutkimukseen liittyvään perustehtävään tietojen käyttötarve liittyy.
   1. Esimerkiksi yliopistolaki 2 §, tutkimuksen edistäminen tai säätiön säännöt, kohta 2, on riittävää.
2. Mieti valmiiksi mikä on tietojen käyttötarkoitus tai käyttötarkoitukset.
3. Ota yhteyttä tiedejatutkimus@cscfi ja ilmoita organisaatiosi halukkuudesta hyödyntää tutkimustietovarannon tietoja rajapinnan kautta.
4. Täytä sähköpostitse saamasi lomake, jolle saat sähköpostiisi linkin. Lomakkeella kysytään perustiedot organisaatiosta, käsittelyperusteet halutuille tietokokonaisuuksille , mihin tehtäviin luovutus perustuu, sekä käyttötarkoitus tiedoille.
5. Opetus- ja kulttuuriministeriö rekisterinpitäjänä toteaa tarvittaessa organisaation tutkimustoimijaksi.
6. Opetus- ja kulttuuriministeriö rekisterinpitäjänä toteaa, että rajapinta voidaan avata käyttötarkoitukseen.
7. Tutkimustietovarantotiimi lähettää yhteyshenkilölle tarvittavat tunnukset rajapinnan käyttöön.
8. Tietojen hyödyntäminen rajapinnan kautta voi alkaa.