Willems V1.0

Web Service Client Program Development


  1. Introduction

  2. Web service definition

  3. Web service client implementation


1. INTRODUCTION

The aim of this document is give information about how a client software can use the Willems Webservice.

The Willems webservice provides 2 functionalities, depending on the function called.

These functions are:
• getDisciplineList(int) : Get the List with all Disciplines/Official Disciplines
• calculateResult(int inpAge, int inpGender, int inpKey, String inpPoints, String inpDistance, String inpTime) : Get the result matching the request parameters.

Parameters and the filtering rules of the webservice:

Input Parameter getDisciplineList
• getDisciplineList(0) : Get the List with all Disciplines
• getDisciplineList(1) : Get the List with all Official Disciplines

Parameters DisciplineList
• Key : Key for WebService Call
• Name : Discipline Name
• Contest : True: Official Discipline / False: All Disciplines known to WebService
• Decimals : Number of decimals used for input of the result
• Time : Discipline result is Time:1 / Discipline result is Distance:0

Input Parameters calculateResult
• inpKey : Key from Discipline-List
• inpGender : Gender (Male:1-Female:2) of Athlete
• inpAge : Age of Athlete
•* inpDistance : Distance of Athlete's performance (in Meter)
•* inpPoints : Points of Athlete's performance
•* inpTime : Time of Athlete's performance (HH:MM:SS.SS)
*Only one of these Results must be filled, calculation depending on the Input

Output Parameters calculateResult
• OFm : Code witch discribes any errors that might have occured
0 : Result Calculated and returned in OutputDiscipline
1 : InputDiscipline not complete. Missing or invalidField is written in OrevaDistance.
2 : Combination Discipline/Gender/Age is Invalid.
3 : Points out of range.
4 : Distance out of range.
5 : Time out of range.
6 : Database Error Occured in the WebService. Please contact us.
7 : Combination Discipline/Gender/Age is Invalid. Please see Throwing devices and Age Categories
• OAgeCof : Age Coefficient
• OResDistance : Result in Distance for Athlete's performance
• OResPoints : Result in Points for Athlete's performance
• OResTime : Result in Time for Athlete's performance
• ORevaDistance : Real value Distance for performance <30
• ORevaTime : Real value Time for performance <30

 


2. WEB SERVICE DEFINITION

The Willems Webservice uses the SOAP 1.1 protocol.

The Webservice interface is defined in the WSDL file : WillemsService.wsdl

The List function should be used prior to the Calculate function in order to have the required input parameters for each Discipline.

 


3. WEB SERVICE CLIENT IMPLEMENTATION

The webservice client can be developed in any language able to send SOAP requests.

The client development must be driven by the WSDL file.

 
© 2010 by Flexor.eu. All Rights Reserved.