Julkaisutiedonkeruussa otettiin vuonna 2020 käyttöön uusi tietomalli, jonka mukaan julkaisutiedonkeruussa julkaisut ilmoitetaan jatkossa julkaisua määrittävien attribuuttien mukaan, aiemman julkaisutyyppiluokituksen sijaan. Lue lisää Tietomallin laajentaminen 2020. Attribuuttien ja julkaisutyyppien vastaavuudet on koottu sivulle Attribuuttien vastaavuustaulukko julkaisutyypeille.
Tällä sivulla on lueteltu Virta-julkaisutiedonkeruun XML-skeemassa käytetyt kentät, niiden kuvaukset sekä linkki mahdolliseen koodistoon. Tarkempia tietoja elementteihin liittyvistä teknisistä määrityksistä ja rajoitteista löytyy XSD-määrityksistä (XML-Skeemat).
Tiedonkeruussa pakolliset tiedot päivittyvät käsikirjaan tehtävien mahdollisten muutosten mukaan.
Pakollisuudet 2023
Pakollinen OKM-tiedonkeruussa ja tiedonsiirrossa: Julkaisu huomioidaan tiedonkeruussa vain mikäli nämä kentät eivät ole tyhjät. Julkaisun tiedot eivät siirry tietovarantoon, mikäli nämä kentät ovat tyhjiätai eivät täytä kentälle määritettyä teknistä vaatimusta.
Pakollinen OKM-tiedonkeruussa, mutta vapaaehtoinen tiedonsiirrossa: Julkaisu huomioidaan OKM:n tiedonkeruussa, mikäli nämä kentät eivät ole tyhjiä ja ne täyttävät kentälle määritetyn teknisen vaatimuksen. Julkaisun tiedot kuitenkin siirtyvät tietovarantoon vaikka tiedoissa olisi puutteita.
Muita tietoja OKM-tiedonkeruussa: Tiedot huomioidaan julkaisutiedonkeruun aineistossa, mutta tietojen toimittamiselle ei ole tiedonkeruun puolesta vaatimuksia, pl. poikkeukset ( ks. "i")
Muita, ei tiedonkeruuseen kuuluvia tietoja: Tiedon voi halutessa raportoida tietovarantoon.
Automaattisesti tuotettavia tietoja: Tiedot tuotetaan tietovarannossa.
Kentät ja koodistot
| Elementin Nimi | Selite | Koodisto | Lisätietoja |
|---|---|---|---|
| <Artikkelinumero> | Artikkelinumero, jolla artikkeli on ilmestynyt. Ilmoitetaan siinä muodossa, kuin se on esitetty alkuperäisessä artikkelissa tai lähdetietokannassa. | Vapaamuotoinen tekstikenttä. | |
<ArtikkelityyppiKoodi> | Artikkelin tyypin tarkentava koodi. | ||
| <AvainsanaTeksti> | Julkaisun avainsanat | Vapaamuotoinen tekstikenttä. | |
| <AvoinSaatavuusJulkaisumaksu> | Organisaation julkaisun avoimesta saatavuudesta kustantajalle maksaman maksun suuruus, ilmoitetaan euroina. | ||
| <AvoinSaatavuusJulkaisumaksuVuosi> | Organisaation julkaisun avoimesta saatavuudesta kustantajalle maksetun maksun maksuvuosi | ||
<AvoinSaatavuusKoodi> | Vanhan tietomallin mukainen julkaisukanavan OA-status Huom. Voidaan ilmoittaa ainoastaan julkaisuille joiden ilmoitusvuosi < 2023 | 0 = Ei vastausta | |
<AvoinSaatavuusKytkin> | Julkaisun avoin saatavuus kustantajan palvelussa julkaisun kirjaushetkellä | ||
<AVSovellusTyyppiKoodi> | http://uri.suomi.fi/codelist/research/AVSovellusTyyppiKoodi | ||
| <DOI> | Julkaisun DOI-tunniste | Tunnisteen oikeellisuus tarkistetaan DOI-tietokantaa vasten https://dx.doi.org/ | |
<DOI> (Aineisto-elementin) | Aineiston DOI-tunniste |
| (Liittyvän aineiston osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) Tunnisteen oikeellisuus tarkistetaan DOI-tietokantaa vasten https://dx.doi.org/ |
| <EmojulkaisunNimi> | Toimitetun teoksen nimi, jossa artikkeli on julkaistu | Vapaamuotoinen tekstikenttä. | |
| <EmojulkaisunToimittajatTeksti> | Toimitetun teoksen toimittajat siinä muodossa ja järjestyksessä, jossa ne on listattu alkuperäisessä julkaisussa tai lähdetietokannassa. | Vapaamuotoinen tekstikenttä. | |
| <EmojulkaisuntyyppiKoodi> | Julkaisun alustan tyyppi. | ||
| <Etunimet> | Organisaation oman tekijän etunimet | Vapaamuotoinen tekstikenttä | |
| <HankenumeroTeksti> | Hankenumero | (Liittyvän hankkeen osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) | |
| <IlmoitusVuosi> | Vuosi, jona julkaisu on ilmoitettu ensimmäisen kerran. Vuosi 2011 tai suurempi. | Ilmoitusvuosi tuotetaan automaattisesti julkaisujen tietovarannossa CSC:llä | |
| <ISBN> | Julkaisun ISBN-tunniste. | ISBN-koodin oikeellisuus tarkistetaan tarkistemerkin avulla. Menetelmä on kuvattu https://isbn-information.com/the-10-digit-isbn.html. 13-merkkisen ISBN-koodin tarkistemerkin tarkistus on kuvattu https://isbn-information.com/the-13-digit-isbn.html | |
| <ISSN> | Lehden, monografiaa tai emojulkaisua julkaisseen sarjan ISSN-numero ensisijaisesti painetun version mukaisesti. Jos painettua versiota ei ole, ilmoitetaan elektronisen version ISSN-numero. | ISSN-koodin oikeellisuus tarkistetaan. | |
| <JufoLuokkaKoodi> | Julkaisukanavan Jufo-tasoluokka. | http://uri.suomi.fi/codelist/research/julkaisufoorumiluokitus | Ks. https://julkaisufoorumi.fi/fi/arvioinnit/luokitteluperusteet Tasoluokka päätellään Virta-julkaisutietopalvelussa, ks. Jufo-tunnistus |
| <JufoTunnus> | Julkaisukanavan Jufo-ID-tunniste, joka on luokituksen mukainen neljä- tai viisinumeroinen, esim. 5003. | Jufo-tnnus päätellään Virta-julkaisutietopalvelussa, ks. Jufo-tunnistus | |
| <JulkaisuKanavaOA> | Julkaisukanavan avoin saatavuus Huom! Tieto kirjataan julkaisukanavan statuksen mukaisesti, ei itse julkaisun sen hetkisen OA-tiedon perusteella. Esimerkiksi jos viivästettynä avoin julkaisu kirjataan vasta viiveajan päättymisen jälkeen, julkaisun julkaisukanavan tiedoksi merkitään "Viivästetysti avoin julkaisukanava" (3). | ||
| <JulkaisumaaKoodi> | Lehden, sarjan, monografian tai emojulkaisun julkaisumaa. | https://www.tilastokeskus.fi/fi/luokitukset/valtio/ | |
| <JulkaisunKansainvalisyysKytkin> | Julkaisun julkaisijan maa tai maa, jossa julkaisu on ensisijaisesti julkaistu. | http://uri.suomi.fi/codelist/research/JulkaisunKansainvalisyysKytkin |
|
| <JulkaisunKieliKoodi> | Kieli, jolla julkaisu on kirjoitettu. | http://uri.suomi.fi/codelist/research/languages | Tilastokeskuksen vuoden 2003 kielikoodisto, jonka lisäksi käytössä vuonna 2020 lisätyt kolmemerkkiset koodit. |
| <JulkaisunNimi> | Julkaisun nimi siten kun se on artikkelissa tai teoksessa mainittu. Vieraskielisen julkaisun nimi voidaan tarvittaessa raportoida translitteroituna versiona. | Vapaamuotoinen tekstikenttä. | |
| <JulkaisunOrgTunnus> | Organisaation antama tunniste julkaisulle | Vapaamuotoinen tekstikenttä. | |
| <JulkaisunTilaKoodi> | Julkaisun tila VIRTA-julkaisutietopalvelussa. | Lisätietoa, ks. Julkaisun tila | |
| <JulkaisunTunnus> | Julkaisun tekninen tunnus | Tunnus tuotetaan Virta-julkaisutietopalvelussa. | |
| <JulkaisutyyppiKoodi> | Julkaisutyyppiluokituksen mukainen luokka. | http://uri.suomi.fi/codelist/research/Julkaisutyyppiluokitus | Attribuuttipohjaisen luokittelun mukaan toimitetuille tiedoille generoidaan vastaava julkaisutyyppikoodi tietovarannossa CSC:llä, ks. Attribuuttien vastaavuustaulukko julkaisutyypeille |
| <JulkaisuVuosi> | Vuosi, jolloin julkaisu on julkaistu ensimmäistä kertaa versiona, jossa on täydelliset viitetiedot. | Vuosiluku väliltä 1900 - kuluva vuosi +1 | |
| <KonferenssinNimi> | Konferenssin vakiintunut nimi. | Vapaamuotoinen tekstikenttä. | |
| <KustannuspaikkaTeksti> | Julkaisun kustantajan nimen yhteydessä ilmoitettu paikkakunta tai paikkakunnat. | Vapaamuotoinen tekstikenttä. | |
| <KustantajanNimi> | Julkaisun kustantajan nimi mahdollisimman täydellisenä. Taidejulkaisuiden tapauksessa kustantaja tai julkaisija on se ulkopuolinen taho, joka on mahdollistanut taiteellisen toiminnan tuloksen julkiseksi tekemisen. Esimerkiksi tuottaja, galleristi tai kustantaja. Yhteystiedot raportoidaan tarvittaessa. | Vapaamuotoinen tekstikenttä. Pakollinen julkaisutyyppejä A3, B2, C1, C2, D2, D4, D5, D6, E2, E3 vastaaville attribuuteille. | |
| <LahdetietokannanTunnus> | Julkaisun tunniste tai ID-numero tietokannassa, josta sen tietue on haravoitu. | Vapaamuotoinen tekstikenttä. | |
<LahdetietokannanTunnus> (Aineisto-elementin) | Aineiston tunniste tai ID-numero tietokannassa, josta sen tietue on haravoitu. | (Liittyvän aineiston osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) | |
<LahdetietokannanTunnus> (Infrastruktuuri-elementin) | Infrastruktuurin tunniste tai ID-numero tietokannassa, josta sen tietue on haravoitu. | (Liittyvän infrastuktuurin osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) | |
| <LehdenNimi> | Lehden/sarjan nimi mahdollisimman täydellisenä ja kokonaan auki kirjoitettuna (ei lyhenteitä). | Vapaamuotoinen tekstikenttä. Pakollinen julkaisutyyppejä D1, E1 vastaaville attribuuteille. | |
| <LehdenNumeroTeksti> | Lehden tai sarjan numero, jossa artikkeli on ilmestynyt. | Vapaamuotoinen tekstikenttä. | |
| <LisenssiKoodi> | Kustantajan palvelussa sijaitsevan julkaisun avoimen saatavuuden lisenssin. | ||
| <MuotoKoodi> | Julkaisun muoto. | Muotokoodit 3-4 tarkistetaan Virrassa tilakoodille 3. | |
| <OpinnäyteKoodi> | Opinnäytteen tarkennus. | ||
| <ORCID> | Henkilön ORCID tunniste | Neljä neljän merkin sarjaa väliviivoin erotettuna, esim. 0000-0000-0000-0000 http://www.orcid.org | |
| <OrganisaatioTunnus> | Organisaation yksilöivä tunnus | Tunnus sisältää 5-8 merkkiä. Tunnuksen on vastattava tiedonkeruun käsikirjan liitteenä olevia organisaatiokoodistoja. | |
| <OrgSektoriKoodi> | Organisaation luokittelu sektoreittain. |
| Koodiarvot: 0 = Tuntematon / ei tunnistettu Koodiarvo tuotetaan Virta-julkaisutietopalvelussa. |
<OrgTunnus> (Infrastruktuuri-elementin) | Infrastruktuuria hallinnoivan organisaation tunnus. | (Liittyvän infrastuktuurin osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) | |
| <PreprintKytkin> | Julkaisusta on saatavilla preprint versio organisaatio- tai tieteenalakohtaisessa julkaisuarkistossa. | ||
| <PreprintOsoiteTeksti> | Organisaatio- tai tieteenalakohtaisen julkaisuarkiston preprint version verkko-osoite (esim. URN). | Vapaamuotoinen tekstikenttä. | |
| <PysyvaOsoiteTeksti> | Julkaisun pysyviin tunnisteisiin (esim. DOI, URN tai handle) perustuva verkko-osoite, joka vie suoraan julkaisun kokotekstiversioon (kustantajan palvelimella sijaitsevaan käyttöoikeudeltaan rajoitettuun versioon). | Vapaamuotoinen tekstikenttä. | |
| <RahoittajaOrgTunnus> | Hankkeen rahoittajan organisaatiotunnus | Rahoittajan organisaatiotunnus. | |
| <RaporttiKytkin> | Tieto, onko julkaisu raportti. | Koodiarvot: | |
| <RinnakkaistallennettuKytkin> | Julkaisu on rinnakkaistallennettu organisaatio-tai tieteenalakohtaiseen julkaisuarkistoon. | ||
| <RinnakkaistallennusEmbargoPvm> | Päivämäärä, jolloin rinnakkaistallennetun julkaisun embargoaika raukeaa. | Aikaleimaformaatti. | |
| <RinnakkaistallennusLisenssiKoodi> | Rinnakkaistallennetun julkaisun lisenssi. | ||
| <RinnakkaistallennusOsoiteTeksti> | Organisaatio- tai tieteenalakohtaiseen julkaisuarkistoon rinnakkaistallennetun version verkko-osoite (esim. URN). | Vapaamuotoinen tekstikenttä. | |
| <RinnakkaistallennusVersioKoodi> | Rinnakkaistallennetun julkaisun versio. | http://uri.suomi.fi/codelist/research/RinnakkaistallenneVersio | |
<Rooli> (taidejulkaisut) | Raportoivan organisaation tekijän tai tekijöiden roolit. Erityisesti osatoteutusten tapauksessa tekijän rooli on tärkeä. Esimerkiksi teatteriesityksen lavastaja, taidenäyttelyn kuraattori, yhtyeen laulaja, jne. | Tyypillisesti 1-2 roolia per tekijä. | |
| <SivunumeroTeksti> | Julkaisun sivunumerot, joilla artikkeli on ilmestynyt siinä muodossa kuin ne on esitetty alkuperäisessä artikkelissa tai lähdetietokannassa. | Vapaamuotoinen tekstikenttä. | |
| <Sukunimi> | Organisaation oman tekijän sukunimi | Vapaamuotoinen tekstikenttä. Tekijöitä voi olla useita ja ne raportoidaan erikseen. Vähintään yhden tekijän nimi ilmoitettava. | |
<Taidetyyppikoodi> | http://uri.suomi.fi/codelist/research/TaidetyyppiKoodi | ||
<TaiteenalaKoodi> (taidejulkaisut) | 1–7 taiteenalaa siinä järjestyksessä, mitä tieteenalaa julkaisu eniten koskee. | ||
| <TekijatiedotTeksti> | Julkaisun täydelliset tekijätiedot (ml. ulkomaiset tekijät) siinä järjestyksessä, jossa ne on listattu alkuperäisessä julkaisussa tai lähdetietokannassa. Tunnistamista varten julkaisun ensimmäisen tekijän kirjoitusasuun tulee kiinnittää huomiota. Vähintään 20 ensimmäisen tekijän nimet tulee ilmoittaa. Tekijöiden kokonaismäärä voidaan ilmoittaa erillisessä kentässä (TekijöidenLkm). Teosten toimitustyön osalta (julkaisutyypit C2, D6 ja E3) kenttään merkitään toimittajat. | Vapaamuotoinen tekstikenttä. | |
| <TekijoidenLkm> | Julkaisun tekijöiden kokonaislukumäärä. Mikäli tekijöitä on yli 50, voidaan lukumääräksi merkitä ”50”. | ||
| <TieteenalaKoodi> | 1-6 tieteenalaa siinä järjestyksessä, mitä tieteenalaa julkaisu eniten koskee. | http://uri.suomi.fi/codelist/research/Tieteenala2010 | |
| <Tiivistelma> | Lyhyt kuvaus julkaisun sisällöstä, tutkimusmenetelmistä, keskeisimmistä tuloksista jne. Julkaisun tekijänoikeuslisenssin tulee sallia julkaisun tiivistelmän jatkokäyttö. | Vapaamuotoinen tekstikenttä. | |
<TunnisteTeksti> (Aineisto-elementin) | Aineiston muu pysyvä tunniste. | (Liittyvän aineiston osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) | |
<TunnisteTeksti> (Infrastruktuuri-elementin) | Infrastruktuurin pysyvä tunniste. | (Liittyvän infrastuktuurin osalta tietomallin päivitystyö kesken, elementteihin tulossa tarkennuksia) | |
| <VertaisarvoituKytkin> | Tieto, onko julkaisu vertaisarvioitu. | ||
| <VolyymiTeksti> | Lehden tai sarjan volyymi, jossa artikkeli on ilmestynyt. | Vapaamuotoinen tekstikenttä. | |
| <YhteisjulkaisuKVKytkin> | Kansainvälinen yhteisjulkaisu. | http://uri.suomi.fi/codelist/research/YhteisjulkaisuKVKytkin | |
| <YhteisjulkaisunTunnus> | Yhteisjulkaisun tekninen tunnus |
| Kun useista organisaatioista raportoitu julkaisu tunnistetaan yhteisjulkaisuksi, muodostetaan tietovarannossa CSC:llä yhteisjulkaisua varten uusi tietue ja sille tunnus automaattisesti. |
| <YhteisjulkaisuYritysKytkin> | Yhteisjulkaisu yrityksen kanssa. | http://uri.suomi.fi/codelist/research/YhteisjulkaisuYritysKytkin | |
| <YleisöKoodi> | Julkaisukanavan kohdeyleisön perusteella julkaisulle määritellään YleisöKoodi. | ||
| <YksikkoKoodi> | Lista julkaisun tekemiseen liittyvistä organisaatioyksiköistä | Organisaation oman koodiston mukainen koodiarvo. Arvoa verrataan organisaation lähettämään organisaatioyksikkölistaukseen. Vuodesta 2016 alkaen ainakin yksi alayksikkökoodi on täytynyt olla liitetty joko julkaisuun tai vähintään yhteen tekijään. | |
| <YksikkoKoodi> | Henkilön organisaatioyksikkö | Kullakin tekijällä voi olla useita alayksikköjä. Tunnuksen on vastattava OKM:lle erikseen lähetettävää koodistoa. Valinnaisen "vanhempi"-atribuutin avulla voidaan ilmoittaa Organisaatioyksiköiden hierarkia. Vuodesta 2016 alkaen ainakin yksi alayksikkökoodi on täytynyt olla liitetty joko julkaisuun tai vähintään yhteen tekijään. | |
<TaidealanTyyppikategoria> (taidejulkaisut) | http://uri.suomi.fi/codelist/research/TaidejulkaisuTyyppikategoria | ||
<Lisatieto> (taidejulkaisut) | Lisätietokenttä, jonka attribuuteilla taidejulkaisuille voidaan ilmoittaa lisätietoja. | Vapaamuotoinen tekstikenttä | |
<Lisatieto>: <Tapahtuma> (taidejulkaisut) | Missä tapahtumassa julkaisu on esitetty. Raportoidaan tapahtuman nimi, kuten esimerkiksi Sodankylän elokuvafestivaalit, Kaustisen kansanmusiikkijuhlat jne. | Vapaamuotoinen tekstikenttä | |
<Lisatieto>: <JulkaisuvuodenLisatieto> (taidejulkaisut) | Päivämäärät (esimerkiksi aikavälit), näytösten määrä jne. Esim. "20 näytöstä, 1.2-31.3.2017" | Vapaamuotoinen tekstikenttä | |
<Lisatieto>: <Julkistamispaikkakunta> (taidejulkaisut) | Paikkakunta julkaisumaassa. Tiedolla voi tarkentaa julkaisumaan yhteydessä annettua tietoa. Usein tieto paikkakunnasta on tärkeä. Esimerkiksi Berliini, Edinburgh, Mänttä. | Vapaamuotoinen tekstikenttä | |
<Lisatieto>: <MuuTunniste> (taidejulkaisut) | Esimerkiksi CD:n, nuotin, jne tuotetunniste tai -tunnisteet. | Vapaamuotoinen tekstikenttä |