1. Training for developers of X-Road interfaces
Name
Date

2. Service-oriented architecture
Software structure where services are made available for the users through computer network.
Further regulations, practices and frameworks.
Service directory for publishing and finding service descriptions.
Requirements to service level are also published in the service directory.
Service – separate method realising some certain functionality, which can be repeatedly retrieved through specific interface.
Web service – a method retrieved over web, the interface of which is described in a machine- readable format.

3. Implementation of service-oriented architecture on X-Road
Services on X-Road are dataservices.
Dataservice is a communication method which enables exchanging data between the parties via public internet.
Distributed – parties are connected directly via a P2P model.
Status-free – a response follows the request during the same connection.
Each party can be a provider as well as a user.
Distributed service directory used through metaservices.
Superstructure of distributed service directory is RIHA.

4. Properties of service-oriented architecture
Independence of platform
Weak coupling
Composition of services
Self-description
Universality

5. Steps of development of dataservices
Determination of business needs
Stage of analysis and design
Development stage
Testing
Launching

6. 1. Determination of business needs
The objective is to determine business needs and translate them into web service requirements.
Result of the stage is specifications of requirements.

7. 2. Stage of analysis and design
Identification of suitable available dataservices.
If these are lacking:
Determination of technological platform of dataservice.
Drafting of architectural specification
Description of planned dataservices.
Drafting of descriptions of dataservice interfaces in XSD/WSDL format
Results of the stage are detailed specifications of software architecture and dataservices.

8. 3. Development stage Realisation of software solution Various methods:
Source code -> WSDL (Bottom Up)
WSDL -> source code (Top Down, Contract-first)
Agile method (Meet in the Middle)
Results of the stage: validated and commented WSDL and realisation of dataservice.

9. 4. Testing Activities of the stage: Testing of functionality
Testing of cooperation ability
Testing of performance

10. 5. Launching Activities of the stage:
Registration of the service in RIHA system
Implementation of the service

11. Interfacing patterns https://moodle.ria.ee/course/view.php?id=11
Includes design and usage patterns of X-Road.
In addition to textual descriptions of problems and solutions, the directory also includes several examples of WSDL descriptions.
Patterns are recommended
Directory can be supplemented

12. Division of patterns Primitives – basic elements (PM):
Requesting data, sending data, tunnelling protocol
Functional patterns – based on primitives (FM):
Universal data request service, list and detailed information, CRUD data management, a time-consuming process, etc.
Processing patterns:
Usage patterns (KM): sequential use of service, alternative workflow, nested retrieval of service, parallel use of service, etc.
Consumption patterns (TM): data divisor, data aggregator, header- oriented targeting of data.

13. Thank You! First name Surname firstname.surname@amet.ee
The training materials for developers of X-Road interfaces have been compiled with funding from the structural funds support scheme “Raising Public Awareness about the Information Society” of the European Regional Development Fund.