Tuotavan koodiston valmistelu ja Excel-tiedoston sarakeotsikot
Koodistoja voi tuoda sekä vanhemmalla Excel-versiolla (.xls) että uudemmalla (.xlsx) Excelillä.
...
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 Tietoalueiden luokitusta (joka on laadittu Julkisten palvelujen luokituksen pohjalta). Valittavissa ovat luokituksen 27 päätason luokkaa (alaluokat ovat mukana vain kuvaamassa tietoalueen sisältöä tarkemmin). Tieto on pakollinen. Tieto annetaan koodina esim. "P10" (="Työ ja työttömyys") ks. päätason luokat Koodistot-työkalussa: https://koodistot.suomi.fi/codescheme;registryCode=jupo;schemeCode=serviceclassification | 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 INCOMPLETE (keskeneräinen), DRAFT (luonnos) ja SUBMITTED (odottaa hyväksyntää) olevia koodistoja voi vapaasti muokata. Sallitut arvot ovat: INCOMPLETE, 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", "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. Import-toiminto osaa lukea useita päivämäärämuotoja, kunhan kentät on määritetty excelissä päivämääräkentäksi. | |
ENDDATE | Koodiston loppupäivämäärä. Import-toiminto osaa lukea useita päivämäärämuotoja, kunhan kentät on määritetty excelissä päivämääräkentäksi. | |
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: INCOMPLETE, 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ä. Import-toiminto osaa lukea useita päivämäärämuotoja, kunhan kentät on määritetty excelissä päivämääräkentäksi. | |
ENDDATE | Koodin loppumispäivämäärä. Import-toiminto osaa lukea useita päivämäärämuotoja, kunhan kentät on määritetty excelissä päivämääräkentäksi. | |
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ä. |
...