Versions Compared

Key

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

...

Oletuskieli

Yhteentoimivuusalustan oletuskielenä on suomi, joten jos aloitat tietomallin tekemisen "tyhjästä", Tietomallit-työkalu tekee resurssien sisäisetkin nimet suomen kielen pohjalta. Kun esimerkiksi on luotu tietomalliin Asiakirja-niminen luokka, sen URI:ssa näkyy suomenkielinen nimityksen mukaan luotu tunnus: http://uri.suomi.fi/datamodel/ns/jhs#Asiakirja.

Jos haluat, että tietomallin pohjalta tehdyssä skeemassa käytetäänkin käytetään jotain muuta kieltä, kuten englantia, sinun pitää joko luoda tietomalli alusta alkaen englanninkieliseksi tai sitten täydentää suomenkieliseen tietomalliin englanninkieliset lisätiedot.

...

Tällä hetkellä voit luoda tietomallin (suomen lisäksi) joko englannin- tai ruotsinkielisenä.

Englanninkielisen tietomallin luominen

Luo ensiksi tietomalli. Siirrä kielivalinnoissa englanti ensimmäiseksi kieleksi tai poista muut kielet valikoimasta.

...

Kun tietomallin tiedot on syötetty, siirry sisällön määrittelyyn. Mikäli sisällön kieli ei jo valmiiksi ole englanti, vaihda sisällön kieli englanniksi.Image Removed

Image Added

Tarkennetun luokan lisääminen tietomalliin

Hae resursseja englanniksi tai määrittele uusia itse englanninkielisinä. Hakusivu näyttää resurssit englanninkielisinä, kielivalintasi mukaan. 

...

Kun tarkennat luokan jonkin suomenkielisen tietokomponentin pohjalta, voit muuttaa muuta omassa tietomallissasi paikallisesti sen suomenkielisiä tietoja englanninkielisiksi.

...

Kirjoita myös Kuvaus -kenttään englanninkielinen teksti. Jos sitä ei ole, työkalu näyttää suomenkielisen tekstin. (Kuvassa tietokomponentista peräisin oleva pohjateksti näkyy harmaalla, mutta sen tilalle kirjoitetaan varsinainen siis pitää kirjoittaa oikea englanninkielinen teksti.) Kun olet syöttänyt tarvittavat tiedot ja tehnyt muutokset, napsauta Tallenna-painiketta.

...

Kun tarkennetun luokan (eli shapen) tunnus on englanniksi, myös luokan URI:sta tulee englanninkielinen: http://uri.suomi.fi/datamodel/ns/rtest#Credit

Uuden luokan lisääminen tietomalliin

Jos ei löydy sopivaa tietokomponenttia tarkennettavaksi, määrittelet luokan tiedot itse, jolloin sen voi määritellä suoraan englanninkieliseksi.

Esimerkiksi Cereal-luokka saa tässä esimerkkitietomallissa URI:n http://uri.suomi.fi/datamodel/ns/rtest#Cereal.

Image Removed

4.3 Suomenkielisen tietomallin täydentäminen

Napsauta Add class -painiketta. Syötä hakukenttään englanninkielisiä termejä, tässä esimerkkinä credit. Löytyy aiemmin määritelty luokka koulutuksen tietokomponenttikirjastossa, joten voit tehdä sen pohjalta tarkennetun luokan (shape).

Image Removed

Mikäli tarkennat luokan jonkin suomenkielisen tietokomponentin pohjalta, voit muuttaa sen suomenkielisiä tietoja englanninkielisiksi.

Napsauta luokan riviä listauksessa, jolloin se viedään tietomalliisi. Tässä tapauksessa työkalu tarjoaa suomenkielisen Arvosana-luokan (tietokomponentti) pohjalta tämän tarkennetun luokan tunnukseksi Arvosana, mutta vaihda se englanninkieliseksi eli kirjoita Shape id -kenttään tilalle Credit

Kirjoita myös Description-kenttään englanninkielinen teksti. Jos sitä ei ole, työkalu näyttää suomenkielisen tekstin. 

Image Removed

...

Image Added

Eri kieliversioiden näkyminen skeemassa

Tekniset nimet voidaan siis paikallistaa JSON- ja XML-skeemoissa määrittelemällä paikalliset tunnukset luokalle ja luokan attribuuteille.

Tässä esimerkissä, kun tietomallin lataa esimerkiksi JSON-LD-muotoisessa teknisessä formaatissa, tarkennetussa luokassa näkyvät eri kieliversiot omilla riveillään. Nimi-kentän tiedoissa näkyy sekä alkuperäisen tietokomponentin suomenkielinen nimi (Arvosana) että antamasi tarkennetun luokan englanninkielinen nimi (Credit). Samaten Kuvaus-kentälle löytyvät molemmat kieliversiot.

"@id" : "rtest:Credit",
    "@type" : "sh:NodeShape",
    "created" : "2020-05-20T18:15:15.378Z",
    "identifier" : "urn:uuid:db43fd0f-8e2a-4ad1-b2ad-94d790293b9d",
    "modified" : "2020-05-20T18:32:46.41Z",
    "statusModified" : "2020-05-20T18:15:15.378Z",
    "isDefinedBy" : "http://uri.suomi.fi/datamodel/ns/

...

rtest",
    "versionInfo" : "DRAFT",
    "description" : [ {
      "@language" : "fi",
      "@value" : "arvioinnin tuloksena ..."
    }, {
      "@language" : "en",
      "@value" : "English description text"
    } ],
    "name" : [ {
      "@language" : "fi",
      "@value" : "Arvosana"
    }, {
      "@language" : "en",
      "@value" : "Credit"
    } ] ...

Tietomallissa itsessään määritellyn Cereal-luokan tiedoissa taas näkyy vain englanninkielinen nimi, koska sille ei suomenkielisiä tietoja annettukaan.

 "name" : {
      "@language" : "en",
      "@value" : "Cereal"....