MDWS TRACES Metadata Webservice (Cities and Organisations) Presentation to IT Expert group meeting Brussels 28/3 2014

Overview of presentation Introduction and background Technical details Data dictionary Concrete advise for developing a client Conclusions and Future

MDWS TRACES Metadata Webservice (Cities and Organisations) Introduction and background

Architecture Part of TRACES system Allow MS to align TRACES with national DBs SOAP Protocol

Overview Users Possibility to manage organisations and cities: EU Member states EU competent authorities (CCA, RCA) Possibility to manage organisations and cities: Avoid use of XLS files Real time modifications with simple WS calls Possibility to fully manage EU listed establishments (as of version 5.30 of traces)

Why exchange Cities by webservice? Realtime approach – immediate result and feedback Avoid risk of errors due to conversions and templates used Support for GIS coordinates Reduce administrative overhead (Excel conversion @ SANCO)

And why exchange Organisations? Avoid duplicated establishments Very often duplication occurs due to manual input of data Manual input can be disabled when MDWS is in use by the MS Synchronize TRACES with national DB Ensure MS CCA/RCA has exclusive control of establishments

Operation supported Simple CRUD operations Single operation Support for batch operation (max 1000 per call) TRACES: TRACES offload in MDWS XML format Listing of reference data Establishment types Business categories and chapters According to relevant legislation

MDWS TRACES Metadata Webservice (Cities and Organisations) Technical details

Cities data dictionary XMLGate WS Call MDWS WS Call

Data Dictionary: CityType Example

Test case - cities Scenario 1: Scenario 2: Reorganisation of postal codes Modification of GPS locations Scenario 2: Administrative changes – LVU offices closing, merging

Test cases – cities reorganisation Excel file XTC format … with GPS locations

Organisations data dictionary XMLGate WS Call MDWS WS Call

Data Dictionary: BusinessType

Data Dictionary: Transport Authorization Business approval

Data Dictionary: LMS Type

Test case – create an organisations Listed establishment types Address Transport auth. Means of transport Business approval

Some practical advise Known to work with: Java (JAX-WS, Spring-WS, Axis2), .NET First establish connectivity and basic tests: SOAPUI: Run the test cases available on CIRCABC website "TRACES Toolkit -> MANUALS -> XTB" Or run the SimpleClient Java program from HOWTO bundle Then develop your interface Start with managing a very limited set of organisations that can be easily checked and corrected manually if needed

Trouble shooting Error codes: "SXG…" means XMLGate related error "XTB" or "XTC" means application level error

MDWS TRACES Metadata Webservice (Cities and Organisations) Conclusions

Current Planning Support the launch of MDWS Help MS implement clients Maintain and evolve according to feedback Phase out Excel-based exchange for cities Eliminate risk of problems due to templates and conversions used