Käytä uudestaan tietomalleja, koodistoja ja sanastoja
Kun tietoa siirretään tietojärjestelmästä toiseen, on tiedon lähettäjän ja vastaanottajan ymmärrettävä tiedon sisältö ja merkitys samalla tavalla.
Ohjelmointirajapinnan kautta välitettävä tieto perustuu aina tietomalliin. Tietomalli kuvaa tiedon ja sen väliset suhteet, jäsentäen tietosisältöä. Tietomalli koostuu termeistä ja koodistosta, jossa koodisto on metatietona käytettävien koodien kokoelma.
Ohjelmointirajapinnan suunnittelussa kannattaa tarkistaa, ovatko tarvittavat koodistot jo osittain tai kokonaan olemassa. Standardien mukaisten tietomallien hyödyntäminen parantaa pitkällä aikavälillä tietojärjestelmien semanttista yhteentoimivuutta.
Ohjelmointirajapinnan laajamittainen käyttö on vaikeaa, jos sen tietomalli tai koodisto poikkeavat yleisesti käytetyistä standardeista. Käyttöä vaikeuttaa myös se, jos koodiston käyttö edellyttää maksullisten teollis- ja tekijänoikeuksien hankkimista.
Digi- ja väestötietoviraston tuottama avoimen lähdekoodin Yhteentoimivuusalusta tarjoaa mahdollisuuden hyödyntää esimerkiksi Schema.orgin tietomalleja ja täydentää niitä suomalaisilla lisäyksillä.
Tutustu Yhteentoimivuusalustaan.
On suositeltavaa kehittää englanninkielisiä yhteentoimivia tietomalleja, sillä tietojen siirto EU sisämarkkinoilla kasvaa tulevaisuudessa.
Tietokannassa oleva luku 37 voisi yksinään tarkoittaa monia eri asioita – kengännumeroa, lämpötilaa, istumapaikan numeroa, lukumäärää tai hintaa. Siksi on tärkeää kuvata luku 37 yksiselitteisesti.
Tietomalli selventää, mitä tietokenttiä ohjelmointirajapinnassa on, mitä ne tarkoittavat ja miten ne liittyvät toisiinsa.
Tämä semanttinen yhteentoimivuus on tärkeää sekä organisaation sisällä eri tietojärjestelmien välillä että laajemmin.