1. X-tee liideste arendajate koolitused
Raigo Linna

2. Moodul 4 X-tee nimeruum X-tee teenused
Teenuste kirjeldused. Kuidas neid leida
Dokumentide mallid teenuste kirjeldamiseks
Vajalikud dokumendid

3. Nimeruum (namespace) on elementide komplekt või rühm, mis on defineeritud mingi kindla nimetamiskokkuleppe alusel.
Nimeruum
Nimeruumi deklareerimine XML-s:
xmlns=„
xmlns: a=„
XML nimeruum
XML Schema (XSD)
X-tee nimeruum
X-tee v6 päiseväljad
Päiseväljade selgitused
Muudatused versioonile 6 üleminekul
Nimeruumi aliase defineerimine:
xmlns:xrd=„
xmlns:wsdl=„
xmlns:xsd=„
xmlns:id=„
xmlns:soap=„

4. Nimeruum XML nimeruum XML Schema (XSD) X-tee nimeruum
XSD Näide (
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema elementFormDefault="qualified"
targetNamespace="
xmlns="
xmlns:xs="
<xs:complexType name="XRoadIdentifierType">
<xs:annotation>
<xs:documentation>Globally unique identifier in the X-Road system.
Identifier consists of object type specifier and list of
hierarchical codes (starting with code that identifiers
the X-Road instance).</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" ref="xRoadInstance"/>
<xs:element minOccurs="0" ref="memberClass"/>
<xs:element minOccurs="0" ref="memberCode"/>
<xs:element minOccurs="0" ref="subsystemCode"/>
<xs:element minOccurs="0" ref="groupCode"/>
<xs:element minOccurs="0" ref="serviceCode"/>
<xs:element minOccurs="0" ref="serviceVersion"/>
<xs:element minOccurs="0" ref="securityCategoryCode"/>
<xs:element minOccurs="0" ref="serverCode"/>
</xs:sequence>
<xs:attribute ref="objectType" use="required"/>
</xs:complexType>
Nimeruum
XML nimeruum
XML Schema (XSD)
X-tee nimeruum
X-tee v6 päiseväljad
Päiseväljade selgitused
Muudatused versioonile 6 üleminekul

5. Nimeruum XML nimeruum XML Schema (XSD) X-tee nimeruum
X-tee v6 päiseväljad
Päiseväljade selgitused
Muudatused versioonile 6 üleminekul
X-tee nimeruumid:

6. Nimeruum Turvaserver kasutab päisevälju:
päringute ja vastuste ruutimiseks
õiguste kontrolliks
autentsuse tagamiseks
logimiseks.
Nimeruum
XML nimeruum
XML Schema (XSD)
X-tee nimeruum
X-tee v6 päiseväljad
Päiseväljade selgitused
Muudatused versioonile 6 üleminekul
Päise elemendid on vajalikud andmeteenuse osutajatele ja kasutajatele endile, näiteks et:
teostada täiendavat kliendispetsiifilist õiguste kontrolli
rakendada kliendispetsiifilisi äriloogikalisi arvutusi või filtreid.
logimiseks.

7. Nimeruum XML nimeruum XML Schema (XSD) X-tee nimeruum
X-tee v6 päiseväljad
Päiseväljade selgitused
Muudatused versioonile 6 üleminekul

8. Nimeruum XML nimeruum XML Schema (XSD) X-tee nimeruum
X-tee v6 päiseväljad
Päiseväljade selgitused
Muudatused versioonile 6 üleminekul

9. Teenused
Teenus X-tee mõistes on eeldefineeritud päring-vastus, mille asutuse (või ettevõtte) infosüsteem saadab andmekogule ja millele andmekogu annab vastuseks kokkulepitud andmete koosseisu.
Andmeteenused
Metateenused
Haldusteenused
Tehniliselt kirjeldatakse teenused WSDL definitsiooniga. SOAP ja WSDL mõistes on teenus operatsioon (kirjeldatakse portType elemendiga), millel sisend ja väljund sõnum (kirjeldatakse message elementidega).

10. Teenused Teenuste pakkujad: http://SECURITYSERVER/listClients
Teenused
Kesksed teenused:
Andmeteenused
Metateenused
Haldusteenused
Teenuste nimekiri:
listMethods
allowedMethods

11. Teenused Andmeteenused Metateenused Haldusteenused clientReg
clientDeletion
authCertReg
authCertDeletion

12. Teenuste kirjeldused. Kuidas neid leida
WSDL kirjelduse allalaadimine.
xRoadInstance – X-tee komplekt
memberClass – liikme klass
memberCode – X-tee liikme kood
subsystemCode – liikme alamsüsteemi identifitseerimise kood
serviceCode – teenuse kood
version – teenuse versioon
Teenuste kirjeldused asuvad WSDL failides, mis omakorda asuvad asutuse turvaserveris, mis vastavat teenust pakub.
Värske teenuste nimekiri on saadaval:

13. Teenuste kirjeldused RIHA-s
X-teel registreeritud teenused peavad olema kirjeldatud ka RIHA keskkonnas (Riigi infosüsteemi haldussüsteem) aadressil: ja vastama täpselt turvaserverites kasutatavate teenuste kirjeldusele.

14. Andmeteenuse andmed Teenuse inimloetav nimetus.
Teenuse WSDL kirjeldus.
Teenuse funktsionaalne kirjeldus.
Teenuse kasutamiseks vajalik turvatase/turvaklass.
Teenuse osutamise, kasutamise ja muutmise tingimused,
Teenuse ekspluatatsiooninõuded, mis peavad sisaldama vähemalt:
teenuse tööaega,
ühekordse katkestuse maksimaalset kestvust,
päringule vastamise maksimaalset aega (tagatud vähemalt 90% päringutele vastamisel),
päringute arv minutis või päringute arv ühe kliendi kohta minutis.

15. Alamsüsteemi andmed
Alamsüsteemi kirjeldamiseks vajalikud andmed on kirjeldatud X-tee kasutamise juhendis punktis

16. Vajalikud dokumendid X-road: Message Protocol v4.0.
X-road: Service Metadata Protocol. Technical Specification.
X-Road: Protocol for Management Services.
X-tee rakendusjuhis.
ISKE rakendusjuhend.

17. Aitäh! Eesnimi Perenimi eesnimi.perenimi@amet.ee
X-tee liideste arendajate koolitusmaterjalid on valminud EL struktuuritoetuse toetusskeemist “Infoühiskonna teadlikkuse tõstmine” Euroopa Regionaalarengu Fondi rahastusel.