Koodistoja voi tuoda sekä vanhemmalla Excel-versiolla (.xls) että uudemmalla (.xlsx) Excelillä.
Excel-tiedostossa sarakkeiden järjestyksellä ei ole merkitystä. Tuotavassa tiedostossa voi olla myös muun nimisiä sarakkeita, mutta näitä ei tuoda, vaan ne ohitetaan.
Seuraavassa esimerkki import-excelistä:
Excel-tiedostossa tulee olla CodeSchemes- ja Codes-nimiset välilehdet ja tässä järjestyksessä.
Välilehtien nimet tulee olla kirjoitusasultaan juuri tämän nimisiä (isoilla ja pienillä kirjaimilla on merkitystä eli kirjoitusasu on case sensitive). Välilehtien nimet vastaavat fyysisiä Koodistot-työkalun tietokantataulujen nimiä.
Sarakkeen nimi | Kuvaus | Pakollisuus |
---|---|---|
CODEVALUE | Koodiston itse määritelty tunniste, koodi. Tieto on pakollinen. | x |
URI | URI generoituu CODEVALUE:n mukaan. Tämä kenttä jätetään tyhjäksi uutta koodistoa tuotaessa. | |
ORGANIZATION | Koodistoa hallitsevat organisaatiot. Tieto annetaan organisaation UUID-koodina, ja kenttä sallii usean organisaation määrittämisen puolipiste-erottimella. Mikäli arvoa ei anneta, koodisto kytketään rekisterin organisaatioihin. | |
INFORMATIONDOMAIN | Koodistojen luokitus. Koodistojen luokituksena käytetään Julkisten palvelujen luokitus -luokitusta (27 päätason luokkaa). Tieto on pakollinen. Tieto annetaan koodina esim. "P10" (="Työ ja työttömyys") ks. päätason luokat Sisäiset metatiedot - Koodistot | x |
LANGUAGECODE | Koodiston kielikoodi, joka määrittelee millä kielillä koodiston aineistoja voi lokalisoida. Koodistojen kielikoodeina käytetään IETF-kielikoodeja. Tieto annetaan kielikoodin arvona. Kielivalintoja voi olla useampia, jolloin erottimena toimii puolipiste. Esimerkki: fi;sv;en arvo määrittelee, että sisällön voi kuvata suomeksi, ruotsiksi ja englanniksi. Mikäli arvoa ei määritä, järjestelmä valitsee kielet dynaamisesti sisällön perusteella. Dynaamisuus toimii automaattisesti tämän sarakkeen arvojen lisäksi myös. | |
VERSION | Koodiston versionumero. Versionumero on aina kokonaisluku. Uusi koodisto saa versionumeron 1. Tuonnissa ei tarvitse antaa. | |
STATUS | Tilakoodi. Tuonnissa on oletuksena DRAFT. Tieto on pakollinen. Tiloissa DRAFT (luonnos) ja SUBMITTED (odottaa hyväksyntää) olevia koodistoja voi vapaasti muokata. Sallitut arvot ovat: DRAFT, SUGGESTED, SUBMITTED, VALID, SUPERSEDED, RETIRED ja INVALID. | x |
SOURCE | Lähde. Jos koodistolla on jokin lähde esim. laki tai kansainvälinen emokoodisto, voi sen kuvata tässä. | |
LEGALBASE | Lakiperuste | |
GOVERNANCEPOLICY | Koodiston käytön sitovuus / tai hallinnan taso esim. "Kansallinen suositus (JHS)", "Kansainvälinen suositus", "Pakollinen kunnille", "Tilastoluokitus". | |
CONCEPTURI | Sanastointegraation URI-linkki | |
DEFAULTCODE | Vakiokoodi. Käytetään erityistapauksissa. | |
PREFLABEL_FI | Koodiston nimi suomeksi. Jos prefLabel-kenttää ei ole käytetään codeValue-kenttää käyttöliittymässä. *Excelistä tulee löytyä ainakin yksi PREFLABEL -sarake eikä se saa olla tyhjä. Kaikki kielet eivät siis ole pakollisia. | x* |
PREFLABEL_SV | Koodiston nimi ruotsiksi *Excelistä tulee löytyä ainakin yksi PREFLABEL -sarake eikä se saa olla tyhjä. Kaikki kielet eivät siis ole pakollisia. | x* |
PREFLABEL_EN | Koodiston nimi englanniksi *Excelistä tulee löytyä ainakin yksi PREFLABEL -sarake eikä se saa olla tyhjä. Kaikki kielet eivät siis ole pakollisia. | x* |
DEFINITION_FI | Koodiston määritelmä suomeksi | |
DEFINITION_SV | Koodiston määritelmä ruotsiksi | |
DEFINITION_EN | Koodiston määritelmä englanniksi | |
DESCRIPTION_FI | Koodiston kuvaus suomeksi. Pitkissä teksteissä voi tällä hetkellä luoda kappalevaihdon kirjoittamalla tekstiin \n. | |
DESCRIPTION_SV | Kuvaus ruotsiksi | |
DESCRIPTION_EN | Kuvaus englanniksi | |
CHANGENOTE_FI | Muutostiedot. Tässä voi kuvata koodiston muutostietoja esim. edelliseen versioon nähden tai pidemmältä ajanjaksolta. | |
CHANGENOTE_SV | Muutostieto ruotsiksi. | |
CHANGENOTE_EN | Muutostieto englanniksi. | |
STARTDATE | Koodiston alkupäivämäärä. Muodostuu tuonnissa tuonnin ajanhetken perusteella. Päiväys ISO-8601 muodossa esim. 2018-01-16. Excel-tuonnissa kannattaa käyttää päivämäärissä funktiota =”2018-01-16”. | |
ENDDATE | Koodiston loppupäivämäärä. Päiväys ISO-8601 muodossa. | |
HREF | Koodistoon liitetyt linkit joko URIn tai linkin UUID-tunnisteen kautta. Mikäli halutaan antaa useampia linkkejä tässä sarakkeessa, tulee käyttää "|"-merkkiä erottimena. Links-välilehdellä voi määritellä tuotavat linkit ja tyypittää ne halutusti, sekä antaa niiden metatiedot omilla sarakkeilla. | |
CODESSHEET | Koodistoon liittyvät koodit määrittävä välilehti. Tarpeen määritellä erikseen, mikäli tuodaan useampia koodistoja samalla Excel-tiedostolla. Mikäli ei ole määritetty, vakioarvoisesti koodit parsitaan Codes-välilehdeltä. | |
LINKSSHEET | Koodistoon liitetyt linkit joko URIn tai linkin UUID-tunnisteen kautta. Mikäli halutaan antaa useampia linkkejä tässä sarakkeessa, tulee käyttää "|"-merkkiä erottimena. Links-välilehdellä voi määritellä tuotavat linkit ja tyypittää ne halutusti, sekä antaa niiden metatiedot omilla sarakkeilla. Mikäli käytettyä linkin URIa ei ole erikseen Links-välilehdellä määritetty, linkki luodaan ilman metatietoja geneerisellä "link"-tyypityksellä. | |
FEEDBACK_CHANNEL_FI | Yhteydenotto-ohjeet suomeksi. | |
FEEDBACK_CHANNEL_EN | Yhteydenotto-ohjeet englanniksi. | |
FEEDBACK_CHANNEL_SV | Yhteydenotto-ohjeet ruotsiksi. |
Sarakkeen nimi | Kuvaus | Pakollisuus |
---|---|---|
CODEVALUE | Koodi eli koodin arvo. Usein koodit ovat numeromuodossa, mutta ne voivat olla myös tekstiä. | x |
URI | URI generoituu CODEVALUE:n mukaan. Tämä kenttä jätetään tyhjäksi uutta koodistoa tuotaessa. | |
BROADER | Hierarkkisen koodiston ylemmän tason koodi eli isäntäsolun arvo. Kenttää käytetään muodostettaessa koodiston hierarkian puurakenne. | |
STATUS | Koodin tila. Sallitut arvot ovat: DRAFT, SUGGESTED, SUBMITTED, VALID, SUPERSEDED, RETIRED ja INVALID. | x |
PREFLABEL_<IETF-kielikoodi> | Koodin selite suomeksi. Jos prefLabel-kenttää ei ole käytetään codeValue-kenttää käyttöliittymässä. Esimerkki-arvot sarakkeille ovat PREFLABEL_FI (suomi), PREFLABEL_SV (ruotsi), PREFLABEL_EN (englanti). Muut järjestelmän tukemat IETF-kielikoodit löytyy tästä koodistosta: http://uri.suomi.fi/codelist/interoperabilityplatform/languagecodes | |
DESCRIPTION_<IETF-kielikoodi> | Koodin kuvaus suomeksi. Esimerkki-arvot ovat DESCRIPTION_FI (suomi), DESCRIPTION_SV (ruotsi), DESCRIPTION_EN (englanti). Muut järjestelmän tukemat IETF-kielikoodit löytyy tästä koodistosta: http://uri.suomi.fi/codelist/interoperabilityplatform/languagecodes | |
DEFINITION_<IETF-kielikoodi> | Koodin määritelmä. Esimerkki-arvot sarakkeille ovat DEFINITION_FI (suomi), DEFINITION_SV (ruotsi), DEFINITION_EN (englanti). Muut järjestelmän tukemat IETF-kielikoodit löytyy tästä koodistosta: http://uri.suomi.fi/codelist/interoperabilityplatform/languagecodes | |
SHORTNAME | Lyhyt nimi tai lyhenne | |
CONCEPTURI | Sanastointegraation URI-linkki | |
SUBCODESCHEME | Liittyvän koodiston URI-linkki | |
HIERARCHYLEVEL | Koodin hierarkiataso. Arvo 1 kuvaa ensimmäisen tason (päätaso), arvo 2 toisen tason jne. Arvoa ei importoitaessa lueta sisään, vaan se määrittyy aineiston hierarkisen rakenteen mukaisesti. Tämä jätetään siis tyhjäksi koodistoa importoitaessa. | |
ORDER | Järjestysnumero (käytetään sovelluksessa sisäisesti koodien järjestämiseen) | |
STARTDATE | Koodin alkamispäivämäärä. Päiväys ISO-8601 muodossa esim. 2018-01-16. Excelissä voi käyttää funktiota ="2018-03-29" | |
ENDDATE | Koodin loppumispäivämäärä. Päiväys ISO-8601 muodossa esim. 2018-01-16. | |
HREF | Koodiin liitetyt linkit joko URIn tai linkin UUID-tunnisteen kautta. Mikäli halutaan antaa useampia linkkejä tässä sarakkeessa, tulee käyttää "|"-merkkiä erottimena. Links-välilehdellä voi määritellä tuotavat linkit ja tyypittää ne halutusti, sekä antaa niiden metatiedot omilla sarakkeilla. Mikäli käytettyä linkin URIa ei ole erikseen Links-välilehdellä määritetty, linkki luodaan ilman metatietoja geneerisellä "link"-tyypityksellä. |
Sarakkeen nimi | Kuvaus | Pakollisuus |
---|---|---|
ID | Järjestelmän generoima UUID-tunniste. Arvo voidaan tuoda mikäli halutaan käyttää tiettyä UUID arvoa. Tämä on uniikki tunniste, joten se ei saa konfliktoida järjestelmässä olevien muiden koodille määritettyjen arvojen kanssa. | |
HREF | Linkin URI-tunniste. Tämä arvo tulee olla koodistoa kohden uniikki, joten kahta samaa URI-linkkiä ei voi koodistoon luoda esimerkiksi eri tyypityksillä. | x |
PROPERTYTYPE | Linkin tyypin määritys. Sallitut arvot ovat: link, source, instructions, standard, isReferencedBy, isRequiredBy, license | |
TITLE_<IETF-kielikoodi> | Linkin nimi, jossa suffixina tulee käyttää IETF-kielikoodin koodiarvoa uppercase-notaatiossa. Esimerkki-arvot sarakkeille ovat TITLE_FI (suomi), TITLE_SV (ruotsi), TITLE_EN (englanti). Muut järjestelmän tukemat IETF-kielikoodit löytyy tästä koodistosta: http://uri.suomi.fi/codelist/interoperabilityplatform/languagecodes | |
DESCRIPTION_<IETF-kielikoodi> | Linkin kuvausteksti, jossa suffixina tulee käyttää IETF-kielikoodin koodiarvoa uppercase-notaatiossa. Esimerkki-arvot sarakkeille ovat DESCRIPTION_FI (suomi), DESCRIPTION_SV (ruotsi), DESCRIPTION_EN (englanti). Muut järjestelmän tukemat IETF-kielikoodit löytyy tästä koodistosta: http://uri.suomi.fi/codelist/interoperabilityplatform/languagecodes |
1. Kun olet kirjautunut sisään Koodistot-työkaluun, näkyy Koodistot-työkalun etusivulla "Lisää koodisto" -painike.
Napsauta "Lisää koodisto"-painiketta. Esille tulee seuraava näyttö:
2. Napsauta "Tuo koodisto tiedostosta" -painiketta. Esiin aukeaa seuraava ikkuna:
3. Valitse alasvetovalikosta ensin rekisteri. Koodistot-työkaluun on valmiiksi luotu rekisterit. Käyttäjä ei voi lisätä rekisteriä.
4. Valitse tiedoston muodoksi Excel.
5. Valitse tuotava tiedosto tietokoneeltasi klikkaamalla "Selaa..."-painiketta.
6. Napsauta lopuksi "Tuo"-painiketta, jolloin koodiston tuonti alkaa ja "Tuo koodisto"-ikkuna sulkeutuu.
Tuotavassa tiedostossa päivämäärät esitetään ISO-8601 muodossa esim. 2018-01-16. Excel-tuonnissa kannattaa käyttää Excelin funktiota näin =”2018-01-16”. |