Attribuutti-kyselypalvelu sivu 1/10
Sisällysluettelo 1 Johdanto... 3 2 Palvelut... 3 2.1 Ammattioikeudenrajoituslista... 3 2.2 Ammattioikeuslista... 3 2.3 Attribuutti-rajoitustietosanoma... 3 3 Palvelurajapinnan toteutus... 4 3.1 Tiedosto/http-palvelut... 4 3.2 SOAP/http-palvelut... 4 4 Skeemakuvat... 6 4.1 Ammattioikeusrajoituslista... 6 4.2 Ammattioikeuslista... 6 4.3 Attribuutti-rajoitustietosanoma... 7 5 Liitteet... 9 5.1 Liite 1: Skeemakuvaukset (*.xsd).... 9 5.2 Liite 2: Palvelurajapinnan kuvaukset (*.wsdl).... 9 5.3 Liite 3: Esimerkit (*.xml).... 9 Muutoshistoria... 10 sivu 2/10
Attribuutti-kyselypalvelun rajapintakuvaus 1 Johdanto 2 Palvelut Tässä dokumentissa kuvataan Valvira:n attribuutti-kyselypalvelun (ammattioikeustiedot) sidosryhmille tarjottava palvelurajapinta. Palveluja koskevat käyttötapaukset on kuvattu toteutusprojektin käyttötapauskuvauksissa tarkemmin. 2.1 Ammattioikeudenrajoituslista Sidosryhmän järjestelmä hakee Valvira:n palvelusta luettelon niistä rekisterinumeroista, joilla on jokin rajoitus voimassa palvelun kautta ajastetusti kerran vuorokaudessa ja mieluiten yöaikaan. Parametrit: Ei parametreja. Palautusarvo: XML-muodossa skeeman mukainen luettelo rekisterinumeroista. Ehdot: - 2.2 Ammattioikeuslista Poikkeukset: Ei oleellisia sovelluspoikkeuksia. Sidosryhmän järjestelmä hakee Valvira:lta luettelon rekisterinumeroista palvelun kautta ajastetusti kerran vuorokaudessa ja mieluiten yöaikaan. Parametrit: Ei parametreja. Palautusarvo: XML-muodossa skeeman mukainen luettelo lääkäreiden ja hammaslääkäreiden rekisterinumeroista. Ehdot: - Poikkeukset: Ei oleellisia sovelluspoikkeuksia. 2.3 Attribuutti-rajoitustietosanoma Sidosryhmän järjestelmä hakee Valvira:n palveluväylän kautta ajantasaisesti tiedot parametrina lähetettävän hakuehdon mukaisen henkilön henkilötiedoista, ammattioikeuksista rajoituksineen sekä tutkintotiedoista. sivu 3/10
Parametrit: Hakuehto. Arvona on joko rekisterinumero tai henkilötunnus. Palautusarvo: XML-muodossa skeeman mukainen rajoitustietosanoma. Ehdot: palvelua kutsutaan vain, jos henkilö on ammattioikeudenrajoituslistalla. Poikkeukset: hakuehdon mukaista henkilöä ei löydy Valvira:n tiedoista. 3 Palvelurajapinnan toteutus 3.1 Tiedosto/http-palvelut Protokolla ja suojaus: https, palvelinvarmenteet Kelan ja sidosryhmän välillä, Kela purkaa TLS-yhteyden ja ohjaa liikenteen Valvira:n palveluun. Sanomakuvaukset: tietosisältöä määrittävät skeemat. Osoitteet: https://t-lists.valtteri.fi/ammattioikeuslista (testiympäristö, ammattioikeuslista), https://t-lists.valtteri.fi/ammattioikeusrajoituslista (testiympäristö, ammattioikeusrajoituslista), https://lists.valtteri.fi/ammattioikeuslista (tuotantoympäristö, ammattioikeuslista), https://lists.valtteri.fi/ammattioikeusrajoituslista (tuotantoympäristö, ammattioikeusrajoituslista). 3.2 SOAP/http-palvelut Osoitteet Attribuutti-rajoitustietosanoma https://t-attrib.valtteri.fi/ammattioikeus (testiympäristö) https://attrib.valtteri.fi/ammattioikeus (tuotantoympäristö) Määritys: Web Service / SOAP 1.1. Protokolla ja suojaus: https, palvelinvarmenteet Kelan ja sidosryhmän välillä, Kela purkaa TLS-yhteyden ja ohjaa liikenteen Valvira:n palveluun. sivu 4/10
Kysely: skeeman mukainen sanoma. Vastaus: skeeman mukainen sanoma. Header: synkronisesta liikenteestä huolimatta sidosryhmän on käytettävä elementtejä sanomatunnus ja sanomavastiketunnus. Valvira hyödyntää niitä vain lokituksessa ja sidosryhmä voi itse määrätä niiden sisällön kyselyssä ja ne palautetaan vastauksessa sellaisenaan. Virhekäsittely: virheet välitetään palveluväylästä SoapFault-määrityksen mukaisesti. Esimerkki puuttuu vielä ja se toimitetaan heti, kun mahdollista. Sanoman elementissä vastausstatus kerrotaan tietokantakäsittelyn onnistuminen. Lisäksi tietosisältöön ja tietokantakäsittelyyn liittyvät virheet välitetään vastaussanoman elementissä virhetieto (vrt. dokumentti Määrittely, tiedot ): <xs:complextype name="errortype"> <xs:sequence> <xs:element name="virheluokka"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:maxlength value="30"/> </xs:restriction> </xs:simpletype> </xs:element> <xs:element name="virhekoodi" minoccurs="0"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:maxlength value="20"/> </xs:restriction> </xs:simpletype> </xs:element> <xs:element name="virheteksti" minoccurs="0"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:maxlength value="500"/> </xs:restriction> </xs:simpletype> </xs:element> </xs:sequence> </xs:complextype> sivu 5/10
4 Skeemakuvat 4.1 Ammattioikeusrajoituslista 4.2 Ammattioikeuslista sivu 6/10
4.3 Attribuutti-rajoitustietosanoma sivu 7/10
sivu 8/10
5 Liitteet 5.1 Liite 1: Skeemakuvaukset (*.xsd). Sanomakuvaukset: TEOCommon.xsd TEORequest.xsd TEOResponse.xsd Listat: Rajoitustietolista.xsd Ammattioikeuslista.xsd 5.2 Liite 2: Palvelurajapinnan kuvaukset (*.wsdl). 5.3 Liite 3: Esimerkit (*.xml). Sanomakuvaukset; WSDL-, XSD-kuvaukset sekä esimerkkisanomat (*.xml) ovat tiedostossa Valvira_attrib_schema.2010.10.07.zip. sivu 9/10
Muutoshistoria Versio Päiväys Tekijä Tarkastaja Hyväksyjä Muutoshistoria 1.3 Lisätty tarkemmat palveluosoitteet 1.3 7.10.2010 Päivitetty Attribuutti-rajoitustietosanoman kuva, ytenäistetty versionumeroa. Liittyy ohjelmaversioon 1.3 0.5 28.01.2009 MMK Tarkennettu TLS 0.4 27.01.2009 VEL Marko Jalonen/Kela Lisätty listojen osoitetiedot 0.3 16.01.2009 VEL Muutettu listojen protokollaksi sftp->https Kelan palomuurin yhteensopivuuden vuoksi 0.2 02.12.2008 VEL Täydennetty skeemakuvilla ja keskeneräisten tuotosten selvityksellä. 0.1 12.11.2008 VEL Ensimmäinen versio. sivu 10/10