Alla olevissa taulukoissa esitetään esimerkkejä Kansallisarkiston metadatakatalogin mukaan normalisoiduista siirtopakettia kuvailevista kontekstimetatiedoista. Kontekstimetatiedot toimitetaan osana Sapan rajapinnalle lähetettävää luontisanomaa - yksi rajapintapyyntö siirtoerään sisältyvää siirtopakettia kohti.
Kontekstimetatieto tulee asettaa osaksi sanomaa siten, että “metadata”-avaimen arvo on tulkittavissa validina JSON-tekstinä. Elementtien järjestyksellä sanoman sisällä ei ole merkitystä, näissä esimerkeissä arvot ovat avaimen mukaan aakkosjärjestyksessä.
Jos tietoaineiston käyttöön liittyy rajoituksia, näistä tulee aina antaa sekä rajoituspohjan että tietoaineiston käyttöluvan myöntäjän tunnisteet. Rajoitukset esitetään elementillä “access_restrictions” JSON-listana siten, että alkioiden tyyppi on JSON-objekti, joka puolestaan koostuu avain-arvo-pareista ”template_identifier”: “id-value” ja “authorizing_entity”: “uuid-value”.
Tietoaineiston kieli “languages” tulee myös aina esittää JSON-listana (array), jonka alkiot ovat metadatakatalogin UUID-arvoja tekstinä. Jos tietoaineiston sisällössä on käytetty useita kieliä, tulee näiden tunnisteet erottaa toisistaan pilkulla.
Digitoitu kuva-aineisto, Muut digitaaliset tietoaineistot ja Rakenteinen tietoaineisto
Näille siirtorakenteille käytetään yhtenäistä kontekstimetatietorakennetta, jota on havainnollistettu alla olevissa esimerkeissä. Pakolliset minimimetatiedot, jotka tulee antaa jokaiselle siirtopaketille, ovat:
Tietoaineistoa kuvaava nimeke l. päänimeke
Sisällön luonne (arkisto-/säilytysvaihe)
Tietoaineiston omistava organisaatio
Henkilötietoluonne
Turvallisuusluokka (pakollinen myös ei-turvallisuusluokitellulle tietoaineistolle)
Julkisuusluokka
Jos julkisuusluokka on muu kuin “Julkinen” eli tietoaineiston käyttöön liittyy rajoituksia, annettava lisäksi:
Sähke2-siirtorakenne eroaa merkittävästi muista vastaanotettavista rakenteista. Tässä tapauksessa asioita ja asiakirjoja kuvaavat tiedot tuotetaan asianhallintajärjestelmässä ja esitetään sahke.xml- ja sahke_norm.xml-tiedostoissa. Sapa-järjestelmä parsii edellisessä luvussa esitettyjä kontekstimetatietoja vastaavat tiedot suoraan näistä tiedostoista siirtopaketin käsittelyn yhteydessä.
Vasemmassa sarakkeessa esitetään asianhallintajärjestelmän tuottamaa Sähke2-suosituksen mukaista tietoa, oikeassa niitä vastaavat tiedot tarpeellisin osin koneluettaviksi muunnettuina. Lähtökohtaisesti tiedostojen tulisi olla identtisiä kaikilta muilta osin paitsi:
tiedoston alussa oleva kommenttiblokki
SecurityReason-arvot
sahke.xml
Normalisoitu sahke_norm.xml
XML
<?xml version="1.0" encoding="UTF-8"?>
<!-- Esimerkki sahke_norm.xml-tiedoston arvoista kommenttiblokissa:
authorizing_entity: Kansallisarkisto
owner_organization: Kansallisarkisto
description_language: Suomi
content_category: Viranomaisaineisto-arkistovaihe
otherid_casefile: Diaarinumero
otherid_record: Muu tunniste
-->
<s2:Metadata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:s2="http://www.arkisto.fi/skeemat/Sahke2/2019/08/29"
xsi:schemaLocation="http://www.arkisto.fi/skeemat/Sahke2/2019/08/29 http://www.arkisto.fi/skeemat/Sahke2_2019_03.xsd">
<s2:TransferInformation>
<s2:NativeId>urn:oid:1.2.246.582.200.10012024.1</s2:NativeId>
<s2:Title>SAPA-testisiirto</s2:Title>
<s2:TransferContractId>10012024</s2:TransferContractId>
<s2:MetadataSchema>http://www.arkisto.fi/skeemat/Sahke2_2019_03.xsd</s2:MetadataSchema>
</s2:TransferInformation>
<s2:ContactInformation>
<s2:Organisation>
<s2:Name>Kansallisarkisto</s2:Name>
</s2:Organisation>
<s2:ContactPerson>
<s2:Name>SAPA-tuotetiimi</s2:Name>
<s2:Address>Rauhankatu 17</s2:Address>
<s2:PhoneNumber>000</s2:PhoneNumber>
<s2:Email>etunimi.sukunimi@kansallisarkisto.fi</s2:Email>
</s2:ContactPerson>
</s2:ContactInformation>
<s2:CaseFile>
<s2:Subject>Asiaan liittyvät asiasanat</s2:Subject>
<s2:Created>2024-05-24</s2:Created>
<s2:NativeId>urn:oid:1.2.246.582.200.10012024.1.1</s2:NativeId>
<s2:OtherId>KA/1/00.00.00/2024</s2:OtherId>
<s2:Language>fi</s2:Language>
<s2:Description>Laajempi kuvaus käsiteltävästä asiasta</s2:Description>
<s2:Abstract>Suppea kuvaus asiasta</s2:Abstract>
<s2:Restriction>
<s2:PublicityClass>Julkinen</s2:PublicityClass>
<s2:PersonalData>ei sisällä henkilötietoja</s2:PersonalData>
</s2:Restriction>
<s2:Title>Testiasia 1</s2:Title>
<s2:RetentionPeriod>-1</s2:RetentionPeriod>
<s2:RetentionReason>...</s2:RetentionReason>
<s2:Status>Valmis</s2:Status>
<s2:ClassificationScheme>
<s2:MainFunction>
<s2:Title>Yhteiset asiat</s2:Title>
<s2:FunctionCode>00</s2:FunctionCode>
<s2:FunctionClassification>
<s2:Title>Tietojärjestelmän testaus</s2:Title>
<s2:FunctionCode>00</s2:FunctionCode>
<s2:SubFunction>
<s2:Title>SAPA-testaus</s2:Title>
<s2:FunctionCode>00</s2:FunctionCode>
</s2:SubFunction>
</s2:FunctionClassification>
</s2:MainFunction>
</s2:ClassificationScheme>
<s2:Function>00.00.00</s2:Function>
<s2:Finished>2024-05-24</s2:Finished>
<s2:Action>
<s2:Created>2024-05-24</s2:Created>
<s2:Title>Käyttöliittymätestaus</s2:Title>
<s2:Type>Lähtevä</s2:Type>
<s2:Record>
<s2:Subject>Asiakirjaa koskevat asiasanat (toistettava)</s2:Subject>
<s2:Created>2024-05-24</s2:Created>
<s2:NativeId>urn:oid:1.2.246.582.200.10012024.1.1.1</s2:NativeId>
<s2:OtherId>11.404</s2:OtherId>
<s2:Language>fi</s2:Language>
<s2:Language>en</s2:Language>
<s2:Description>Laajempi kuvaus asiakirjan sisällöstä</s2:Description>
<s2:Abstract>Suppea kuvaus asiakirjasta</s2:Abstract>
<s2:Restriction>
<s2:PublicityClass>Salassa pidettävä</s2:PublicityClass>
<s2:SecurityReason>Julkisuuslain 24 § 1 mom 25</s2:SecurityReason>
<s2:PersonalData>sisältää erityisiä henkilötietoryhmiä</s2:PersonalData>
</s2:Restriction>
<s2:Title>Testiasiakirja 1.1</s2:Title>
<s2:RetentionPeriod>-1</s2:RetentionPeriod>
<s2:RetentionReason>...</s2:RetentionReason>
<s2:Status>Valmis</s2:Status>
<s2:Function>00.00.00</s2:Function>
<s2:Type>Dokumentti</s2:Type>
<s2:Accepted>2024-05-24</s2:Accepted>
<s2:Authenticity>
<s2:Checker>SAPA-tuotetiimi</s2:Checker>
<s2:Date>2024-05-24</s2:Date>
<s2:Description>Alkuperäisyys todettu</s2:Description>
</s2:Authenticity>
<s2:Document>
<s2:NativeId>urn:oid:1.2.246.582.200.10012024.1.1.1.1</s2:NativeId>
<s2:UseType>Arkisto</s2:UseType>
<s2:File>
<s2:Name>DOC0001.pdf</s2:Name>
<s2:Path>cf_01/rec_01/DOC0001.pdf</s2:Path>
</s2:File>
<s2:Format>
<s2:Name>PDF</s2:Name>
<s2:Version>1</s2:Version>
</s2:Format>
<s2:HashAlgorithm>MD5</s2:HashAlgorithm>
<s2:HashValue>ad8f19e739182b212a85c13203971730</s2:HashValue>
</s2:Document>
<s2:Custom>
<muutunniste>Organisaation sisäinen muu tunniste</muutunniste>
<muutieto>Organisaation muu sisäinen lisätieto</muutieto>
</s2:Custom>
</s2:Record>
</s2:Action>
<s2:Custom>
<muutunniste>Organisaation sisäinen muu tunniste</muutunniste>
<muutieto>Organisaation muu sisäinen lisätieto</muutieto>
</s2:Custom>
</s2:CaseFile>
</s2:Metadata>
