Servicen er en SOAP-service, som er udviklet med Visual Studio C# på baggrund af Microsoft Communication Foundation (WCF) og .NET Framework 4.0.
Fremgangsmåden ved udviklingen af servicen har været ”kontrakt først” idet vejledningen ”OIOWSDL – Vejledning for udvikling og anvendelse af OIOWSDL” fra IT- og Telestyrelsen (januar 2008) er fulgt i forbindelse med udarbejdelse af servicens WSDL-beskrivelse.
Data, som er kodelister, hjælpelister og deres metadata, og som udstilles via denne service, er beskrevet i XML efter OIO-NDR 3.2 navngivnings- og designregler.
Skemaerne er ikke godkendt som OIOXML. Pt. kan skemaerne for version 1.0.0 findes på digitaliser.dk, men da digitaliser.dk er under udfasning vil der ikke blive foretaget opdateringer af skemaerne på dette sted.
Hvis nedenstående information ikke er tilstrækkelig, så kontakt Pia Grewy (email:pgj@bios.au.dk).
service.stancode.au.dk/1.0.0/service/
service.stancode.au.dk/2.0.0/service/
Servicen driftes af IT-afdelingen, AU-IT ved Aarhus Universitet.
service.stancode.au.dk/1.0.0/wsdl/
service.stancode.au.dk/2.0.0/wsdl/
Versionsnummeret i adressen på webservicen og dens WSDL er medtaget for at gøre det muligt at idriftsætte en ny version af servicen uden dermed at lukke for adgang til den eksisterende version. Dermed er det muligt at aftale en overgangsperiode mellem versioner, så der kan gives en rimelig frist til opdatering af klient-applikationer.
For at kunne hente en kodeliste, en hjælpeliste eller metadata skal man på forhånd kende identifikationsnumrene for de pågældende lister eller metadata. Denne information aflæses via Stancodes webside, der slår op i samme database som webservicen henter data fra. Siden findes på adressen:
http://dce.au.dk/overvaagning/stancode/stancodelister/
Den database som kodelister m.m. læses fra opdateres én gang i døgnet mellem 16:00 og 22:00. Laver man et batchjob, der via webservicen checker om der er kommet opdateringer til de kodelister man anvender, kan dette altså med fordel køres om aftenen efter 22:00.
Se kapitlet "Stancode webservicen" i Stancode dokumentationen. Find dokumentationen her: http://dce.au.dk/overvaagning/stancode/stancodedokumentation/
Versionerne 1.0.0 og 2.0.0 af webservicen har samme operationer og parametre. Ændringerne ligger i at nogle af XML-skemaerne er ændrede, idet oplysninger om kategorisering, forældelse af en kodeliste, samt GUID nu er med i datastrukturen.
Ved opsætning af en klient, der benytter Stancode webservicen kan det være nødvendigt at ændre nogle af default-værdierne i app.config filen. Vores foreløbige erfaringer viser at
Hvis der opstår fejl i webservicen returneres en SoapFault, f.eks. hvis der medsendes et ikke eksisterende kodeliste- eller versionsnummer.