Metadatakatalogin käyttöohjeet ja kuvaus
Kansallisarkisto tarjoaa digitaalisen tietoaineiston siirtämiseen/arkistointiin sekä Sapa-käyttöliittymän että REST-rajapinnan. Tällä sivulla ohjeistetaan, miten metadatakatalogia voidaan hyödyntää siirtävän lähdejärjestelmän kontekstimetatietojen normalisointiin suhteessa Kansallisarkiston taustajärjestelmät. Siirtorajapintakuvaus ja käyttöohjeet löytyy sivulta: Siirtorajapinnan käyttöohjeet
Käyttöliittymät löytyvät osoitteista:
Valtionhallinto: https://sapa.arkisto.fi
Muut asiakkaat: https://ka-sapa.arkisto.fi
Jotta Kansallisarkisto voi ottaa tietoaineistoja vastaan rajapintasiirtoina, on näiden kontekstimetatiedot siirrettävä ensin Kansallisarkistoon. Ennen kontekstimetatietojen siirtämistä, tulee ne normalisoida suhteessa Kansallisarkiston metatietojärjestelmät. Käytännössä tämä tarkoittaa siirtävän lähdejärjestelmän ja Kansallisarkiston metietojärjestelmän tietomallien mappaamista keskenään. Tätä tarkoitusta varten Kansallisarkistossa on metadatakatalogi, joka ilmaisee miten tietoelementti pitää ilmaista, kun se siirretään rajapinnan avulla Kansallisarkistoon. Kontekstimetatietojen normalisointi rajapinnan kautta on pakollista, kun siirrettävä siirtokokonaisuus on Sähke2 -siirtorakenteessa. Mikäli siirron kohteena on jokin muu siirtorakenne, voidaan kontekstimetatiedot tuottaa myös graafisen käyttöliittymän avulla. Vaihe esitetään alla olevassa kuvassa.

