...
1.2 CodeSchemes-välilehti (Koodiston tiedot, koodiston nimi ja metatiedot)
Sarakkeen nimi | Kuvaus | Pakollisuus |
---|---|---|
CODEVALUE | Koodiston itse määritelty tunniste, koodi. Tieto on pakollinen. | x |
ID | Järjestelmän generoima yksilöivä 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 koodistoille määritettyjen arvojen kanssa. | |
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 |
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. |
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 |
PREFLABEL_FI | Koodiston nimi suomeksi. Jos prefLabel-kenttää ei ole käytetään codeValue-kenttää käyttöliittymässä. | |
PREFLABEL_SV | Koodiston nimi ruotsiksi | |
PREFLABEL_EN | Koodiston nimi englanniksi | |
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. | |
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 |
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ä. |
1.3 Codes-välilehti (Välilehdeltä tuodaan koodit ja niiden metatiedot)
Sarakkeen nimi | Kuvaus | Pakollisuus |
---|---|---|
CODEVALUE | Koodi eli koodin arvo. Usein koodit ovat numeromuodossa, mutta ne voivat olla myös tekstiä. | x |
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. | |
STATUS | Koodin tila. Sallitut arvot ovat: DRAFT, SUGGESTED, SUBMITTED, VALID, SUPERSEDED, RETIRED ja INVALID. | x |
BROADER | Hierarkkisen koodiston ylemmän tason koodi eli isäntäsolun arvo. Kenttää käytetään muodostettaessa koodiston hierarkian puurakenne. |
ORDER | Järjestysnumero (käytetään sovelluksessa sisäisesti koodien järjestämiseen) | x |
HIERARCHYLEVEL | Koodin hierarkiataso. Arvo 1 kuvaa ensimmäisen tason (päätaso), arvo 2 toisen tason jne. | |
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 | |
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ä. |
1.4 Links-välilehti: Koodistossa ja sen koodeissa käytetyt linkit
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 |
2. Koodiston tuonti Excel-tiedostosta
...
2. Klikkaa "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ä.
...
Huom. Voit korvata tuonnilla vain DRAFT (luonnos), SUBMITTED (odottaa hyväksyntää) tai SUGGESTED (ehdotus) tiloissa olevia koodistoja.
Info | ||
---|---|---|
| ||
Excel-tiedostoa voi käyttää koodiston muokkaamiseen ja koodien lisäämiseen koska tallennetun koodiston voi tuoda uudestaan Koodistot-työkaluun. Tuotu koodisto korvaa Koodistot-työkalussa olevan koodiston. |
...
Voit lisätä koodeja Koodit-välilehdellä klikkaamalla "Tuo koodeja"-painiketta. Koodien tuonnissa avautuu vastaava ikkuna kuin kohdassa 2.2.seuraava ikkuna: