Sosiaalihuollon asiakastietojen mallintamisopas



Samankaltaiset tiedostot
Sosiaalihuollon asiakasasiakirjojen tietomallinnus Tietomallit teknisen asiakirjamäärittelyn näkökulmasta

Sanastotyö luokittelun tukena Tikesos-hankkeessa. NordTERM 2011 Antero Lehmuskoski ja Maarit Laaksonen

Sosiaalihuollon asiakasasiakirjojen näyttömuodot

Sosiaalihuollon asiakasasiakirjarakenteet

Korkeakoulujen yhteentoimivuusmalli

Sosiaalihuollon asiakasasiakirjarakenteet

XHTML+RDFa-standardin soveltuvuus osaksi sosiaalihuollon asiakirjastandardia

Yhteentoimivuutta edistävien työkalujen kehittäminen

Sosiaalihuollon avoin asiakastietomalli ja sen kehittämisessä ja soveltamisessa käytetyt standardit

ASIAKIRJARAKENTEIDEN SEMANTTINEN MAL- LINTAMINEN JA VALIDOINTI XHTML+RDFA - RAKENTEISTA CASE SOSIAALIHUOLTO

Sosiaalihuollon asiakasasiakirjojen standardointi

Sosiaalihuollon kokonaisarkkitehtuuri

Sosiaalihuollon asiakastiedon arkisto Sosiaalihuollon metatietomalli Metatietoesimerkit

Sosiaalihuollon asiakirjastandardi kehittyy. Konstantin Hyppönen Erikoissuunnittelija Tietojenkäsittelytieteen laitos Kuopion yliopisto

Modulaariset tietosisältömäärittelyt Tilannekatsaus

Yhteentoimivuusalusta: Miten saadaan ihmiset ja koneet ymmärtämään toisiaan paremmin?

SOSIAALIHUOLLON ASIAKASTIETOMALLI. Erja Ailio Kehittämispäällikkö

Miika Alonen Paula Leinonen Virpi Hotti Tommi Ahonen Heli Lintula

Sosiaalihuollon asiakastietomallin hallinta

Sosiaalihuollon asiakastiedon arkisto Sosiaalihuollon metatietomalli Metatietoesimerkit

Luonnos eams-rakenteeksi

Tietojen jakelu Skeemat Palvelupyyntö Kansallisen tulorekisterin perustamishanke

Tietojen toimittaminen Skeemat Käsittelypalautteen kysely Kansallisen tulorekisterin perustamishanke

Määrämuotoinen kirjaaminen sosiaalihuollon arjessa

Sanastotyö THL:SSÄ Sanastotyö THL:ssä / Outi Meriläinen 1

Tämä dokumentti on tarkoitettu uudistettavan JHS179-suosituksen tietoarkkitehtuuriosion liitteeksi.

Tekijän nimi

Sosiaalihuollon tieto- ja toimintamäärittelyjen julkaisut 2018 Erja Ailio, Niina Häkälä, Antero Lehmuskoski, Jaakko Penttinen, Marko Suhonen

Liite 7: Asiakastietoa käsittelevä järjestelmä Sosiaalihuollon asiakastiedon arkisto. Rajapintakäyttötapaukset

JHS 179 Kokonaisarkkitehtuurin suunnittelu ja kehittäminen Liite 8. Semanttisen yhteentoimivuuden viitekehys

Asiakastyön dokumentoinnin tavoitetila. Maarit Laaksonen projektipäällikkö Terveyden ja hyvinvoinnin laitos Kuntamarkkinat 14.9.

Yhteentoimiva.suomi.fi - palvelukokonaisuuden ja työkalujen esittely

Synergiaryhmän työpaja tietoarkkitehtuuri ja yhteentoimivuus

JHS 183 Julkisen hallinnon palvelujen tietomalli ja ryhmittely verkkopalveluissa Liite 3 XML-skeeman kuvaus ja esimerkit

KOHTI YHTENÄISTÄ ASIAKASTIETOA

Tietojen jakelu Skeemat Palvelupyyntö Kansallisen tulorekisterin perustamishanke

Yhteentoimivuusvälineistö

Tietokantojen suunnittelu, relaatiokantojen perusteita

Sosiaali- ja terveydenhuollon tietomallien kansalliset määrittelyt yleiskuva

Liite D: Poikkeamispäätösten ja suunnittelutarveratkaisujen mallinnus tiedonsiirtoa varten

- Korkeakoulutuksen ja tutkimuksen (linkitetty) tietomalli

Kansa-hanke Liittyminen sosiaalihuollon Kantapalveluihin. Pohjois-Suomen sosiaalihuollon tiedonhallinnan kuntatyöpaja Maarit Rötsä, THL/OPER

Paikkatiedot ja Web-standardit

JHS 179 Kokonaisarkkitehtuurin suunnittelu ja kehittäminen Liite 7. Semanttisen yhteentoimivuuden menetelmäohje

Tietojen toimittaminen Skeemat Käsittelypalautteen kysely Kansallisen tulorekisterin perustamishanke

Liite B. Asemakaavan mallinnus tiedonsiirtoa varten

Paikkatietojen tietotuotemäärittely

Luento 12: XML ja metatieto

Kehitysvammalain muutokseen liittyvät asiakasasiakirjarakenteet. Itsemääräämisoikeus ja asiakasasiakirjat Niina Häkälä

Kansa-hankkeen II vaiheen määrittelyjen lausuntokierros 03/2019

Tietojen toimittaminen Skeemat Viestit Kansallisen tulorekisterin perustamishanke

Ohjeistus sosiaalihuollon sähköiseen arkistoon liittyvälle järjestelmälle

Katsaus tietoarkkitehtuurityöhön

Sosiaalialan tiedonhallinta

Paikkatietojen tietotuotemäärittely

ETAPPI ry JOOMLA 2.5 Mediapaja. Artikkeleiden hallinta ja julkaisu

OMAISHOIDON TUEN SUUNNITELMAN ASIAKASASIAKIRJARAKENTEET

Sosiaalihuoltolain mukaisten palvelujen toimintaprosessit

Konstantin Hyppönen, FT Terveydenhuollon ATK-päivät Mitä ovat Tikesos-lopputuotteet?

Paikkatietotuotteen määrittely

