5. Lisää luokka tietomalliin - perusperiaatteet

Peruslähtökohtana on, että tietokomponenttikirjastoista löytyy jokin aiemmin kuvattu luokka, jota voit hyödyntää suoraan sellaisenaan, tai ainakin löytyy luokka, jota voit tarkentaa (= muokata) niin, että se soveltuu paremmin käyttöösi. 

Mutta koska sopivaa luokkaa ei aina löydy, voit myös itse määritellä luokan soveltamisprofiiliisi. Tässä tapauksessa yritä ensin hakea sanastosta sopiva käsite, jonka ympärille luokan määrittelet. Mikäli tällaista käsitettä ei löydy, voit ehdottaa sellaista lisättäväksi sanastoon, tai määritellä luokan ilman käsiteviittausta.

Vaihtoehtoja ovat siis seuraavat:

• Käytä suoraan aiemmin määriteltyä luokkaa sellaisenaan (5.1 Lisää tietomalliin luokka "kopioimalla" tietokomponentin luokka)
• Tarkenna aiemmin määriteltyä luokkaa (5.2 Lisää tietomalliin uusi luokka tarkentamalla aiempaa luokkaa)
• Lisää luokka viittaamalla suoraan aiemmin määriteltyyn luokkaan (5.4 Lisää tietomalliin uusi luokka viittaamalla ulkoiseen tunnisteeseen)
• Lisää täysin uusi luokka ja uusi käsiteviittaus Tietomallit-työkaluun (5.3 Lisää uusi luokka, mutta määrittele sille ensin uusi käsite)

Tässä kuvataan näille vaihtoehdoille yhteinen prosessin alkuvaihe, mutta muuten nämä eri vaihtoehdot kuvataan tarkemmin omilla sivuillaan. 

Tee näin:

1. Kun olet soveltamisprofiilin kuvaussivulla, sivun vasemmalla puolella näkyy siihen sisältyvien luokkien, attribuuttien ja assosiaatioiden lista. (Mikäli soveltamisprofiili on vasta luotu, nämä listat ovat vielä tyhjiä. Muuten näet Luokka-otsikon alla listan soveltamisprofiilissa jo olevista luokista.)
   Klikkaa Lisää luokka -painiketta. Saat näkyvillesi uuden ikkunan.
   
   
   
   
2. Lisää luokka -sivulla tarkista ensin, onko samanniminen luokka jo olemassa eli hae luokkaa (katso kuva alla kohdassa 3).
   1. Kirjoita hakukenttään (Hae luokkaa) luokan nimi. Voit rajata haun pelkästään nimeen, kuvaukseen tai tunnisteeseen (tai näiden yhdistelmään).
      Kun kirjoitat tähän hakukenttään tekstiä, alapuolella olevaan  kenttään (kohta e) suodattuvat näkyviin vain ne luokat, joiden nimi täsmää kirjoittamaasi hakusanaan. 
      Jos täsmälleen sopivaa vaihtoehtoa ei ole, työkalu tarjoaa myös kaksi muuta vaihtoehtoa (jotka on kuvattu kohdissa c ja d; erotat ne sinisestä taustaväristä). 
   2. Voit rajata haun alaa alasvetovalikon avulla, ja kohdistaa haun vain tiettyyn tietomalliin (esimerkiksi pelkästään julkishallinnon tietokomponentteihin). 
      1. Jos ruksaat kohdan Näytä profiileissa määritellyt luokat, näet luokkien listassa myös tähän soveltamisprofiiliin jo lisätyt luokat ja niiden tiedot, muuten vain tietokomponenttikirjastosta valittavissa olevia luokkia.
         
   3. Ikkunassa näkyy lista luokkia ja kaksi vaihtoehtoa, miten niitä voi hyödyntää (sinisellä taustavärillä merkityt kentät. Niiden käyttö on tässä ohjeessa selostettu kohdissa c) ja d).
      
      Eli jos sopivia luokkia on jo määritelty, saat näkyvillesi listan luokista, joiden tiedoissa (nimessä/kuvauksessa/tunnisteessa) löytyy antamasi hakusana.
      1. Jos luokan nimi näkyy normaalina tekstinä voit valita sen klikkaamalla riviä ja sen jälkeen Tarkenna luokka -painiketta.
      2. Mikäli luokka näkyy listassa harmaana, et ole määritellyt sen nimiavaruutta soveltamisprofiiliisi etkä voi siinä tapauksessa valita sitä. 
   4. Kun haluat hyödyntää muiden tietomallien luokkia, linkitä tarvitsemasi tietomallit (eli teknisesti sanoen niiden nimiavaruudet) mukaan soveltamisprofiiliisi. (Linkki ohjeeseen: 4. Täydennä tai muokkaa tietomallin yleiskuvausta, kohta Käytetyt nimiavaruudet).
   5. sdsad
   6. Valitse haluamasi tietosisällön kieli oikean yläkulman alasvetovalikosta Sisältö xxx. 
      Valittavina ovat kaikki soveltamisprofiille määritellyt kielet (Linkki kielivaihtoehtojen määrittelyohjeeseen: 3. Tee uusi tietomalli).
      
      
      
      