Metadatakatalogi löytyy Sapan käyttöliittymän sivulta:
Valtionhallinto: https://sapa.arkisto.fi/#/metadata-catalog
Muut asiakkaat: https://ka-sapa.arkisto.fi/#/metadata-catalog
Käytännön esimerkkejä metadatan rakenteesta ja muodosta löytyy sivulta Metadataesimerkit siirtoa varten.
Sivulla mainittuja käsitteitä
Alta löytyvässä taulukossa kuvataan käsitteet, joita käytetään Yksittäisten metadatakatalogin metatietoelementin kuvaukset -luvussa esitetyissä määritelmissä. Käsitteet kuvataan niiltä osin, kun yleisesti ei ole saatavilla yksiselitteistä käsitettä tai käsite on Sapa-spesifi.
Käsite | Selite |
Aineistokokonaisuus | Kansallisarkiston luettelointi- ja metatietojärjestelmän hierarkkisesti korkein kuvailutaso, jossa kuvailun kohteena on yhteen kuuluvat tietoaineistot kokonaisuutena. Aineistokokonaisuuteen voidaan liittää alempia kuvailutasoja, kuten sarjoja ja arkistoyksiköitä tietoaineistojen tarkempaa luettelointia ja kuvailua varten. |
Kontekstimetatiedot | Siirtäjän siirrettävälle tietoaineistokokonaisuudelle annettavat metatiedot SAPA-siirtorajapinnalla. Metatiedot kertovat aineiston kontekstista; syntyyn, kertymiseen, hallintaan ja käyttöön liittyvistä toimijoista, toiminnasta, tapahtumista sekä tapahtumaympäristöstä. |
Siirtoerä | Siirrettävästä aineistosta koostettava yksittäinen siirrettävä kokonaisuus, joka koostuu kontekstimetatiedoista ja siirtopaketeista. Siirtoerät määritellään siirtosuunnittelun yhteydessä, joka tapahtuu ennen siirtoa. Siirtoerä voi jakaantua yhteen tai useampaan siirtopakettiin. |
Siirtopaketti | Siirtopaketti koostuu tietoaineistoista (tiedostoista). Yhteen siirtoerään voi liittyä 1-n siirtopakettia. Siirtopakettien kontekstimetatiedot luodaan SAPA:ssa, josta ne välitetään Kansallisarkiston metatietovarantoon. Sähke2-siirtorakenteen siirtopaketti poikkeaa muista siirtorakenteista, sillä se sisältää sekä kontekstimetatiedot että tiedostot) |
Tietoaineisto | Asiakirjoista ja muista vastaavista tiedoista muodostuva tiettyyn viranomaisen tehtävään tai palveluun liittyvää tietokokonaisuus. |
Metadatakatalogin rakenne
Metadatakatalogi rakentuu 27:sta eri metatietoelementistä. Jokaisen metatietoelementin kohdalla on kuvattu mahdolliset vastaavuudet seuraaviin “metatietomalleihin” (huomioitavaa, että “metatietomalleja voidaan olla sovellettu tässä eri tavoin kuin tässä esitetty):
Metatietomalli | Lyhyt kuvaus |
---|---|
Suositus SÄHKE2-metatietomallin hyödyntämisestä
| Kansallisarkiston suositus vaatimuksista ja ominaisuuksista, jotka ovat edellytyksenä eri tietojärjestelmiin sisältyvien asiakirjallisten tietojen pysyvälle säilyttämiselle yksinomaan sähköisessä muodossa, sekä tietojärjestelmistä tuotettavan siirtokokonaisuuden muodostamisesta. Suositus SÄHKE2-metatietomallin hyödyntämisestä käsittelee SÄHKE2-määrityksiä erityisesti tiedon arkistoinnin näkökulmasta sekä kommentoi SÄHKE2-metatietomallia lainsäädännön muutoksiin liittyvillä huomioilla. |
| Kansainvälinen, erityisesti digitaalisten tietoaineistojen kuvailuun kehitetty standardi. |
Records in Contexts – käsitemalli (RiC-CM)
| Kansainvälisen ICA:n (International council on archives), EGAD-asiantuntijatyöryhmän tuottama arkistokuvailun käsitemalli, joka tulee muiden julkaistavien osiensa kanssa korvaamaan nykyiset ICA:n kuvailustandardit. |
Suositus julkisen hallinnon arkistoitavien tietoaineistojen arkistometatietoa. Tarkoitettu käytettäväksi, kun kehitetään arkistoitavien tietoaineistojen käsittelyyn liittyviä tiedonhallinnan prosesseja ja ratkaisuja. |
Yksittäinen metatietoelementti on jaettu alla olevan taulukon mukaisiin attribuutteihin. Eri metatietoelementeistä löydät enemmän tietoa Yksittäisten metadatakatalogin metatietoelementin kuvaukset -luvusta.
Nimi metadatakatalogissa | Selite |
---|---|
”name_fi” | Metatietoelementin suomenkielinen nimi. |
”description” | Kansallisarkiston tuottama kuvaus metatietoelementistä. |
”description_perusmetatieto” | Kuvaus metatietoelementistä, joka on otettu Asiakirjassa mainitut metatietomallit -taulukossa esitetystä ”Arkistoitavien tietoaineistojen perusmetatiedot” -suosituksesta. KA/20011/30.00.00/2023 |
”max_length” | Kohdassa ilmennetään avoimen tekstikentän maksimimerkkimäärän. |
”required” | Tieto, onko metatietoelementin läsnäolo rajapinnan sanomassa pakollinen vai ei. |
”dependency” | Metatietoelementin mahdollinen riippuvuus toiseen metatietoelementtiin. |
”scope” | Kentässä kerrotaan, missä tietorakenteissa kyseinen metatietoelementti esiintyy. Tietorakenteet ovat ”Rakenteinen tietoaineisto”, ”Muut digitaaliset tietoaineistot”, ”Digitoitu kuva-aineisto” ja ”Sähke2”. |
”type” | Kertoo metatietoelementin tietokentän tyypin. Tyypit ovat:
|
“values” | Sisältää mahdolliset käytetyt arvot kohdissa, joissa arvon pitää olla jokin sallituista arvoista (elementin tyyppi “enum”). Koostuu useista elementeistä:
|
Yksittäisten metadatakatalogin metatietoelementin kuvaukset
Siirtopaketin yksilöivä tunniste
Metatietoelementti: | identifier_local |
“name_fi”: | Siirtopaketin yksilöivä tunniste |
“description”: | SAPA-siirron mahdollistava ja vapaasti muodostettava tunniste, joka luodaan kontekstimetatietojen kuvailun yhteydessä tai tätä ennen. Tunnistetta hyödynnetään myöhemmin itse tietoaineiston siirtämisessä. Olennaista on, että siirtopaketti on nimetty ennen tai viimeistään kontekstimetatietojen luontivaiheessa, jotta myöhemmin tietoaineiston (siirtopaketin/pakettien) siirrossa oikea tietoaineisto kiinnitetään oikeisiin kontekstimetatietoihin. Siirtoerän sisällä tunnisteen pitää olla yksilöllinen kullekin siirtoerään kuuluvalle siirtopaketille. Esimerkiksi ”Paketti1”, ”vuodet9195”. Hyväksyttävät merkit:
|
“description_perusmetatieto”: | Tunnus, joka yksilöi aineiston yksikäsitteisesti tietyssä tunnistejärjestelmässä. |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope”: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A22 Identifier |
Vastaavuus Dublin Core: | Identifier |
Analoginen tunniste
Metatietoelementti: | identifier_analog |
“name_fi”: | Analoginen tunniste |
“description”: | Kuvailun kohteena olevan tietoaineiston analoginen tunniste (arkistotunnus, signum) on kirjaimista ja/tai numeroista koostuva merkkijono, joka identifioi sarjan tai arkistoyksikön ja osoittaa sen paikan aineistokokonaisuudessa. Analoginen tunniste muodostetaan yleensä arkistokaavan, arkistonmuodostussuunnitelman tai tehtäväluokituksen pohjalta. Analoginen tunniste on perinteisessä asiakirjojen muotoon perustuvassa ABC-kaavassa kirjaimia ja/tai numeroita erotettuna kaksoispisteellä, kuten Ea:123. Arkistonmuodostussuunnitelmaan tai tiedonohjaussuunnitelmaan perustuvassa vaihtoehdossa se on esimerkiksi desimaaliluokituksen mukaisesti numeroita erotettuna kaksoispisteellä, kuten 01.01:2. |
“description_perusmetatieto”: | Tunnus, joka yksilöi aineiston yksikäsitteisesti tietyssä tunnistejärjestelmässä. |
“max_length”: | 255 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A22 Identifier |
Vastaavuus Dublin Core: | Identifier |
Tunnisteen rooli – vain SÄHKE2
Metatietoelementti: | identifier_other_type |
“name_fi”: | Tunnisteen rooli |
“description”: | Tarkentaa asian tai asiakirjan yksilöivää tunnistetta. Rooli on joko ”Muu tunniste” tai ”Diaarinumero”. Koskee arvoja CaseFile ja Record -kohdissa. |
“description_perusmetatieto”: | Tunnus, joka yksilöi aineiston yksikäsitteisesti tietyssä tunnistejärjestelmässä. |
“max_length”: | - |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Sähke2 |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A22 Identifier |
Vastaavuus Dublin Core: | Identifier |
Kuvailun kieli
Metatietoelementti: | description_language |
“name_fi”: | Kuvailun kieli |
“description”: | Kontekstimetatietojen kieli. Kuvailutietoja voidaan antaa eri kielillä. |
“description_perusmetatieto”: | - |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Language |
Vastaavuus RiC-CM: | - |
Vastaavuus Dublin Core: | Language |
Aineiston kieli
Metatietoelementti: | languages |
“name_fi”: | Aineiston kieli |
“description”: | Kuvailtavassa tietoaineistossa käytetty kieli. Mikäli kuvailun kohteena olevassa tietoaineistossa on käytetty kieltä, jota ei ole annettu tai tietoaineistossa käytetään useampia kieliä, voidaan tämä kuvata Tietosisältö-kentässä. |
“description_perusmetatieto”: | Asiakirjakokonaisuudessa käytetty kieli tai käytetyt kielet. |
“max_length”: | - |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | string_array, enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | Record/Language |
Vastaavuus RiC-CM: | RiC-A25 Language |
Vastaavuus Dublin Core: | Language |
Omistaja
Metatietoelementti: | owner_organization |
“name_fi”: | Omistaja |
“description”: | Kuvailtavan tietoaineiston juridinen omistaja. Omistaja-tieto määräytyy pääsääntöisesti aineiston elinkaaren vaiheen mukaan. Kun tietoaineisto on säilytysvaiheessa, on omistaja pääsääntöisesti siirtävä viranomainen. Kun tietoaineisto on arkistovaiheessa, omistaja on Kansallisarkisto |
“description_perusmetatieto”: | Asiakirjakokonaisuuden arkistonmuodostajat ja mahdolliset muut olennaiset asiakirjakokonaisuuden muodostumisesta, käsittelystä tai säilyttämisestä vastaavat ja vastanneet tahot. |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-E07 Agent. RiC-R037 Is or was owner of |
Vastaavuus Dublin Core: | RightsHolder |
Sisällön luonne
Metatietoelementti: | content_category |
“name_fi”: | Sisällön luonne |
“description”: | Sisällön luonne kuvaa, onko kyseessä viranomaisaineisto sekä missä elinkaaren vaiheessa viranomaisaineisto on. Metadatakatalogissa on tässä kohdassa listattuna kaikki Kansallisarkiston arkistokuvailun metatietovarannosta löytyvät arvot - myös sellaiset, joita ei käytetä viranomaissiirroissa tai jotka eivät enää ole aktiivisessa käytössä. Käytettävät arvot: Viranomaisaineisto-arkistovaihe: Viranomaisen tehtävien hoitamisesta syntynyt tietoaineisto, joka on siirtynyt arkistovaiheeseen. Viranomaisaineisto-säilytysvaihe: Viranomaisen tehtävien hoitamisesta syntynyt tietoaineisto, joka on edelleen säilytysvaiheessa. |
“description_perusmetatieto”: | Elinkaaren vaihe kertoo, onko arkistoitava aineisto säilytysvaiheessa vai arkistovaiheessa. |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A26 Legal Status |
Vastaavuus Dublin Core: | Provenance |
Päänimeke
Metatietoelementti: | title_main |
“name_fi”: | Päänimeke |
“description”: | Kuvailtavan tietoaineiston ensisijainen nimi. Päänimekkeen tietoja voidaan tarkentaa muilla kuvailutiedoilla. Päänimeke on keskeinen kuvailutieto, jonka tulee kuvata mahdollisimman hyvin tietoaineiston sisältöä. Päänimeke voidaan muodostaa esimerkiksi tietoaineiston aiheesta, muodollisesta tehtävästä, aineistotyypistä, yhteisössä käsitellystä asiasta tai suoritetusta tehtävästä, toimijan, paikan tai ajallisen ilmiön nimestä, aikamääreestä tai näiden yhdistelmästä. Päänimekettä voidaan tarkentaa Tarkenne -tiedoilla. |
“description_perusmetatieto”: | Aineistolle annettu nimi. |
“max_length”: | 255 |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Title Record/Title |
Vastaavuus RiC-CM: | RiC-A28 Name |
Vastaavuus Dublin Core: | Title |
Tarkenteen alku
Metatietoelementti: | title_start |
“name_fi”: | Tarkenne |
“description”: | Käytetään tarkenteen osoittaman aineistojakson alkuarvon esittämiseen. Jos tarkenteen osoittama aineistojakso voidaan ilmoittaa yhdellä arvolla, käytetään tätä arvon tyyppiä. |
“description_perusmetatieto”: | Aineistolle annetun nimekkeen tarkenne, esimerkiksi alkuaan analogisen asiakirjakokonaisuuden (arkistoyksikön) yksilöintiin käytettävä, arkistointijärjestykseen perustuva tieto, joka erottaa samannimiset aineistot toisistaan |
“max_length”: | 512 |
“required”: | Valinnainen |
“dependency“: | Jos kenttään annetaan arvo, tulee Tarkenteen tyypistä pakollinen tieto. |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | date |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A28 Name |
Vastaavuus Dublin Core: | Title |
Tarkenteen loppu
Metatietoelementti: | title_end |
“name_fi”: | Tarkenne |
“description”: | Käytetään tarkenteen osoittaman aineistojakson loppuarvon esittämiseen. |
“description_perusmetatieto”: | Aineistolle annetun nimekkeen tarkenne, esimerkiksi alkuaan analogisen asiakirjakokonaisuuden (arkistoyksikön) yksilöintiin käytettävä, arkistointijärjestykseen perustuva tieto, joka erottaa samannimiset aineistot toisistaan |
“max_length”: | 512 |
“required”: | Valinnainen |
“dependency“: | Jos kenttään annetaan arvo, tulee Tarkenteen tyypistä pakollinen tieto. |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | date |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A28 Name |
Vastaavuus Dublin Core: | Title |
Tarkenteen tyyppi
Metatietoelementti: | title_type |
“name_fi”: | Tarkenteen tyyppi |
“description”: | Kuvailee tarkenteen tyypin tarkenteen, eli on kyseessä aakkoselliseen vai numeeriseen arkistointijärjestykseen perustuva tarkenne. |
“description_perusmetatieto”: | Aineistolle annetun nimekkeen tarkenne, esimerkiksi alkuaan analogisen asiakirjakokonaisuuden (arkistoyksikön) yksilöintiin käytettävä, arkistointijärjestykseen perustuva tieto, joka erottaa samannimiset aineistot toisistaan |
“max_length”: | - |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A28 Name |
Vastaavuus Dublin Core: | Title |
Tarkenteen selite
Metatietoelementti: | title_description |
“name_fi”: | Tarkenteen selite |
“description”: | Kuvailee tarkenteen arvon selitteen, esim. pykälät tai sukunimet |
“description_perusmetatieto”: | Aineistolle annetun nimekkeen tarkenne, esimerkiksi alkuaan analogisen asiakirjakokonaisuuden (arkistoyksikön) yksilöintiin käytettävä, arkistointijärjestykseen perustuva tieto, joka erottaa samannimiset aineistot toisistaan |
“max_length”: | 5000 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A28 Name |
Vastaavuus Dublin Core: | Title |
Alkava aika
Metatietoelementti: | content_dates_start |
“name_fi”: | Alkava aika |
“description”: | Kuvailun kohteena olevan tietoaineiston ajallisen kattavuuden alkuarvo. SAPA:n rajapinnalla arvon voi antaa päivän, kuukauden tai vuoden tarkkuudella käyttäen väliviivaa erottimena, esimerkiksi 1996-01-01, 1998-12 tai 2000. |
“description_perusmetatieto”: | Asiakirjakokonaisuuden luontiin, käsittelyyn ja sisältöön liittyvät aikamääreet, joiden avulla asiakirjakokonaisuus yksilöidään ja liitetään tarvittaviin asiayhteyksiin. |
“max_length”: | 10 |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | date |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Created Record/Created |
Vastaavuus RiC-CM: | RiC-E18 Date. RiC-R069 Is beginning date of |
Vastaavuus Dublin Core: | Date |
Päättyvä aika
Metatietoelementti: | content_dates_end |
“name_fi”: | Päättyvä aika |
“description”: | Kuvailun kohteena olevan tietoaineiston ajallisen kattavuuden loppuarvo. SAPA:n rajapinnalla arvon voi antaa päivän, kuukauden tai vuoden tarkkuudella käyttäen väliviivaa erottimena, esimerkiksi 1996-01-01, 1998-12 tai 2000. |
“description_perusmetatieto”: | Asiakirjakokonaisuuden luontiin, käsittelyyn ja sisältöön liittyvät aikamääreet, joiden avulla asiakirjakokonaisuus yksilöidään ja liitetään tarvittaviin asiayhteyksiin. |
“max_length”: | 10 |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | date |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Finished Record/Accepted |
Vastaavuus RiC-CM: | RiC-E18 Date. RiC-R071 Is end date of |
Vastaavuus Dublin Core: | Date |
Turvallisuusluokka
Metatietoelementti: | security_class_2020 |
“name_fi”: | Turvallisuusluokka |
“description”: | Kuvailun kohteena olevalle tietoaineistolle merkitään valtioneuvoston asetuksen asiakirjojen turvallisuusluokittelusta valtionhallinnossa (1101/2019) mukainen turvallisuusluokka. Mikäli luokitus ei ole käytössä tai tietoaineistolla ei ole turvallisuusluokkaa, käytetään arvoa ”Ei turvallisuusluokiteltu”, tyhjää valintaa ei viranomaisaineistoilla käytetä. |
“description_perusmetatieto”: | Turvallisuusluokkaa koskeva merkintä, jos asiakirja tai siihen sisältyvä tieto on salassa pidettävä julkisuuslain (JulkL) 24 §:n 1 momentin 2, 5 tai 7–11 kohdan perusteella ja asiakirjaan sisältyvän tiedon oikeudeton paljastuminen tai oikeudeton käyttö voi aiheuttaa vahinkoa maanpuolustukselle, poikkeusoloihin varautumiselle, kansainvälisille suhteille, rikosten torjunnalle, yleiselle turvallisuudelle tai valtion- ja kansantalouden toimivuudelle taikka muulla niihin rinnastettavalla tavalla Suomen turvallisuudelle. (TiHL § 18) |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Restriction/SecurityClass Record/Restriction/SecurityClass |
Vastaavuus RiC-CM: | RiC-A07 Classification |
Vastaavuus Dublin Core: | - |
Julkisuusluokka
Metatietoelementti: | confidentiality_class |
“name_fi”: | Julkisuusluokka |
“description”: | Julkisuusluokalla ilmaistaan, sisältääkö kuvailtava kohde julkisuuslain (621/1999) tai muun lainsäädännön perusteella salassa pidettävää tietoa.
|
“description_perusmetatieto”: | Aineiston luokittelu sen julkisuuden mukaan. |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | Jos antaa kohtaan muun kuin ”Julkinen” tai “Määrittelemätön“ -arvon, tulee ”Käyttörajoitus” -kohta pakolliseksi. |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Restriction/PublicityClass Record/Restriction/PublicityClass |
Vastaavuus RiC-CM: | RiC-A07 Classification |
Vastaavuus Dublin Core: |
|
Henkilötiedot
Metatietoelementti: | personal_data |
“name_fi”: | Henkilötiedot |
“description”: | Kertoo, sisältääkö kuvailtava kohde henkilötietoja. EU:n yleisessä tietosuoja-asetuksessa (679/2016) henkilötiedoilla tarkoitetaan kaikkia tunnistettuun tai tunnistettavissa olevaan luonnolliseen henkilöön liittyviä tietoja; tunnistettavissa olevana pidetään luonnollista henkilöä, joka voidaan suoraan tai epäsuorasti tunnistaa erityisesti tunnistetietojen, kuten nimen, henkilötunnuksen, sijaintitiedon, verkkotunnistetietojen taikka yhden tai useamman hänelle tunnusomaisen fyysisen, fysiologisen, geneettisen, psyykkisen, taloudellisen, kulttuurillisen tai sosiaalisen tekijän perusteella. Mahdollisten arvojen kuvaus:
|
“description_perusmetatieto”: | Aineiston luokittelu sen sisältämien henkilötietojen perusteella. |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type” | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Restriction/PersonalData Record/Restriction/PersonalData |
Vastaavuus RiC-CM: | RiC-A07 Classification |
Vastaavuus Dublin Core: | Rights |
Käyttörajoitukset
Metatietoelementti: | access_restrictions |
“name_fi”: | Käyttörajoitukset |
“description”: | Käyttörajoitus kuvaa rajoitusta, joka kohdistuu kuvailtavan kohteen sisältämään tietoon kokonaisuudessaan. Rajoitus tarkoittaa, että rajoitettu kohde ei ole vapaasti saatavilla, vaan käyttö vaatii tiettyjä toimenpiteitä kuten saapumista paikan päälle tarkastelemaan rajoitettua kohdetta tai hakemaan käyttöoikeutta. Viranomaisen tuottamassa tietoaineistossa rajoitus perustuu lähes poikkeuksetta sääntelyyn. Sapan rajapinnan sanomissa käyttörajoitus tulee esittää vektorina siten, että sen alkiot ovat JSON-objekteja, jotka sisältävät elementit ”template_identifier” ja ”authorizing_entity”. |
“description_perusmetatieto”: | Tieto oikeudellisesta käyttörajoituksesta, joka liittyy aineistoon ja sen sisältämään tietoon kokonaisuudessaan. |
“max_length”: | - |
“required”: | Pakollinen (muu kuin julkinen aineisto) |
“dependency“: | Jos kuvailtava kohde sisältää Käyttörajoituksia, tulee Käyttöluvan myöntäjä (3.17) -tiedosta pakollinen. |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | object_array |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Restriction/SecurityReason Record/Restriction/SecurityReason |
Vastaavuus RiC-CM: | RiC-A08 Conditions of Access; RiC-A09 Conditions of Use |
Vastaavuus Dublin Core: | Rights. Access Rights |
Rajoituspohjan tekninen tunniste
Metatietoelementti: | template_identifier |
“name_fi”: | Rajoituspohjan tekninen tunniste |
“description”: | Käyttörajoituksen sisäinen tunniste Kansallisarkiston arkistokuvailun metatietovarannossa. |
“description_perusmetatieto”: | - |
“max_length”: | - |
“required”: | Pakollinen (muu kuin julkinen aineisto) |
“dependency“: | Jos kuvailtava kohde sisältää Käyttörajoituksia, tulee Käyttöluvan myöntäjä (3.17) -tiedosta pakollinen. |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A08 Conditions of Access; RiC-A09 Conditions of Use |
Vastaavuus Dublin Core: | Rights. Access Rights |
Käyttöluvan myöntäjä
Metatietoelementti: | authorizing_entity |
“name_fi”: | Käyttöluvan myöntäjä |
“description”: | Käyttöluvan myöntäjä on taho, joka myöntää käyttöluvan käyttörajoitettuun tietoaineistoon. |
“description_perusmetatieto”: | Taho, jolla on valtuudet myöntää käyttölupa käyttörajoitettuun tietoaineistoon. |
“max_length”: | - |
“required”: | Pakollinen (muu kuin julkinen aineisto) |
“dependency“: | Jos kuvailtava kohde sisältää Käyttöluvan myöntäjiä, tulee Käyttörajoitus (3.16) -tiedosta pakollinen. |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-E07 Agent. RiC-R040 Is or was holder of intellectual property rights of |
Vastaavuus Dublin Core: | Rights Holder |
Tietosisältö
Metatietoelementti: | description |
“name_fi”: | Tietosisältö |
“description”: | Elementin tarkoituksena on tarjota käyttäjälle mahdollisuus arvioida kuvailun kohteena olevalle tietoaineiston tietosisältöä kokonaisnäkökulmasta ja esittää siitä käyttäjää mahdollisesti kiinnostavia yksityiskohtia. Tässä tarkoituksessa tietosisältö toimii kuvailtavan kohteen tunnistamistietoja ja sisällönkuvausta täydentävänä ja/tai tarkentavana kuvailutietona. Muista metatietokentistä ilmenevää tietoa ei ole tarpeen tässä kentässä toistaa. Voit kuvata kentässä myös kuvailtavan kohteen tietosisällön eheyttä. Kuvaus laaditaan kokonaisin virkkein. |
“description_perusmetatieto”: | Tiivis kuvaus aineistosta ja sen sisältämästä tiedosta eli asioista ja aihepiireistä, tiedon määrästä ja ajallisesta ja maantieteellisestä kattavuudesta eli ajanjaksoista ja paikoista, joita aineiston sisältö koskee, sekä tiedon luettavuuteen ja ymmärrettävyyteen vaikuttavista seikoista kuten eheydestä ja autenttisuudesta. |
“max_length”: | 5000 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto, Sähke2 |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | CaseFile/Description, Abstract, Subject, Custom Record/Description, Abstract, Subject, Custom |
Vastaavuus RiC-CM: | RiC-A38 Scope and Content |
Vastaavuus Dublin Core: | Description |
Aineiston historia
Metatietoelementti: | signature_description |
“name_fi”: | Aineiston historia |
“description”: | Tiivis ja suppea kuvaus tietoaineiston tai sen ilmentymien autenttisuuden, eheyden ja tulkinnan kannalta merkityksellisistä, aineiston synty-, käsittely-, käyttö-, omistus- ja säilytyshistoriaa valottavista tiedoista. Laadi kuvaus tekstikenttään kokonaisin virkkein. |
“description_perusmetatieto”: | Aineiston autenttisuuden, eheyden ja tulkinnan kannalta merkitykselliset muodostumis-, säilytys-, käsittely- ja omistushistoriaan liittyvät elinkaaritapahtumat. |
“max_length”: | 5000 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A21 History |
Vastaavuus Dublin Core: | Provenance; Description |
Käyttö- ja tulkintaohje
Metatietoelementti: | processing_notes |
“name_fi”: | Käyttö- ja tulkintaohje |
“description”: | Kuvailun kohteena olevan tietoaineiston käyttöä, käsittelyä ja tulkintaa tukevat sanalliset ohjeet tai linkki vastaaviin ohjeisiin. Elementtiä käytetään tyypillisesti silloin, kun aineiston käyttö edellyttää erityisen ohjeen laatimista. Esimerkiksi siirrettävän aineiston tietorakenteen kuvauksia ja käytettyjen koodistojen kuvauksia tai viittaus vastaaviin tietoaineistoihin. |
“description_perusmetatieto”: | Sanallinen kuvaus sellaisista aineiston käyttöä ja tulkintaa tukevista tiedoista ja aineiston ominaisuuksista, joille ei ole määritelty omaa metatietokenttää. |
“max_length”: | 5000 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A38 Scope and Content |
Vastaavuus Dublin Core: | Description |
Hakuvälineet
Metatietoelementti: | processing_aids |
“name_fi”: | Hakuvälineet |
“description”: | Kuvailun kohteena olevan tietoaineiston käyttöä tukevat tietoaineistot, jotka on jo siirretty Kansallisarkistoon. Sanallinen kuvaus yhteydestä käytettävissä oleviin hakemistoihin tai muihin apuaineistoihin, jotka tukevat aineiston hakua, käyttöä, käsittelyä tai tulkintaa. |
“description_perusmetatieto”: | Kuvaus hakemistosta tai muusta käytettävissä olevasta aineistosta, joka tukee kuvailtavan aineiston hakua, käyttöä, käsittelyä tai tulkintaa. |
“max_length”: | 5000 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-E02 Record Resource. RiC-R021 Describes or Described; RiC-A38 Scope and Content |
Vastaavuus Dublin Core: | Description; Relation. References |
Liittyvät siirtämättömät aineistot
Metatietoelementti: | related_preserved_content |
“name_fi”: | Liittyvät siirtämättömät aineistot |
“description”: | Sanallinen kuvaus kuvailun kohteena olevaan tietoaineistoon liittyvistä, Kansallisarkiston tietovarantojen ulkopuolella hallinnoitavista, tietoaineistoista/tietovarannoista/tietojärjestelmistä riippumatta näiden hallinnoijasta tai sijainnista. |
“description_perusmetatieto”: | Kuvailtavaan aineistoon arkisto- tai asiayhteyden perusteella liittyvä aineisto. |
“max_length”: | 5000 |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | string |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A RiC-R022 Is record resource associated with record resource; RiC-A38 Scope and Content |
Vastaavuus Dublin Core: | Relation. References |
Aineistotyyppi
Metatietoelementti: | content_type |
“name_fi”: | Aineistotyyppi |
“description”: | Aineistotyypit toimivat hakutietoina ja niiden avulla hallinnoidaan aineistoja. Jos samassa kuvailun kohteessa on useamman tyyppistä aineistoa, valitaan arvo ”Määrittämätön” tai kohteen olennaisin aineistotyyppi.
|
“description_perusmetatieto”: | Sisältötyyppi kuvaa aineiston mediatyyppiä ja sitä, minkä aistin välityksellä aineistoa on tarkoitus tarkastella |
“max_length”: | - |
“required”: | Valinnainen |
“dependency“: | - |
“scope“: | Rakenteinen tietoaineisto, Muut digitaaliset tietoaineistot, Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | RiC-A10 Content Type |
Vastaavuus Dublin Core: | Type |
Digitoinnin laatukriteerit
Metatietoelementti: | digitization_rationale |
“name_fi”: | Digitoinnin laatukriteerit |
“description”: | Kansallisarkiston tietojärjestelmien sisäinen elementti liittyen digitoidun tietoaineiston siirtämiseen. Tieto annetaan siirtoeräkohtaisesti. Metadatakatalogissa on tässä kohdassa listattuna kaikki Kansallisarkiston arkistokuvailun metatietovarannosta löytyvät arvot - myös sellaiset, jotka eivät enää ole aktiivisessa käytössä. Siirroissa käytettävät arvot:
|
“description_perusmetatieto”: | - |
“max_length”: | - |
“required”: | Pakollinen |
“dependency“: | - |
“scope“: | Digitoitu kuva-aineisto |
”type”: | enum |
Mahdolliset vastaavuudet eri skeemoissa | |
Vastaavuus SÄHKE2: | - |
Vastaavuus RiC-CM: | - |
Vastaavuus Dublin Core: | - |