...
Tietorakenteet kuvataan soveltamisprofiilissa siten, että niiden perusteella voidaan muodostaa fyysinen tietomalli eri tekniikoilla tai syntaksilla. Tietomallit.suomi.fi sovelluksella toteutetun soveltamisprofiilin tietorakenteet ovat määritelty rakenteisesti linkitettynä datana ja siitä voidaan suoraan johtaa XML tai JSON skeema.
Soveltamisprofiilin tietosisältö kuvataan aina tietojärjestelmän kannalta olennaisella tarkkuudella, joka määrittyy käyttötarpeen mukaan. Sisällöllisesti soveltamisprofiili on sopimus siitä miten yhteisesti sovittua kieltä ja rakenteita käytetään tietyssä käyttötarkoituksessa. Käyttötarkoitus voidaan jakaa karkealla tasolla kolmeen eri ryhmään:
- Tiedonsiirtorajapinnan tietosisältö - Miten tietoa siirretään?
- Sovellusrajapinnan tietosisältö - Miten tietoa käsitellään?
- Tietovaraston tietosisältö - Miten tietoa säilytetään?
Yleisiä mallinnusperiaatteita
- Määrittele vain sellaisia tietosisältöjä joille on selkeä käyttötarkoitus
- Kun määrittelet uuden tietosisällön, käytä tietoalueen sanastoa
- Ehdota uusia käsitteitä, jos tietosisältöä kuvaavaa käsitettä ei ole määritelty sanastossa
- Uudelleenkäytä luokkia, attribuutteja ja assosiaatioita julkisen hallinnon tietokomponenttikirjastosta
- Ennen uuden tietosisällön määrittelyä, tutki onko vastaava tietosisältö määritelty aiheeseen liittyvillä tietoalueilla
- Jos luokkaan joudutaan tekemään usein tietoaluekohtaisia lisäyksiä, määrittele luokasta alaluokka tietoalueelle
Nimeämiskäytännöt
Tietosisältöjen nimeäminen tehdään selkokielisesti hyödyntäen tietoalueen vakiintunutta sanastoa. Luokat, attribuutit ja assosiaatiot nimetään kieliversioituna ihmisluettavasti sekä teknisellä nimellä.
...
- Alkaa pienellä alkukirjaimella, esim: numberOfPages
Assosiaation nimeäminen
Assosiaatiot nimetään yleensä verbimuodossa tai roolin nimellä, esim. purchaced tai customer
Assosiaation tekinen nimi määritellaan CamelCase kirjoitusasulla:
- Alkaa pienellä alkukirjaimella, esim: relatedProduct
Eri tyyppisten tietomallien tarkkuustaso
Soveltamisprofiilin tietosisältö kuvataan aina tietojärjestelmän kannalta olennaisella tarkkuudella, joka määrittyy käyttötarpeen mukaan. Sisällöllisesti soveltamisprofiili on sopimus siitä miten yhteisesti sovittua kieltä ja rakenteita käytetään tietyssä käyttötarkoituksessa. Käyttötarkoitus voidaan jakaa karkealla tasolla kolmeen eri ryhmään:
- Tiedonsiirtorajapinnan tietosisältö - Miten tietoa siirretään?
- Sovellusrajapinnan tietosisältö - Miten tietoa käsitellään?
- Tietovaraston tietosisältö - Miten tietoa säilytetään?