Sosiaalialan tietoteknologian valtakunnallinen kehittäminen vuoteen 2011 ( Projektipäällikkö Heli Sahala

Toiminnalliset ja ei-toiminnalliset vaatimukset Tunnus (ID) Vaatimus Vaatimuksen

Tietojen toimittaminen Skeemat Vastaanottokuittaus Kansallisen tulorekisterin perustamishanke

SÄHKE-hanke. Abstrakti mallintaminen Tietomallin (graafi) lukuohje

Tietojen toimittaminen Skeemat Mitätöintitiedot Kansallisen tulorekisterin perustamishanke

Kanta Sosiaalihuollon asiakastiedon arkisto Sosiaalihuollon asiakirjastandardi HL7 Finland ry:n alustavasti hyväksymä versio

Määräys käyttöoikeuksien määrittelyn perusteista sosiaalihuollon asiakastietoihin

Yhteentoimivuutta edistävien työkalujen kehittäminen - JulkICTLab pilottiehdotus

Julkishallinnon XML-skeemat v0.5 JHS-suositus

LUONNOS Määräys sosiaalihuollon palvelutehtävien luokituksesta Valtuutussäännökset Kohderyhmät Voimassaoloaika Liitteet

Kohti aidosti palvelevaa hallintoa yhteinen metatietoarkkitehtuuri yhteentoimivuuden kulmakivenä

SÄHKE-hanke. Tekninen mallintamisen Siirtotiedoston metatietokuvaukset

Sosiaalihuollon asiakastiedon arkisto Sosiaalihuollon asiakirjastandardi

Tekninen rajapinta Zip-tiedosto sovelluskehittäjälle Kansallisen tulorekisterin perustamishanke

W3C-teknologiat ja yhteensopivuus

Semanttinen Web. Ossi Nykänen. Tampereen teknillinen yliopisto (TTY), Digitaalisen median instituutti (DMI), Hypermedialaboratorio W3C Suomen toimisto

Suvi Remes Miika Alonen Petri Mustajoki Totti Tuhkanen

T2V2 Turvallisuushavaintoilmoitussanomakuvaus

JHS 109 Huoneiston tunniste

Nykytilan kartoituksen työkalu

Kotipalvelujen toimintaprosessit

Projektin tilannekatsaus

Asiakastietoa käsittelevä järjestelmä. Rajapintakäyttötapaukset

Liite A. Kantakartan mallinnus tiedonsiirtoa varten

Tekninen rajapinta Zip-tiedosto sovelluskehittäjälle Kansallisen tulorekisterin perustamishanke

Kanta. Sosiaalihuollon asiakirjastandardi

Kuntien yhteentoimivuusseminaari. Tietomallien laatiminen Taina Nurmela projektipäällikkö, Helsingin kaupunki

Paikkatietotuotteet ja niiden määrittely

Asiakastietoa käsittelevä järjestelmä. Rajapintakäyttötapaukset

Paikkatiedon mallinnus Dokumentoinnin ymmärtäminen. Lassi Lehto

SÄHKE2-SERTIFIOINTIKRITEERIT

Metatiedot organisaatioiden sisällönhallinnassa

Liite 3 INDEKSOINTI. 1. Digitoitavat kirjatyypit

Procountor laskutusliittymä

Avoimen ja yhteisen rajapinnan hallintasuunnitelma v.1.4

Avoimen ja yhteisen rajapinnan hallintamalli

Asiakaslähtöiset ja vaikuttavat sosiaalipalvelut

Sosiaalihuollon toimintaprosessien mallinnus. Päivi Röppänen Terveydenhuollon Atk-päivät Jyväskylä

RINNAKKAISTALLENNUSOHJE

ELMAS 4 Laitteiden kriittisyysluokittelu /10. Ramentor Oy ELMAS 4. Laitteiden kriittisyysluokittelu. Versio 1.0

Transkriptio:

Sosiaalihuollonasiakastietojen mallintamisopas Tietokomponenttienjaasiakasasiakirjojen mallinnusohjeet 7.11.2011 KonstantinHyppönen MiikaAlonen MiikaHeikkinen VirpiHotti JaanaNevalainen PaulaLeinonen

Versio Päiväys Muutoksensisältö Tekijät 0.1 23.9.2011 Rakenneuusiksi,sisältöätarkennettu MA 0.10 29.8.2011 muutosmäärittelyt MH,PL 0.11 30.8.2011 rajoittaminen MH 0.12 31.8.2011 johdantojaprosessi MH 0.13 2.9.2011 muotoiluajakorjailua MH,PL 0.14 7.9.2011 sisällönlisääminen MH,KH,JN 0.15 8.9.2011 viitteet,taulukoidenkorjaus MH 0.16 12.9.2011 sisällönlisääminen,täydentäminenjamuotoilu MH,VH,KH 0.17 23.9.2011 sisällön täydentäminen teknisillä yksityiskohdilla, sekä dokumentinrakenteenmuutos MA,KH 0.18 26.7.2011 sisällöntäydentämistä MA 0.19 27.9.2011 sisällöntäydentämistä MA 0.2 28.9.2011 sisällöntäydentäminen,nimiavaruus-japrefix-asiat MA 0.3 1.10.2011 sisällöntarkistaminenjamuutosehdotukset VH 0.4 4.10.2011 sisällönkorjausta JN 0.5 5.10.2011 sisällönkorjausta JN 0.9 6.10.2011 sisällönviimeistely JN,KH,VH 0.91 7.10.2011 muutosmäärittelylomakkeitasisältäväliitepois AE,KH 1.0 7.11.2011 Korjauksiamuutosehdotuksienpohjalta.Hyväksyttyversio. MA SOSIAALIALANTIETOTEKNOLOGIAHANKE SOSIAALI-JATERVEYSMINISTERIÖ Suomenkuntaliitto Terveydenjahyvinvoinninlaitos Itä-Suomensosiaalialanosaamiskeskus Itä-SuomenYliopisto

Sisällys 1 Johdanto...4 2 Tietokomponenttienmallintaminen...6 2.1 Tietokomponenttienkuvailutiedot...6 2.2 TietokomponenttikirjastonmuodostaminenCCTS-spesifikaatiotasoveltamalla...9 3 Asiakirjojenmallintaminen...16 3.1 Sisällöllistenasiakirjarakenteidenkuvailutiedot...16 3.2 Sisällöllisenasiakirjarakenteenmuodostaminen...17 3.3 Roolit...21 3.4 Roolitjatietokomponentit...23 3.5 Roolientoteutusasiakirjoissa...25 3.6 Teknisenasiakirjarakenteenmuodostaminen...26 A. TietokomponenttikirjastonCCTSXML-skeema...31 B. EsimerkkiCCTSXML-muodosta...32 C. XSLT-muunnostiedostoCCTSXMLCCTSRDF...33 D. EsimerkkiCCTS-ontologianmukaisestRDF-tietomallista...37 E. AsiakirjarakennekirjastonCCTSXML-skeema...40 F. EsimerkkiasiakirjarakennekirjastostaCCTSXML-muodossa...41 G. TeknisenasiakirjarakenteenXSLT-muunnostiedosto...42 H. Toimeentulotukihakemuksensisällöllinenasiakirjarakennetaulukko...46

1 Johdanto Sosiaalihuollossa asiakastiedoilla tarkoitetaan asiakkaista tallennettavia asiakirjallisia tietoja, joissa on asiakkaidenhenkilötietojenlisäksitietoamyösasiakkaidenläheisistäsekäsosiaalihuollonammattihenkilöistä.asiakastiedoissaonmyöstietoaasiakastakoskevistahallintoasioista,asiakkailletuotettavistapalveluistajaasiakkaidensaamistasosiaalietuuksista.sosiaalialantietoteknologiahankkeessa(tikesos)onmallinnettusosiaalihuollonpalvelutehtäviinliittyvienasiakastietojenyhtenäinenkäsitteellinensisältöjatietojen väliset keskinäiset suhteet. Sosiaalihuollon asiakasasiakirjat ja niissä käytettävät tietorakenteet on kuvattusosiaalihuollonasiakastietomallissa. Sosiaalihuollon asiakastietomalli koostuu tietokomponenttikirjastosta ja asiakirjakohtaisista rakenteista (Kuva 1). Tietokomponentit ovat semanttisia tietokokonaisuuksia, joita käytetään asiakirjallisen sisällön rakenteistamisessa.sosiaalihuollonasiakastietomallissatietokomponentitedustavatreaalimaailmanilmiöitä, jotka esiintyvät sosiaalihuollon asiakasasiakirjoissa. Asiakirjat on mallinnettu palvelutehtävittäin. Asiakirjojenrakenteissakäytetäänsekäyleiskäyttöisiätietokomponenttejaettäasiakirjakohtaisiakenttiä. Asiakastietomallissa on tällä hetkellä 241 asiakirjaa ja 148 tietokomponenttia. Asiakastietomallista on tehtyhankkeessauseitaesitysmuotojakutentaulukkomuoto,tekninenrdf-tietomalli,html-sivutjagraafinentietomalli. Kuva1:YleiskuvausSosiaalihuollonasiakastietomallista

SosiaalihuollonasiakastietomallinmuodostamiseenonsovellettukansainvälistäCoreComponentTechnical Specification 1 (CCTS) -menetelmää. CCTS-menetelmää sovelletaan tietokomponenttien ja asiakirjojen mallintamiseen. Tietorakenteiden nimeämisessä on sovellettu Julkishallinnon XML-skeemat -suositusta (JHS170) 2 Tämädokumenttiontarkoitettuniille,jotkahaluavatmallintaatietokomponenttejajaasiakirjarakenteita. Dokumenttiantaaohjeistuksensekäsosiaalihuollonasiantuntijoille,ettäteknisilleasiantuntijoille.Dokumentissa annetaan tarkempia tietomallinnukseen liittyviä ohjeita, joita käytetään tietokomponenttien ja asiakirjarakenteidenmallintamisessa.asiakastietomallinkehityksessäjaylläpidossakäytettävätprosessit onkuvattutietomääritystenhallintamallissa 3 Dokumentti koostuu kahdesta luvusta. Luvussa annetaan tietokomponenttien mallinnukseen liittyviä ohjeita sekä kuvataan tietokomponenttikirjaston rakennetta ja CCTS-menetelmän vaikutusta tietokomponentteihin.lukusisältääohjeetsisällöllistenasiakirjarakenteidenmuodostamiseen.luvussaonkuvattumyösteknisetasiakirjarakenteet. 1UnitedNations,CentreforTradeFacilitationandElectronicBusiness.CoreComponentsTechnicalSpecification.Version3.0. http://www.unece.org/cefact/codesfortrade/ccts/ccts-version3.pdf 2JHS170JulkishallinnonXML-skeemat.http://docs.jhs-suositukset.fi/jhs-suositukset/JHS170/JHS170.html 3KonstantinHyppönen,JaanaNevalainen,MiikaAlonen,PaulaLeinonen,VirpiHotti.Sosiaalihuollontietomääritystenhallintamalli:Hallintaprosessitja linjausehdotukset.sosiaalialantietoteknologiahanke. http://www.sosiaaliportti.fi/file/da6fb554-d408-4a7a-a215-3f91c0bb9931/sosiaalihuollon+tietom%c3%a4%c3%a4ritysten+hallintamalli.pdf

2 Tietokomponenttienmallintaminen TämädokumenttipäivittääaiemminjulkaistuadokumenttiaSosiaalihuollonasiakastietojenja-asiakirjojen tietomallinnus 4 Tietokomponentin mallintaminen alkaa siitä, että on tunnistettu joukko semanttisesti yhteenkuuluvia tietoja, joita asiakastietomallissa ei vielä esiinny. Kun uuden tietokomponentin tarve on tunnistettu,aloitetaantietojenanalysointi,mallintaminensekäyhtenäistämistyö.tietokomponentinanalysoinnintehtävänäontunnistaajamääritellätietokomponentinkaikkitarvittavatominaisuudetniin,että nemuodostavatloogisenkokonaisuuden.tietokomponentintietosisältöäanalysoidessavoidaantullasiihen johtopäätökseen, että 1) tietokomponentti jakaantuu kahdeksi tai useammaksi uudeksi tietokomponentiksitai2)todetaantarvesiirtääyksitaiuseampikenttämuihintietokomponentteihin. Tietokomponentit mallinnetaan analysoitujen tietokokonaisuuksien pohjalta ja määritellään loogisesti yhteen kuuluville tiedoille esitysmuodot. Luokille ja kentille luonnostellaan määritelmät sekä halutessa esimerkitjaselitteet.kuvassaonesimerkkinäosatyö-komponentista. Komponentin tyyppi Komponentin nimi Tiedon esitysmuoto Määritelmä Huomautukset Esimerkki Luokka Työ toiminta, jonka tarkoituksena on saavuttaa tietty hyödyllisenä pidetty tulos kenttä Työsuhde TK Työsuhde työnantajan ja työntekijän välinen oikeussuhde, joka syntyy työsopimuksen tekemisellä kenttä Arviointitiedot Teksti tiedot, joissa arvioidaan henkilön tekemää työtä, työtilannetta, työllistymismahdollisuuksia tai työnhakuvalmiuksia kenttä Lähitulevaisuuden muutos Teksti kuvaus tiedossa olevasta työhön liittyvästä muutoksesta Lähitulevaisuuden muutos voi tarkoittaa esimerkiksi sitä, että työt loppuvat tiettynä ajankohtana. seuraavan kuukauden aika paremmat työllistymismah kun asiakas on saanut tod suoritetusta kielikurssista 12.5.2011 tämän hetkinen määräaikainen työsuhde lo kenttä Aiempi työala Teksti kuvaus ammattialasta tai -aloista, joilla henkilö on työskennellyt Kuva2:OsaTyö-komponentista Aiempi työala voi olla esimerkiksi kauneuden- tai terveydenhoitoala. terveydenhoitoala 2.1 Tietokomponenttienkuvailutiedot Tietokomponentit mallinnetaan määrittelemällä tietokomponenttitaulukon sarakkeisiin kuvailutietoja (metatietoja), jotka kuvaavat tietokomponenttien ominaisuuksia. Kuvailutiedot perustuvat CCTSspesifikaatioon ja JulkishallinnonXML-skeemat -suositukseen (JHS 170). JHS 170 pohjautuu kansainväliseeniso/iec11179-5-standardiin.standardiaonsovellettumyösccts-menetelmässä.jhs170käyttää kolmitasoistanimeämismallia(objektiluokka,ominaisuustermijailmentymätermi),jokaperustuuiso/iec 11179-5-standardiin. 4 Sosiaalihuollon asiakastietojen ja -asiakirjojen tietomallinnus (http://www.sosiaaliportti.fi/file/fd06b2f6-8a2a-4e83-9791- 94de48b3260d/Sosiaalihuollon+asiakastietojen+ja+-asiakirjojen+tietomallinnus.pdf

Tietokomponenteillakuvataanreaalimaailmanilmiöitäkutenyksityishenkilö,organisaatio,tulo,osoiteja yritys,joistamuodostetaanobjektiluokkia.objektiluokillemääritelläänominaisuuksia,jotkavoivatperustuayksinkertaisiintietotyyppeihin(ts.ilmentymiin)taimuihinobjektiluokkiin.tietokomponenttikirjasto muodostaamyöstietomallin,koskaobjektiluokkiinperustuvatominaisuudetluovatassosiaatiosuhteitaeri objektiluokkienvälille.kuvassaonesimerkkitulo-objektiluokanassosiaatiosuhteista. Kuva3.EsimerkkiTulo-objektiluokanassosiaatiosuhteet Sosiaalihuollon asiakastietomallissa objektiluokkatermit ja ominaisuustermit muodostetaan komponenttiennimistäjailmentymätermittietojenesitysmuodoista.jhs170mukaanjos ominaisuusterminlopussa olevasanaonsamakuinilmentymä,voidaanpäällekkäinensanapoistaa.tätäkäytäntöäsovelletaansosiaalihuollonasiakastietomallinmukaisissateknisissärakenteissa. CCTS-spesifikaationmukaisillakuvailutiedoillatarkennetaantietokomponenttienominaisuuksia,kuntietokomponenteistamuodostetaanteknisetesitysmuodot.Tietokomponentitmallinnetaankäyttämälläseuraaviayleisiäkuvailutietoja: - Komponentinnimi Komponentin nimi on lyhyt merkkijono, joka kuvaa hyvin tietokomponentin tietosisältöä.komponentinnimituleeollaensisijaisestisuomenkielinenjalähtökohtaisestiyksikkömuodossa,elleikäsiteitsessäänolemonikkomuotoinen.komponenttiennimettuleeollayksilöllisiäelisamannimisiäluokkiatailuokankenttiäeisaaasiakastietomallissaesiintyä. - Komponentintyyppi.Komponentinnimionjokoluokkataikenttä.Luokkamuodostuuyhdestätai useammastakentästä.kenttävoimyösperustuajohonkintoiseenluokkaan. - Tiedonesitysmuoto Tiedon esitysmuotoa käytetään vain, jos kyseessä on kenttä. Tiedon esitysmuoto on joko yksinkertainen tietotyyppi tai luokkaviittaus. Luokkaviittauksilla muodostetaan suhteitaaiemminmääriteltyihintietokomponentteihin,jollointiedonesitysmuodoksimääritellään TK tietokomponentintekninennimi.esimerkiksikirjanpitäjä-komponentti(kuva4),jossayhteystiedot-kentänesitysmuotonaontk Yhteystiedot-komponentti.

Komponentin Komponentin Tiedon esitysmuoto Määritelmä Huomautukset tyyppi nimi Luokka Kirjanpitäjä henkilö tai yritys, joka huolehtii yksityishenkilön tai organisaation menojen, tulojen ja rahoitustapahtumien järjestelmällisestä kirjaamisesta kenttä Nimi Nimi kirjanpitäjänä toimivan henkilön tai yhteisön nimitys Henkilönnimeen viitattaessa nimi tarkoittaa etunimen ja sukunimen yhdistelmää, kuten Matti Esimerkki. Yhteisöä kuvaavaan tietokomponenttiin liitettynä nimi viittaa kyseisen yhteisön nimitykseen. kenttä Yhteystiedot TK Yhteystiedot yhteydenottoa varten tarvittavat tiedot kenttä Yhteydenottolupa Kytkin yrittäjän antama lupa ottaa yhteyttä tämän kirjanpitäjään Kuva4:OsaKirjanpitäjä-tietokomponentista - YksinkertaisettietotyypitmääritelläänJHS170mukaisesti: o o o o o o o o o o o o o o o o o AikaKellonaika,ajankohta ArvoNumeerinenarvo.Tikesos-komponenttimäärityksissäarvoeiolekäytössä. BinaariBinäärimuotoinentieto.Tikesos-komponenttimäärityksissäbinäärieiolekäytössä. Koodi.Sallittujenarvojenluettelo,jonkajokainenyksittäinenarvoonmerkkijono,jota käytetäänkorvaamaantaiedustamaantiettyäkoodatuntiedonarvoataimääritelmää Kuva.Kuvientallennustyyppi.Tikesos-komponenttimäärityksissäkuvaeiolekäytössä. KytkinKahdestaarvostakoostuvapari(boolean,kyllä/ei) LkmMuidenkuinrahayksikköjenlukumäärä MittaNumeerinenarvo,jokaonmääriteltymittaamallajokinobjekti.Mittatarkennetaan mittayksiköllä.tikesos-komponenttimäärityksissämittaeiolekäytössä. MaaraRahallinenarvovaluuttayksikköinä NimiJonkinobjektinidentifiointiinkäytettävämerkkijono.Toisinkuintunnuksen,nimen eitarvitseollayksiselitteinen. NumeroNumero ProsenttiProsenttilukunaesitettävänumeroarvo PvmPäiväkalenterissa,ajankohta(ISO8601 5 HetkiPäiväkalenterissajakellonaika,ajankohta(ISO8601) SuhdeSuhdenumeerisenaarvona.Tikesos-komponenttimäärityksissäsuhdeeiolekäytössä. TekstiJonkinluonnollisenkielenmerkkijono TunnusMerkkijono,jotakäytetäänmuodostamaanjollekinobjektinesiintymälleidentiteettitaierottamaansemuistayksiselitteisellätavalla - Määritelmä.Kuvaa tietokomponentin tai kentän käyttötarkoituksen. Tämä on yksi tärkeimmistä kuvailutiedoista. - HuomautusSisältäätietokomponentintaikentänkäyttöohjeentaitarkentaasenmääritelmää. - EsimerkkiSisältääesimerkkiarvonkentänsisällöstä. - Koodisto.Kuvailutietoakäytetäänniidenkenttienosalta,joidentiedonesitysmuotoonkoodi.Sesisältääviittauksenkäytettäväänkoodistoon,taijoskoodistononriittävänlyhyt,kokokoodiston. - Kentäntoistuvuusjakentänpakollisuus.Toistuvuudellatarkoitetaansitä,ettäkentällevoidaanantaauseitaarvoja.Pakollinenkenttäedellyttää,ettäkentällemääritelläänarvo.Toistuvuusjapakollisuuskuvataantiedoillakyllätaiei. - Asiakirjalähde,päivämäärä,muutokset,versio,vastuuhenkilöjakommentti kuvaavat tietokomponenttityönkulkua,eityönlopputulosta. 5http://dotat.at/tmp/ISO_8601-2004_E.pdf

jhs - NimiavaruusNimiavaruuskertoomissämuuallakenttäonmääritelty,esimerkiksiJHS175määritteleekentänEtunimetNimijolloinetunimetkenttäämääriteltäessänimiavaruudeksilaitetaan JHS170mukaannimettulisijohtaasanastonkäsitteistäjaelementtiennimienpitäisiollasamojakuinvastaavien käsitteiden nimet sanastossa. Suosituksessa, joka kuvaa julkisen hallinnon sanastotyöprosessin (JHS 175 6 ), muodostetaan muun muassa teknisissä rakenteissa käytettäviä termejä. Osa Tikesoshankkeessamääritellyistätermeistäjamääritelmistäonjovietyjulkishallinnonsanastotyöprosessiin.Yhteistyötä ydinsanastoryhmän kanssa tulee jatkaamyöshankkeen jälkeen, koska näin voidaan päästä parempaansemanttiseenyhteentoimivuuteenmuidenjulkishallinnonorganisaatioidenkanssa. 2.2 TietokomponenttikirjastonmuodostaminenCCTS-spesifikaatiotasoveltamalla SosiaalihuollonasiakastietomallintekninentoteutusperustuuCCTS-menetelmässämääriteltyihinkäsitteisiin ja siitä muodostettuun RDF-tietomalliin. CCTS-mallissa käsitteet jaetaan kahteen kategoriaan: ydinkomponentteihin (Core Components, CC) ja niihin pohjautuviin toimialakohtaisiin komponentteihin (BusinessInformationEntity,BIE).Toimialakohtaisetkomponentitonsidottu johonkinkontekstiin.sosiaalihuoltoontoimiala,muttasosiaalihuoltosisältäämyösuseitaeripalvelutehtäviä,joissatietoakäytetääneri kontekstissa. Tietokomponenttikirjastomuodostuutietokomponenteista(AggregateCoreComponent,ACC).TietokomponenttienjaniidenkenttienvälisetsuhteetCCTS-mallinmukaisestionesitettykuvassa5. Tietokomponentti (ACC) On osana Assosiaatiotietokomponentti (ASCC) On osana Peruskomponentti (BCC) Määrittelee arvoalueen Viitattu tietokomponentti (ACC) Määrittelee arvoalueen Core Data Type Kuva5:ToimialakohtaistenkomponenttiensuhteetCCTS-mallissa Kuvassaonmääriteltysuhteetseuraavillekomponenttityypeille: - Tietokomponentti.(AggregateCoreComponent,ACC)vastaatietokomponenttitaulukossamääriteltyäluokkaa. - Peruskomponentti (Basic Core Component, BCC) vastaa tietokomponenttitaulukossa määriteltyä yksinkertaiseentietotyyppiinperustuvaakenttää. - Assosiaatiokomponentti(AssociationCoreComponent,ASCC)vastaatietokomponenttitaulukossa määriteltyämuuhunacc-objektiluokkaanperustuvaakenttää. 6http://docs.jhs-suositukset.fi/jhs-suositukset/JHS175/JHS175.html

Tietokomponenttikirjastomuodostetaantaulukosta,jossaonkuvattutietokomponenttejayleisilläkuvailutiedoilla.YleistenkuvailutietojenperusteellavoidaanmuodostaaCCTS-spesifikaationmukaisetkuvailutiedot automaattisesti. Taulukot muunnetaan CCTS-rakenteita kuvaaviksi XML-tiedostoiksi. CCTS XML - muotoavastaavaskeemaonkuvattuliitteessäa. YleisissäkuvailutiedoissamääritellystäkomponentinnimestämuodostetaanJHS170mukainentekninen nimi.jhs170mukaisestimääriteltynimeämisohjeistusasettaaseuraaviinasioihinliittyvätsäännötjarajoitteet: - yleiseennimeämiseen - elementtiennimeämiseen - attribuuttiennimeämiseen - tyyppiennimeämiseen - yleisiinkäytettäviinlyhenteisiinja - ilmentymätermeihin. Sosiaalihuollonasiakastietomallissanimeämisohjeistustasovelletaansilloin,kunmuodostetaantietokomponenttikirjastosta ja sisällöllisistä asiakirjarakenteista teknisiä rakenteita. Sosiaalihuollon tietokomponenttikirjastossa ja asiakirjarakenteissa kentät ja tietokomponentit pyritään nimeämään siten, että ne olisivatmahdollisimmanlyhyitäjaselkeitä.nimentulisimahdollisimmantarkastikuvatatietokomponentintaikentänsemanttistamerkitystäsilloin,kunnimisiirretääntekniseenrakenteeseen,nimestäpoistetaanskandinaavisetmerkit,alaviivat,pisteet,väliviivatjamuutaakkostenulkopuolistenmerkit.nimessä olevatsanatyhdistetäänjasanojenalkukirjaimetkirjoitetaanisollakirjaimella(uppercamelcase-tyyli). EsimerkiksikuvassaesitetyntietokomponentinAmmattihenkilomuodostavatkentätnimetäänseuraavasti: SukuNimi, EtunimetNimi TehtavanimikeTeksti Organisaatio Yhteystiedot HenkiloTunnus, RekisterointiTunnus Kuva6:Ammattihenkilö-tietokomponentti Teknistä nimeä käytetään silloin, kun tietokomponentit ja kentät kuvataan CCTS XML -muodossa. EsimerkkiCCTSXML-muodostaonliitteessäB.CCTSXML-elementtejämuodostetaanjokaisestakomponentista niiltä osin kuin tiedot on määritelty taulukossa. Tietokomponenttikirjasto kuvataan seuraavien elementtienavulla: - DictionaryEntryName.Muodostetaanluokanjakenttienteknisistänimistäsekäilmentymätermistä tai assosiaatiokomponentin teknisestä nimestä. Esimerkiksi kuvassa esitetyn luokan Dictic- 10

tionaryentryname on Ammattihenkilo Sukunimi-kentän Ammattihenkilo.Sukunimi. NimijaYhteystiedot-kentänAmmattihenkilo.Yhteystiedot.Yhteystiedot. - EntryType.Määritteleetietokomponentintyypin.LuokkaonACCjakenttäBCCtaiASCC,joskentälläviitataantoiseentietokomponenttiin. - ObjectClassTerm.Komponentin nimestä on muodostettu luokan tekninen nimi. Jos komponentin tyyppionkenttä,viitataanviimeksimääriteltyynluokantekniseennimeen. - PropertyTerm.Komponentin nimestä muodostettu kentän tekninen nimi, kun kentän tyyppi on kenttä. - RepresentationTerm.TiedonesitysmuotoJHS170mukaan. - AssociatedObjectClassTerm.Tiedonesitysmuoto,jostaonpoistettuTKkunkentässäviitataantoiseentietokomponenttiin. - MinOccurrence.Mikäli yleisissä kuvailutiedoissa kentän pakollisuus tietokomponenttitaulukossa on"ei",niinminimimääräksitulee0,jamuuten1. - MaxOccurrence Mikäli yleisissä kuvailutiedoissa kenttä on määritelty toistuvaksi, maksimimääräksituleeunbounded jamuissatapauksissa1. - Definition.Määritelmä,jokaonyleisissäkuvailutiedoissakuvattu. - ExampleEsimerkki,jokaonyleisissäkuvailutiedoissamääritelty. - CommentKommentti,jokaonyleisissäkuvailutiedoissamääritelty. - UsageRules.Huomautus,jokayleisissäkuvailutiedoissaonmääritelty. - DomainLuokanlähde,jokayleisissäkuvailutiedoissaonmääritelty. - Group.Luokanasiakirja,jokayleisissäkuvailutiedoissaonmääritelty. KuntietokomponenttitaulukostaonmuodostettuCCTSXML-muoto(LiiteB),semuutetaanRDF-muotoon XSLT-muunnoksella(LiiteC).TietokomponenttikirjastonRDF-muoto(LiiteD)onkuvattuCCTS-ontologian avulla (Kuva 7). Tietokomponentit mallinnetaan CCTS-ontologiassa määriteltyjen luokkien mukaisesti. Tietokomponenttikirjastossa olevat tietokomponentit ja niiden kentät mallinnetaanccts:cc-luokan aliluokiksi(ccts:accccts:bccccts:ascc). Tietokomponentteihin voidaan viitata muiden tietokomponenttien kentistä. Tällöin viitattavasta tietokomponentistamuodostetaanominaisuus(ccts-termeissäasccproperty),jokavoidaanliittääuseaaneri tietokomponenttiin. Esimerkiksi jos tietokomponenttiayhteystiedot hyödynnetään usean eri tietokomponentin kentissä, siitä muodostetaan uudelleen käytettävä ominaisuus, joka liitetään näihin tietokomponentteihin. Näin sitä voidaan käyttää useassa eri ASCC-kentässä. Tällaiset uudelleenkäytettävät ominaisuudetmallinnetaanccts:asccproperty-luokanavulla.samallatavallakäsitelläänmyösyksinkertaisiin tietotyyppeihin perustuvia kenttiä. Esimerkiksi kentästäkuvausteksti muodostetaan BCC Property -ominaisuus, joka voidaan liittää useaan eri ACC-tietokomponenttiin. Tietokentät kuvataan ccts:bccproperty-luokalla.uudelleenkäytettävienominaisuuksienluokatonesitettykuvassa8.tietokomponenttien kenttien järjestys kuvataanccts:hasnext-viittauksien avulla (Kuva 9). Kenttien järjestykselläonmerkitystäkunasiakastietomallistamuodostetaangraafisiatietomallejataixml-skeemoja. 11

Kuva7:CCTS-ontologianmäärittelemättietokomponenttiluokat 12

Kuva8:CCTS-ominaisuuksienluokkamääritelmät Kuva9:Tietokomponenttienjärjestys Tietokomponenttien sisältämät kentät ja assosiaatiot muihin luokkiin mallinnetaan OWL-rajoituksina. Assosiaatiot ja tietokentät muodostavat uudelleenkäytettäviä predikaatteja, jotka toimivat kuten CCTSspesifikaatiossamääritellytassosiaatio-jaominaisuustermit.Predikaattienavullamääritelläänaksioomia 13

tietokomponenttikirjastossamääriteltyihinluokkiin,joidenavullakuvataantoistuvuuksiajapakollisuuksia (Kuva10). Kuva10:Tietokomponenttienrajoituksetaksioomienavulla BCC-komponenttien arvoalueet määritellään predikaateissa rdfs:range-viittauksen avulla ja ASCCkomponenttien viittaukset muihin tietokomponentteihin määritelläänowl:restriction-rajoitteissa owl:onclass-viittauksenavulla(kuva11). Kuva11:Arvoalueidenviittaukset XHTML+RDFa-asiakirjoissakäytetäänkuvailutietoja,jotkavastaavatCCTS-spesifikaationmukaisiauudelleenkäytettäviä ominaisuuksia BCC Property, ASCCProperty, BBIE Property ja ASBIEProperty (Kuva 8). XHTML+RDFa-asiakirjanmuodostajaviittaaasiakirjanrakenteestanäihinominaisuuksiin,eikähänentarvitsetietää,mitentietokomponenttienhallintaRDF-tietomallillaontoteutettu.CCTS-ontologianmukaisilla tietokomponenttiluokillamuodostetaanjahallitaantietokomponentit.ominaisuuksillaviitataantietokomponenttiluokillamääriteltyihintietokomponentteihinjaniidenkenttiin. 14

RDF-muotoinen tietokomponenttikirjasto muodostaa sosiaalihuollon asiakastietomallin perustan, jonka pohjaltasosiaalihuollonasiakasasiakirjatmuodostetaan.rdf-muotoinentietomallivoidaantallentaardftietokantaanjasitävoidaanmuokatardf-editoreidenavulla.teknistenesitysmuotojenmuodostaminenja ylläpito edellyttää mallintamismenetelmien ja semanttisten teknologioiden, kuten CCTS-menetelmän ja RDF-tietomallinuksen,osaamista. http://sosmeta.fi/tietokomponentit/2011/09/28/sos# JokaiselletietokomponentillejaominaisuudellemuodostetaanRDF-tietomallissayksilöllinenURI-tunniste. TietokomponenttienURI-tunnisteetmuodostetaanmäärittelemällämuuttumatonURI,jokasisältäätietokomponenttien julkaisijan omistaman domain-päätteen ja julkaisuajankohdan. Esimerkkinä Tikesoshankkeessa28.9.2011julkaistuntietokomponenttikirjastonURI-tunniste: URI-tunnisteetlyhennetäänsos:prefix-tunnuksella,jokahyvännimeämiskäytännönmukaisestimääritelläänmyösURI-tunnisteenlopussa.TaulukossaonesimerkkiOsoite-tietokomponentillejasenkentille määritellyistäuri-tunnisteista. Taulukko1:EsimerkkiRDF-resurssienURI-tunnisteidenmuodostamisesta http://sosmeta.fi/tietokomponentit/2011/09/28/sos#osoite http://sosmeta.fi/tietokomponentit/2011/09/28/sos#osoite.lahiosoite.teksti http://sosmeta.fi/tietokomponentit/2011/09/28/sos#lahiosoiteteksti http://sosmeta.fi/tietokomponentit/2011/09/28/sos#osoite.voimassaolo.ajanjakso http://sosmeta.fi/tietokomponentit/2011/09/28/sos#voimassaoloajanjakso ACC BCC BCCProperty ASCC ASCCProperty Tietokomponenttien ja asiakirjojen tehokkaaseen hallintaan tarvitaan metatietorekisteri, jonka avulla asiakastietomalliinvoidaantehdämuutoksiakäyttäjäystävällisenkäyttöliittymänavulla.metatietorekisteri mahdollistaisi teknisten asiakirjarakenteiden hallitun ylläpidon, kun sisällön asiantuntijat pystyisivät tekemäänmuutoksiasuoraanasiakastietomalliin. Tietokomponenteistamuodostetaantarkennettujaversioitaasiakirjakohtaisesti.Tämätapahtuupoimimalla tietokomponentista tarvittavia kenttiä ja tiukentamalla kenttien kardinaliteetteja. Asiakirjakohtaisesti rajoitettuja tietokomponentteja ei liitetä tietokomponenttikirjastoon, vaan ne jäävät asiakirjakohtaiseen käyttöön. 15

3 Asiakirjojenmallintaminen Sosiaalihuollossakäytettävätasiakirjatyypitonjaettuasiakirjatyyppiluokituksenmukaisestiyleisiinasiakirjatyyppeihinjatarkennettuihinasiakirjatyyppeihin 7 Yleistenasiakirjatyyppienmallintaminenonkuvattutietomääritystenhallintamallissa 8 Tässäluvussakuvataanuudentarkennetunasiakirjatyypinlisäämistä sosiaalihuollonasiakastietomalliintietomallinnuksennäkökulmasta.asiakirjojenmallinnuksessakartoitetaan aluksi tietotarpeet, seuraavaksi suunnitellaan asiakirjojen sisällöllinen rakenne ja näiden pohjalta muodostetaanteknisetasiakirjarakenteet. Tietotarpeidenkartoittamisentarkoituksenaontunnistaanetiedot,jotkapitäätallentaaasiakirjaan.Tässä dokumentissaoletetaan,ettätietotarpeidenkartoittaminenonsuoritettumuualla,jatuloksetesitettymuutospyynnönmuodossa.muutospyyntöäarvioidaantietomääritystenhallintamallinmukaisestiasiantuntijaryhmässä ja tietoarkkitehtuuriryhmässä. Mikäli käsittelyn tuloksena on hyväksytty muutosehdotus, voidaanlähteäsuunnittelemaanuudentarkennetunasiakirjatyypinlisäämistä. Suunnittelutapahtuusisällöllisenasiakirjarakenteenavulla.Sisällöllinenasiakirjarakenneonkuvaussiitä, mitentunnistetuttietotarpeetvoidaantoteuttaasosiaalihuollonasiakastietomallinmukaisesti.tässävaiheessatietotarpeetpitääanalysoidakriittisestitarkastelemallatietojensemantiikkaajaniidenkäyttötarkoituksia. Tuloksena on taulukkomuotoinen rakenne, joka perustuu kuvailutietoihin ja niillä esitettyihin sosiaalihuollon tietokomponentteihin. Vaikka rakenne voidaan esittää myös muussa kuin taulukkomuodossa,tässäkuvauksessaoletetaan,ettäsisällöllinenasiakirjarakenneontoteutettutaulukkona.sisällöllinenasiakirjarakennetoimiimyösmuutosmäärittelynä,jonkapohjaltamuutostoteutetaan. 3.1 Sisällöllistenasiakirjarakenteidenkuvailutiedot Tekninenasiakirjarakenne on formaali malli, joka toteuttaa sisällöllisen asiakirjarakenteen. Malli voi olla esitettynä XML-muodossa, RDF/OWL-muodossa tai XML-skeeman muodossa. Sosiaalihuollon asiakastietomallinpääesitystapanaonrdf/owl.samoistarakenteistavoidaanmuodostaakuitenkinmyösxmlskeemojaesimerkiksitietojärjestelmienvälistenrajapintojentoteutustavarten. Sisällöllisetasiakirjarakenteetkuvataantaulukkomuotoisesti(LiiteH).Taulukoissaesitettäväasiakirjarakenneperustuusarakkeissakäytettäviinkuvailutietoihin: 16 - Tikesos-määritysSarakesisältääasiakirjarakenteenylimmäntasonjossamääritelläänviittauksetsosiaalihuollontietokomponentteihintaiasiakirjakohtaisestimääritellytkentät,jotkaperustuvat JHS 170 mukaisiin tietotyyppeihin. Esimerkiksi liitteessä Toimeentulotukihakemuksessa 7Sosiaalihuollon asiakasasiakirjasanasto. Versio 1.0. Sosiaalialan tietoteknologiahanke. http://www.sosiaaliportti.fi/file/8cbe843b-cbd8-4b85-8e58- ee584c624aa6/sosiaalihuollon+asiakasasiakirjasanasto.pdf 8KonstantinHyppönen,JaanaNevalainen,MiikaAlonen,PaulaLeinonen,VirpiHotti.Sosiaalihuollontietomääritystenhallintamalli:Hallintaprosessitja linjausehdotukset.sosiaalialantietoteknologiahanke. http://www.sosiaaliportti.fi/file/da6fb554-d408-4a7a-a215-3f91c0bb9931/sosiaalihuollon+tietom%c3%a4%c3%a4ritysten+hallintamalli.pdf

kenttähakemuksen jättötapa on määritelty asiakirjakohtaiseksi, koska sitä ei ole käytetty muissa asiakirjarakenteissa. Sarakkeet B-G sisältää joukon kenttiä, jotka on määritelty sosiaalihuollonasiakastietomallissa,jaonlöydettävissäsarakkeessaviitatuistatietokomponenteista. - Otsikko Sarake H:ssa oleva tietokomponentin tai kentän nimi kuvaa usein sen käyttötarkoitusta asiakirjassa riittävän hyvin ja selkeästi. Jos kenttä tai tietokomponentti halutaan esittää näyttömuodossatarkennetullaotsikolla,silloinotsikkomainitaansarakkeessah. - TiedonesitysmuotoSarakesisältääviittauksentietokomponenttiin,jotakäytetäänsarakkeessa nimetyn rakenteen esittämiseen. Mikäli sarakkeessa on asiakirjakohtainen kenttä, tiedon esitysmuotona voi olla joku yksinkertainen perustyyppi kuten teksti tai päivämäärä. Tietokomponenttiensisältämillekentilleeitarvitsemääritellätiedonesitysmuotoa,koskatiedonesitysmuoto onkuvattutietokomponenttikirjastossa. - Määritelmä Sarake sisältää asiakirjakohtaisen rakenteen (tietokomponenttiin tai yksinkertaiseentietotyyppiinperustuvankentän)määritelmän. - HuomautusSaraketarkentaamääritelmäätaiantaakenttä-taitietokomponenttikohtaisiakäyttöohjeita.Sarakevoisisältäämyösohjeitanäyttömuotojenmuodostamiseen. - EsimerkkiSarakesisältääkonkreettisenesimerkinkentänsisällöstä. - KoodistoJoskentäntietotyyppinäonkoodi,sisältääsarakelinkinkäytettäväänkoodistoon. - ToistuvaSarakeN:ssäKyllätarkoittaa,ettärakennetaikenttävoitoistuaasiakirjassa.Esimer- kiksitoimeentulotukihakemuksessalapsentaloudellinentilanneontoistuvarakenne,koskaper- heessävoiollauseitalapsia.eitarkoittaa,ettärakennetaikenttävoiesiintyävainkerran. - Pakollinen Sarake O:ssa Kyllä tarkoittaa, että rakenteen tai kentän tulee esiintyä asiakirjassa ainakin kerran.ei tarkoittaa, että rakenne tai kenttä on valinnainen. Rakenteet on pyritty teke- määnmahdollisimmanjoustaviksi.niissätapauksissa,joissarakenteenpakollisuudestaeiolepää- tetty,rakenneonmääriteltyvalinnaiseksi. SarakkeetA Gmuodostavatpuurakenteita,jotkaalkavatsarakkeestamääritellyistätietokomponenteista.Puurakenteissamääriteltyjentietokomponenttienja kenttienkuvailutietojavoidaantarkentaamuissa sarakkeissa. Tällä tavalla asiakirjarakenteista voidaan muodostaa ns. tarkennettuja tietokomponentteja. SarakkeissaA Geisaaollauseitasamallanimellävarustettujarakenteitaesimerkiksi,josasiakirjassaon käytettytietokomponenttiinelämäntilanneperustuvaakenttääelämäntilannehakijanelämäntilanteen kartoittamiseen,puolisonelämäntilanteellepitäävarataeriniminenkenttä,esimerkiksipuolison elämäntilanne Samaa tietokomponenttia saa käyttää asiakirjarakenteessa useita kertoja, kunhan antaa tähäntietokomponenttiinperustuvillekentilleerinimet. 3.2 Sisällöllisenasiakirjarakenteenmuodostaminen Asiakirjatsisältävätuseinasiakkaaseenjaasiakkaanelämäntilanteeseenliittyviätietoja,joidenperusteella asiakas voi saada sosiaalipalveluja ja -etuuksia. Hankkeessa asiakirjarakenteita suunniteltiin Tikesoshankkeessavuosina2007 2010tuotettujensosiaalihuollonpalvelutehtäväkohtaistenasiakastietokuvaustenpohjalta,muttamyösmuitalähteitäonkäytetty.Muitalähteitäovatolleetesimerkiksilastensuojelun käsikirjajapelastakaalapsetry.hankkeenjälkeensisällöllisetasiakirjarakenteetsuunnitellaanmuutosehdotustenpohjalta.muutosehdotuksenliitteenävoiollamyösmuutadokumentaatiotatulevanasiakirjan tietosisällöstä,esimerkiksipaperimuotoisenasiakirjanesimerkkitailomake.muutosehdotusprosessiaon kuvattutarkemminsosiaalihuollontietomäärityksienhallintamallissa. 17

Sisällöllinen asiakirjarakenne muodostetaan asiakirjan yleisestä rakenteesta, asiakirjakohtaisesti tarkennetuista komponenteista ja asiakirjakohtaisista kentistä. Tarkennetussa tietokomponentissa voidaan uudelleenmääritellätairajoittaatietokomponentinkenttiä.tietokomponenttikirjastossaeiuseinkaanmääritelläkenttienpakollisuuksianevoidaanmääritelläasiakirja-taisovelluskohtaisesti.sisällöllisenasiakirjanmuodostaminenvoidaantoteuttaanoudattamallaseuraaviavaiheita: 1. Valitseasiakirjatyyppi 2. Listaaasiakirjassakäytetytroolit a. yksityishenkilöidenroolit b. ammattihenkilöidenroolit c. organisaatioidenroolit 3. Etsitietokomponenttikirjastostaasiakirjansisältöäkuvaavattietokomponentit a. joslöytyy:määritteletarkennetuttietokomponentit b. joseilöydy:määritteleuusitietokomponenttijostietosisältömuodostaaloogisenkokonaisuudenjasamatietosisältöonkäytössäuseassaeriasiakirjassa 4. Määritteleasiakirjakohtaisetkentät 5. Määritteleotsikotjafraasit 6. Määrittelekentän/tietokomponentintoistuvuus 7. Määrittelekentän/tietokomponentinpakollisuus Kaikissaasiakirjoissayhtenäisiärakenteitaovatseuraavat: - HeaderKaikissaasiakasasiakirjoissakäytetääntietokomponenttiaHeaderjokasisältääasiakir- janmuuttumattomatmetatiedot.nemetatiedot,jotkasaattavatmuuttuaarkistoinninaikana,tal- lennetaan erikseen CDA-kääreeseen, eikä niitä näytetä sisällöllisessäasiakirjarakenteessa. TietokomponentistaHeaderpoimitaansisällölliseenasiakirjarakenteeseenvainasiakirjassakäytettävät ajankohdat(kutenasiakirjanlaatimis-taivastaanottoaika).teknisessäasiakirjarakenteessakäytetäänkuitenkinainakokonaistaheader-tietokomponenttia. - Asiakirjan perustiedot Tietokomponentti on muodostettu kentistä, joita käytetään asiakirjoissa yleisestiriippumattaasiakirjatyypistä.sesisältäämuunmuassaviittauksetmuihinasiaanliittyviin asiakirjoihin,kentätlakitekstejävartensekäasiakirjanalatunnisteessakäytettävätyhteystiedot. - Rooli.Roolionabstraktijaroolissailmestyvienroolitoimijoidenlajejaonvähintäänkaksi(esimerkiksiyksityishenkilöjaammattihenkilö).Roolinkuvauksessavoidaankäyttääroolikoodia. - AmmattihenkilöAsiakirjantekemiseenosallistunuttaiasiakirjassajostaintoisestasyystämainittu ammattihenkilöoneräsroolitoimija.jokaisessaasiakirjassaonmainittuvähintäänyksiammattihenkilö.ammattihenkilöidenroolienmallintamiseensovelletaanluvussa3.3annettujaohjeita. - Yksityishenkilö.Asiakirjanalussalistataanyksityishenkilötjaniidenroolit,kutenasiakastaipuoliso.Yksityishenkilöonroolitoimija,jokavoiollauseassaeriroolissa.RooliaAsiakaskäytetäänkaikissaasiakasasiakirjoissa.Roolienmallintamiseensovelletaanluvussa3.3annettujaohjeita. - Yleinenasiakirjatyyppi.Tarkennetunasiakirjanrakenteensuunnittelualkaayleisenasiakirjatyypin valinnasta.yleistenasiakirjatyyppienkäyttötarkoituksetjamäärittelytonesitettysosiaalihuollon asiakirjasanastossa 9 Jokaisellayleiselläasiakirjatyypilläonomatrakenteensa,jokaontoteutettu yleistäasiakirjatyyppiävastaavantietokomponentinavulla.esimerkiksipäätösasiakirjojenrakenteetperustuvatpäätös-tietokomponenttiin(kuva12).josyleistäasiakirjatyyppiävastaavatieto- komponenttitoteuttaakaikkiasiakirjantietotarpeet,tietokomponenttiotetaankäyttöönsellaise- naantairajoitettuna.tietokomponentinkenttienkäyttöäohjeistetaan,mikälitietokomponentissa 9Sosiaalihuollonasiakasasiakirjasanasto http://www.sosiaaliportti.fi/file/8cbe843b-cbd8-4b85-8e58-ee584c624aa6/sosiaalihuollon+asiakasasiakirjasanasto.pdf 18

oleva ohjeistus ei ole riittävä. Jos asiakirjassa on muitakin tietotarpeita, joita tämä tietokomponenttieitoteuta,rakenteeseenlisätäänmuitatietokomponenttejajakenttiätarpeenmukaan.ne listataanyleistäasiakirjatyyppiävastaavantietokomponentinjälkeen.josyleisenasiakirjatyypin rakennevastaaasiakirjalleasetettaviintarpeisiinhuonosti,niinsilloinyleistäasiakirjatyyppiävastaavaatietokomponenttiaeiasiakirjassakäytetä.suunnittelussapyritäänkuitenkinmahdollisuuksienmukaankäyttämäänsamojakenttiennimiäkuinyleisessäasiakirjarakenteessa. Kun yleinen asiakirjatyyppi on valittu, seuraavaksi analysoidaan asiakirjassa ilmestyvien henkilöiden ja organisaatioidenroolit.roolientoteutusonkuvattutämändokumentinluvussa3.3. Kuva12:TietokomponenttiPäätös,jokavastaayleistäasiakirjatyyppiäPäätös. Asiakirjat koostetaan CCTS-standardin mukaisesti tietokomponenteista, jotka on määritelty tietokomponenttikirjastossa. Asiakirjan mallinnukseen valitaan tietokomponentit, jotka ovatsemanttisesti mahdollisimman lähelläasiakirjan tietotarpeita. Tarvittaessa osa komponentin kentistä jätetään poisasiakirjarakenteesta.tätäkutsutaantietokomponentintarkentamiseksi. Tarkentamisellatarkoitetaantietokomponentinjasenkenttiensitomistakontekstiin.Yleensäasiakirjarakenteessarajataanpoisosatietokomponenttienkentistätaimuutetaankenttienpakollisuutta,toistuvuutta taimääritelmiä. Teknisistäasiakirjarakenteista tarkennetuilla tietokomponenteilla ei ole niiden muodostamisenjälkeensuoraateknistäriippuvuuttaalkuperäisiintietokomponentteihin.näintekninenasiakirjarakennemuodostuuyksittäisestämäärittelystä,jollaeiolesuoriariippuvuuksiamuihintietomäärityksiin. Tällöinmuutoksettietokomponenttikirjastooneivätvaikutasuoraanasiakirjoihin.Josmuutoksiatehdään tietokomponentteihin, ja ne halutaan saada näkymään myös asiakirjoissa, täytyy sisällölliset ja tekniset asiakirjarakenteetpäivittäävastaamaanhaluttuarakennetta. Syynätarkennettujentietokomponenttienmuodostamiseenonse,ettätietokomponenteissaonuseintarkennetun asiakirjatyypin kannalta tarpeettomia tietoja. Esimerkiksi Yksityishenkilotietokomponentissaonpaikattiedollehenkilönaikaisemmistakotikunnista,hänenaiemminkäyttämistään nimistä ja ammatista. Kaikkia näitä kenttiä voidaan käyttää tärkeiden taustatietojen tallentamiseen, ja niilleonvarattupaikkatietokomponentissa.niitäeikuitenkaanolesyytäkäyttääjokaisessatarkennetussa asiakirjatyypissä. Sisällöllisissä asiakirjarakenteissa tarkentaminen tapahtuu sisällyttämällä halutut tietokomponentit ja kentätasiakirjarakenteeseen.tällöinasiakirjassakäytetäänvainnäitätietokomponenttejajakenttiä.esimerkiksiselvitysadoptionhakijoista-asiakirjassakäytetäänelämäntilanne-tietokomponenttiaasiakir- janosassahakijan elämäntilannekuvassa13nähdäänkaikkitietokomponentinsisältämätkentät. 19

Asiakirjassa tietokomponenttia on tarkennettu käyttämäänainoastaan osaa siinä olevista kentistä.maahanmuuttokesäopiskelutilannejaeläkeeivätoletässäasiakirjassaoleellisiatietoja,jotenneon rajattupoiskuvassa14.tietokomponentinrajoittamisessapitääottaahuomioon,ettäasiakirjarakenteissa käytettävien tietokomponenttien kentistä pitää valita mukaan ne kentät, jotka on merkitty pakollisiksi tietokomponenttikirjastossa. Kuva13.TietokomponenttiElämäntilanne Kuva14.Elämätilanne-komponenttisisällöllisessäasiakirjamäärityksessä Joidenkintietokomponenttienkohdallakenttienosajoukkojenmuodostamineneiolejärkevää.Esimerkiksi Osoite-tietokomponentistaeiyleensämuodostetarajoitettujaversioita,koskaosoitteetonhyvämääritellä yhtenäisellä tavalla kaikissa asiakirjoissa. Tässä tapauksessahuomautus-kuvailutiedon teksti on Kaikki kentät tulostetaan. Asiakirjarakenteessaeisaamääritelläuseitasamannimisiätietokomponentteja.Mikälitietokomponentin taikentännimieisovellunäyttömuotoon,nimeäeihalutanäyttömuotoihinmukaanlainkaantaisehalutaan muuttaa, ilmaistaan se sisällöllisissä asiakirjarakenteissa otsikko-sarakkeessa. EsimerkiksiAdoptiotoiveen perustelut-tekstikentänonhaluttunäyttömuotoihinotsikonmiksi toivotte lasta?alle(kuva15).samointietokomponentinnimiotsikkonavoidaanpoistaanäkyvistäkokonaan.tällöin Otsikko-sarakkeeseenlaitetaantekstiei otsikkoa 20