Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 Tässä ohjeessa neuvotaan, kuinka Sanastot-työkalussa luodaan uusi sanastoLuokkia ja muita tietoja ei voi lisätä tietomalliin ennen kuin tietomallin pakolliset tiedot on kuvattu.

Tee näin:

  1. Klikkaa SanastotNapsauta Tietomallit-työkalun etusivulta "Lisää sanasto"
    Image Removed
  2. Täytä uuden sanaston tiedot.
    1. Sanastotyyppi: Sanastotyyppejä on kaksi: Asiasanasto ja Terminologinen sanasto. Valitse pudotusvalikosta, kumman tyyppisen sanaston haluat lisätä. Kentät ovat hieman eri paikassa eri sanastotyypeillä, tämä ohje on tehty Terminologisen sanaston näkymän mukaisesti.
    2. Julkaisija: Sanaston julkaisija on organisaatio, jonka nimissä sanasto näkyy Sanastot-työkalussa. Vain julkaisijaksi valittuun organisaatioon kuuluvat käyttäjät pääsevät muokkaamaan sanaston käsitteitä. Klikkaa "Lisää organisaatio", jonka jälkeen avautuvassa pop-up-ikkunasta voit valita julkaisijaksi organisaation. Voit valita julkaisijaksi vain sellaisen organisaation, johon sinulla itselläsi on käyttöoikeus.
    3. Luokitus: Sanastolle täytyy valita yksi tai useampi luokka, johon sen sisältö luokitellaan. Yhteentoimivuusalustassa tietosisältöjen luokituksena käytetään Julkisten palvelujen luokitusta (lyhemmin palveluluokitusta). Luokituksen avulla sanastoja voi mm. etsiä etusivulla.
    4. Sanaston tila: Uusi sanasto on oletuksena Luonnos-tilassa.
    5. Sanastotyyppi: Kohdassa a tehty valinta näkyy tässä.
    6. Etuliite: Etuliite tarkoittaa järjestelmän sisäistä Curie-tunnistetta, jolla sanasto ja siihen kuuluvat käsitteet merkitään. Etuliite toistuu sanaston ja siihen kuuluvien käsitteiden uri-osoitteissa.  
    7. Nimi: Sanaston nimi, joka näkyy sekä työkalun etusivun hakutuloksissa että sanaston otsikkona. Klikkaamalla "Lisää nimi" voit lisätä nimelle kieliversion. Klikkaamalla roskakori-kuvaketta voit poistaa ylimääräisen nimen. Klikkaamalla kolmea viivaa voit raahata nimet haluamaasi järjestykseen.
    8. Kieli: Sanaston tiedoissa valitaan ne kielet, joilla sanaston sisältöä on tuotettu. Vain sanaston tiedoissa määritellyt kielet ovat valittavissa sanaston ja sen käsitteiden sisällön kieleksi. Kielet näkyvät kaksikirjaimisina ISO 639-1 -kielikoodeina. Kielikoodin voi tarkistaa esim. Fintosta (https://finto.fi/lexvo/fi/). Kielikoodit tukevat myös kielten variantteja, esim. sv-FI (suomenruotsi). Klikkaamalla "Lisää kieli" voi lisätä uuden kielikoodin. Työkalu ehdottaa sopivaa kielikoodia tyhjään kenttään kirjoitettujen merkkien mukaan. Klikkaamalla roskakori-kuvaketta voit poistaa ylimääräisen kielikoodin. Klikkaamalla kolmea viivaa voit raahata kentät haluamaasi järjestykseen. Kielikoodit esiintyvät tässä valitussa järjestyksessä kielivalinnoissa.
    9. Kuvaus: Tarkempi kuvaus sanastosta, joka näkyy selaajille sanaston tiedoissa. Klikkaamalla roskakori-kuvaketta voi poistaa ylimääräisen kuvauksen. Klikkaamalla kolmea viivaa voit raahata kentät haluamaasi järjestykseen.
    10. Nimiavaruus: Kohdassa f valittu etuliite toistuu sanaston nimiavaruudessa.
      Image Removed
  3. Kun olet valmis, klikkaa "Tallenna".

 

Info
Jos olet tuomassa valmista sanastoa CSV-muodossa, yllä oleva osio täytyy täyttää ensin. Sanaston CSV-tuonti tapahtuu vasta, kun sanasto on ensin luotu. Ks. Ohje sanastojen tuontiin

Lue myös

Content by Label
showLabelsfalse
max5
spacesVRKYTI
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "VRKYTI"
labelskb-how-to-article

...

hiddentrue

...

  1. Lisää tietomalli-painiketta. Valitse vaihtoehdoista joko soveltamisprofiili tai tietokomponenttikirjasto. 
    Tässä esimerkissä näytetään, miten lisätään soveltamisprofiilin tiedot, mutta käytännössä tietokomponenttikirjaston lisäys tapahtuu aivan samalla tavalla - silloin vain valitaan tästä valikoista vaihtoehdoksi tietokomponenttikirjasto.
    Jos et tiedä, kumpi vaihtoehdoista pitäisi valita, niiden väliset erot on kuvattu luvussa: 13. Teenkö soveltamisprofiilin vai tietokomponenttikirjaston?

    Image Added

  2. Täydennä uuden tietomallin perustiedot. Pakolliset tiedot on merkitty käyttöliittymässä punaisella tähdellä *.
    Kun olet syöttänyt kaikki tarvittavat tiedot, tallenna tiedot napsauttamalla Tallenna-painiketta. 

    Image Added

Tietomallin tiedoissa ovat seuraavat kentät: 

KenttäSelitePakollinen
Soveltamisprofiilin nimi

Nimi, jolla tietomalli näkyy listoissa ja hakutuloksissa

  • Anna selkeä, sisältöä vastaava nimi, jolla käyttäjät löytävät tietomallisi helposti, kuten "Työpaikalla järjestettävä koulutus" tai "Väestötietojärjestelmän hakurajapinta".
X
KuvausSanallinen kuvaus tietomallista ja sen sisällöstä
Tietosisällön kielet

Kielet, joilla tietomalli kuvataan

  • Oletuskieliä ovat suomi ja englanti. Pohjakieleksi otetaan suomi, jos et valitse jotain muuta kieltä (4.4 Muun kuin suomenkielisen (esim. englanninkielisen) tietomallin luominen). Suosittelemme, että pohjakieleksi otetaan englanti. Näin tietomallisi toimii myös kansainvälisissä yhteyksissä.

  • Kieliä voi valita lisää luettelosta tai kirjoittamalla kielikoodin tähän kenttään (ISO-639-1 –luokituksen mukainen kaksikirjaiminen kielikoodi). Kun napsautat Kirjoita kielikoodi... -kohtaa, saat näkyville luettelon kaikista valittavissa olevista kielistä. Esimerkiksi ruotsin voi lisätä kirjoittamalla kenttään ruotsin koodin sv tai valitsemalla sen listasta.
  • Kun olet valinnut kielet, Tietomallit-työkalu tarjoaa omat tekstikentät kullekin valitsemallesi kielelle. Jos esimerkiksi olet ensin kirjoittanut luokkien kuvauskenttiin suomenkieliset kuvaukset, voit vaihtaa tilalle jonkin toisen kielen, ja saat näkyvillesi uudet tekstikentät, joihin voit syöttää vastaavat kuvaukset valitsemallasi kielellä.

  • Mikäli kuvauksia on tehty useilla kielillä, tulee soveltamisprofiilin kuvaukseen ”kielivipu” eli painike, josta tietojen katselija voi valita haluamansa kielen.
  • Mikäli pääosa kuvauksesta on tehty suomeksi ja vain osaan kenttiä kirjoitetaan englanninkielinen tieto, niin englanninkielisellä sivulla näkyvät englanninkieliset osuudet englanniksi, mutta loput tiedot suomeksi ja täydennettynä (fi)-liitteellä. 
  • Voit lisätä tietomallin sisältökieliä vielä myöhemminkin.
  • Voit poistaa valitun kielen napsauttamalla sen lyhenteen vieressä olevaa ruksia.
X
Etuliite 

Tunnus, jolla tietomalli yksilöidään Tietomallit-työkalussa

  • HUOM! Etuliite on ainoa tieto, jota ei voi muuttaa myöhemmin.
  • Etuliitteessä on korkeintaan 10 merkkiä eikä siinä saa olla ääkkösiä, eikä muita erikoismerkkejä kuin välimerkki - ja alaviiva  _
  • Etuliite toistuu tietomallin ja siihen kuuluvien elementtien (luokat, attribuutit, assosiaatiot) uri-osoitteissa (esimerkiksi http://uri.suomi.fi/datamodel/ns/rtest ja http://uri.suomi.fi/datamodel/ns/rtest#Henkilo).
X
Sisällön tyyppi

Tyyppi ilmaisee, millaista tietosisältöä tietomalli kuvaa. Vaihtoehtoja ovat tietovaranto, tietojärjestelmä, siirtoformaatti ja tietosisältö

  • Yleensä käytetään vaihtoehtoa tietosisältö, joka on näistä yleisin.

Yhteydenotto

Tietomallin tuottaneen organisaation yhteystieto, jonne käyttäjät voivat lähettää tietosisältöön tms. liittyvää palautetta ja kysymyksiä.

  • Esimerkiksi sisältöä tuottavan organisaation sähköpostiosoite.
  • HUOM! Kenttä on julkinen, joten siinä ei saa käyttää kenenkään henkilökohtaista sähköpostiosoitetta, vaan jotain organisaation yleistä palauteosoitetta.

Tietoalueet

Tieto siitä, mihin tietoalueeseen tietomalli liittyy. Tietomalli voi kuulua useaan tietoalueeseen.

  • Napsauta Lisää tietoalue-tekstiä, niin siirryt sivulle, jossa on listattu tietoalueet. 
  • Valitse haluamasi tietoalue napsauttamalla sen nimeä, ja se lisätään kuvaussivulle. Jos haluat lisätä usean tietoalueen, napsauta Lisää tietoalue-tekstiä niin monta kertaa, että saat poimittua kaikki haluamasi tietoalueet mukaan. 
  • Tietoalueen voi poistaa listalta napsauttamalla sen nimen vieressä olevaa roskakorikuvaketta.
X
SisällöntuottajatTieto siitä, mikä taho (organisaatio) on tuottanut tietomallin ja vastaa sen sisällöistä. 
  • Kun napsautat Lisää sisällöntuottaja -tekstiä, siirryt sivulle, jossa on listattu kaikki organisaatiot, joilla on oikeus tehdä tietomallikuvauksia. Valitse haluamasi organisaatio napsauttamalla sen nimeä. 
  • Jos vastuuorganisaatioita on useita, napsauta Lisää sisällöntuottaja -tekstiä niin monta kertaa, että saat kaikki haluamasi sisällöntuottajat listattua.
  • Organisaation voi poistaa listalta napsauttamalla sen nimen vieressä olevaa roskakorikuvaketta.
X
Käytetyt sanastot

Tieto, mitä sanastoja tietomallissa hyödynnetään 

  • Napsauta Lisää sanasto-tekstilinkkiä, niin saat näkyvillesi hakuikkunan, josta voit hakea Sanastot-työkalussa olevia sanastoja.

  • Voit etsiä sanastoa selaamalla listaa tai kirjoittaa sanaston nimen hakuikkunaan.
  • Poimi haluamasi sanasto mukaan tietomalliin napsauttamalla sen nimeä.
  • Toista, kunnes olet lisännyt kaikki tarvittavat sanastot listaan.
  • Sanaston voi poistaa listalta napsauttamalla sen nimen vieressä olevaa roskakorikuvaketta.

Koodisto

Tieto, mitä koodistoja tietomallissa hyödynnetään. 

  • Napsauta Lisää koodisto-tekstilinkkiä, niin saat näkyvillesi hakuikkunan, josta voit hakea tarjolla olevia koodistoja.

  • Napsauta koodiston nimeä, niin sivun oikealla puolella näytetään tuon koodiston tiedot.
  • Poimi koodisto mukaan tietomalliin valitsemalla se ensin listalta ja napsauttamalla sitten Käytä valintaa -painiketta, tai peru lisäys napsauttamalla Peruuta-tekstiä.
  • Koodiston voi poistaa listalta napsauttamalla sen nimen vieressä olevaa roskakorikuvaketta.

Käytetyt nimiavaruudet

Tieto, mitä nimiavaruuksia tietomallissa hyödynnetään. - Jotta soveltamisprofiilissa voidaan käyttää toisten tietomallien luokkia ja muita tietosisältöjä, nuo hyödynnettävät tietomallit määritellään tässä. Tietomallit yksilöidään nimiavaruudellaan. 

  • Napsauta Lisää nimiavaruus-tekstilinkkiä, niin saat näkyvillesi hakuikkunan, josta voit hakea muita linkitetyn datan tietomalleja, kuten tässä Tietomallit-työkalussa olevia tietokomponenttikirjastoja.

  • Voit etsiä nimiavaruuksien nimiä listalta tai kirjoittaa sen nimen hakuikkunaan.
  • Poimi haluamasi nimiavaruus mukaan soveltamisprofiiliin napsauttamalla sen nimeä.
  • Nimiavaruuden voi poistaa listalta napsauttamalla sen nimen vieressä olevaa roskakorikuvaketta.
  • Nimiavaruus on mahdollista antaa myös urn-alkuisessa muodossa.

Linkit

Linkkejä lisätietoihin, esimerkiksi hankkeen blogisivulle tai viittaus kansainväliseen skeemaan, jota tietomallissa on hyödynnetty (esimerkki: Documentation of XML Schema implementation of the EMREX Profile)

  • Linkin voi poistaa listalta napsauttamalla sen nimen vieressä olevaa roskakorikuvaketta.

LisätiedotTietomallit-työkalu voi tietomallintajan syöttämien tietojen lisäksi lisätä tietomallin kuvaukseen muitakin kenttiä. Tällaisia ovat esimerkiksi aikaleimat siitä, milloin tietomalli on luotu ja milloin sitä on viimeksi muokattu. Näitä tietoja et pysty muokkaamaan.

Kun olet valmis, tallenna tiedot napsauttamalla Tallenna-painiketta. Tietomallit-työkalu tallentaa soveltamisprofiilisi ja näyttää sinulle uuden sivun. Sivu on "tyhjän" soveltamisprofiilin pohja, jossa ei vielä ole luokkia, attribuutteja tai assosiaatioita. 

Tietomallin tiedot -välilehdellä näet tietomallin tiedot. Voit muokata niitä, kun sinulla on tietomallintajan käyttöoikeudet. 


Info
Tietokomponenttikirjasto-tietomallin luominen tapahtuu samalla tavalla kuin tässä soveltamisprofiilin tekeminen, mutta silloin valitaan Lisää tietokomponenttikirjasto valikosta.
Tietokomponenttikirjasto luodaan, kun halutaan määritellä yleisiä (geneerisiä) ja uudelleenkäytettäviä tietosisältöjä, joita on tarkoitus käyttää esimerkiksi usean eri rajapinnan kuvaamiseen. Silloin ei tarvita esimerkiksi tarkkoja kardinaliteettitietoja.
Soveltamisprofiili luodaan tiettyä asiayhteyttä ja käyttötarkoitusta varten. Esimerkiksi silloin, kun halutaan kuvata tarkasti, missä muodossa tiedot siirretään tietojärjestelmien välillä. Tyypillisesti kardinaliteettitiedot tarvitaan vasta soveltamisprofiilissa.