OHJE 1(5) Tietojen lataaminen stä omiin tietojärjestelmiin Taustaa THL - ä käytetään sähköisten lääkemääräysten ja potilasasiakirjojen yksilöintiin, tallentamiseen ja luovuttamiseen reseptikeskuksesta ja potilastiedon arkistosta. Rekisteriä käytetään myös Kanta-palveluihin liittyneiden osapuolten tunnistamiseen ja hallinnointiin sekä esimerkiksi uudistamispyyntöjen välittämiseen terveydenhuollon ja apteekkien välillä. Terveydenhuollon palveluntuottajien organisaatio- ja muista muutoksista johtuen SOTEorganisaatiorekisteriä päivitetään lähes päivittäin. Toiminnan virheettömyyden ja kansalaisten hyvän asiakaspalvelun takia on suositeltavaa ja välttämätöntä, että stä tietoja lataavat tietojärjestelmät myöskin virkistäisivät omat organisaatiotietonsa päiväsyklillä. Tiedot voidaan hakea koodistopalvelimelta joko ohjelmointirajapintoja hyödyntäen, tai lataamalla aineistoja tiedostomuodossa. Ohjelmointirajapinnat (Web Services ja XML/SOAP) Suositeltavin tapa hakea tietoja koodistopalvelimelta stä on hyödyntää Web Services-palvelurajapintaa tai XML/SOAP-sanomarajapintaa. Tarkempia ohjeita näistä löytyy koodistopalvelun verkkosivuilta kohdasta Ohjeet ja oppaat Tietojärjestelmäintegraatio. Tiedostojulkaisut (XML, Excel, txt) Kaikki koodistopalvelimen koodistot ja luokitukset säilytetään palvelimella myös tiedostomuodossa (XML, Excel, txt). Nämä ns. Viralliset julkaisut ovat vapaasti ladattavissa ja hyödynnettävissä. SOTEorganisaatiorekisterin tiedostojulkaisut virkistyvät koodistopalvelimella automaattisesti joka yö. Lisäksi tiedostot virkistetään aina erikseen, kun sisältöön tai rakenteeseen on tehty muutoksia. Tiedostojulkaisut löytyvät n sivulta, välilehdeltä Julkaisut (Kuva 1). Kuva 1. n julkaisutiedostot koodistopalvelimella
OHJE 2(5) Huom. Julkaisutiedostot sisältävät aina sekä otsikot että varsinaisen datan. Molemmat tarvitaan koodiston esittämisessä ja myös tietojärjestelmien päivityksessä, jotta rakenne säilyisi ehjänä. Julkaisutiedostojen valmistelussa esiintyy valitettavasti aika ajoin ongelmia esimerkiksi valmisteluajo saattaa jäädä jumiin, tai ei-sallittu erikoismerkki aiheuttaa siirtymän tiedostossa. Tällaisissa tapauksissa tiedostojulkaisut joudutaan aina poistamaan ja luomaan uudelleen CodeServer-käyttöliittymästä käsin (Liite 1). Myös tietokenttien järjestys julkaisutiedoston sisällä saattaa muuttua ja niitä voidaan joutua lisäämään tai poistamaan. Julkaisutiedostojen yksittäisten sarakkeiden ja kenttien tietosisältö tulee aina päätellä otsikkotietojen perusteeella. Liite 1. Tiedostojulkaisun luonti CodeServer-käyttöliittymällä. Esimerkkinä tekstitiedosto vakioparametreillä. Uusi julkaisu Luokituksen nimi: THL - Version nimi: THL - 2008 Julkaisun tiedot Nimi:* Tiedoston nimi: Formaatti:* Tila:* Kuvaus: THL - sote Teksti Excel CodeServer tiedostolataus Sas Ecomed XML Taulu SharePoint-hierarkia Epävirallinen Virallinen Henkilökohtainen THL- OID=1.2.246.537.6.202 /opt/cs_konf/julkaisut/sote.txt (vastaavasti: sote.xml ja sote.xls)
OHJE 3(5) Ajastus: Ei ajastusta Päivittäin Viikoittain Kuukausittain Aika (tunti): 1 tiedostojulkaisut virkistetään automaattisesti joka yö Tietosisältö ja muotoilu Tietokentät: Kentät Kentän nimi Kentän tyyppi Tunniste Perustiedot ovat järjestelmässä vakiona Lyhenne (tässä organisaatiotyyppinen luokitus) Pitkä nimi Ylempi yksikkö Hierarkiataso Voimassaolo alkaa Voimassaolo päättyy Muutospvm Viim. tallentaja Tila Määritelmä OID Kustannuspaikka Postiosoite Katuosoite Postinumero Postitoimipaikka Puhelinnumero Telefax Beskrivning_sv Lisätiedot ovat käyttäjän itsensä Besöksadress_sv lisäämiä ja nimeämiä (koodistokohtaisia) Eronnut earkistosta pvm Eronnut ereseptistä pvm Förkortning_sv Korvaava koodi Liittynyt earkistoon pvm Liittynyt ereseptiin pvm Lisää kaikki
OHJE 4(5) Hierarkiajulkaisu: Långt_namn Organisaatioyksikön tyyppi Org.Yks.lyhenne Reseptin uusiminen Sektori Sijainti kunta Terv.toimintayksikkö Y-Tunnus Lajittelujärjestys: Nouseva Laskeva Sarake-erotin:* ; Kenttäerotin: sarake-erottimena puolipiste Toistumaerotin:* Lisää otsikkorivi: Ei otsikkoriviä Lataustiedoston otsikointi (luettelo otsikoista liitteess 2) Paikallistettu otsikointi Julkaistavat organisaatiot: Aktiiviset Aktiiviset ja ehdotustilaiset Poista muotoilu: Luo julkaisu Peruuta
OHJE 5(5) Liite 2. n tiedostojulkaisujen sarakeotsikot ( versio 31.10.2013) OrganizationId Abbreviation LongName ParentId HierarchyLevel BeginningDate ExpiringDate LastModifiedDate LastModifiedBy Status Description OID CostCenter PostAddress StreetAddress PostNumber PostOffice PhoneNumber FaxNumber ALONG:Beskrivning_sv A:Besöksadress_sv A:Eronnut earkistosta pvm A:Eronnut ereseptistä pvm A:Förkortning_sv A:Korvaava koodi A:Liittynyt earkistoon pvm A:Liittynyt ereseptiin pvm A:Långt_namn A:Organisaatioyksikön tyyppi A:Org.Yks.lyhenne A:Reseptin uusiminen A:Sektori A:Sijainti kunta A:Terv.toimintayksikkö A:Y-Tunnus