3. Esimerkki, jossa sopiva luokka löytyy:
   1. Hakukenttään (Hae luokkaa) on kirjoitettu luokan nimi Asiakirja, joka löytyy Tietomallit-työkalusta. 
   2. Halutessasi voit rajata haun alaa, ja kohdistaa haun esim. pelkästään julkishallinnon tietokomponentteihin. 
      
      Sinulla on useita vaihtoehtoja:
   3. Luokan sisältö onkin jotain muuta kuin olit hakemassa. Siksi haluat luoda soveltamisprofiiliisi uuden luokan, jonka kuvauksen määrittelet itse. Tämä luokka on käytössä vain omassa soveltamisprofiilissasi.
      Klikkaa kohtaa  Luo uusi luokka 'xxx' (jossa xxx on antamasi hakusana).
   4. Mikäli tiedät jo valmiiksi etsimäsi luokan tunnuksen Tietomallit-työkalussa, klikkaa kohtaa Luo uusi tarkennettu luokka viittaamalla ulkoiseen tunnisteeseen ja siirryt uudelle sivulle: 5.4 Lisää tietomalliin uusi luokka viittaamalla ulkoiseen tunnisteeseen
   5. Löydät sopivan luokan hakutulosten listasta ja klikkaat sitä (eli tässä Asiakirja-otsikkoa) ja sitten Tarkenna luokka -painiketta. Siirryt uudelle sivulle täydentämään luokan kuvausta: 5.1 Lisää tietomalliin luokka "kopioimalla" tietokomponentin luokka
      
      
   • 
     
     
     
     
4. Esimerkki, jossa hakemaasi luokkaa ei löydy, vaan sinun pitää määritellä uusi luokka. 
   Vaihtoehdot (c) ja (d) ovat samat kuin edellä, mutta vaihtoehtoa (e) ei ole tässä. 
   1. Hakukenttään (Hae luokkaa) on kirjoitettu luokan nimi Liikuntasali, jota Tietomallit-työkalusta ei ennestään löydy...
   2. ...vaikka haetaan kaikista tietomallesita.
      
      Vaihtoehdot:
   3. Luot soveltamisprofiiliisi uuden luokan, jonka kuvauksen määrittelet itse. Tämä luokka on käytössä vain omassa soveltamisprofiilissasi. 
      Klikkaa kohtaa  Luo uusi luokka 'xxx' (jossa xxx on antamasi hakusana).
   4. Mikäli tiedät jo valmiiksi etsimäsi luokan tunnuksen Tietomallit-työkalussa, klikkaa kohtaa Luo uusi tarkennettu luokka viittaamalla ulkoiseen tunnisteeseen ja siirryt  uudelle sivulle täydentämään luokan kuvausta (5.4 Lisää tietomalliin uusi luokka viittaamalla ulkoiseen tunnisteeseen)