Page History
...
Denne guide har som formål at give et overblik over, hvordan behandlingsrelationsservicen (BRS) kaldes, samt hvorledes der hentes notifikationer fra opfølgninger med Notifikationsservicen.
Guiden indeholder beskrivelser af snitflader og forklaringer på de enkelte felter, eksempler på requests og responses.
Derudover indeholder guiden referencer til kodeeksempler (Java).
...
Nedenfor ses en liste af typiske fejl der kan forekomme når en service kaldes. Fejl der returneres indeholder en fejlkode samt en fejltekst med yderligere detaljer. Teksten er ikke medtaget i tabellen nedenfor da den kan variere afhængig af hvad der gav anledning til fejlen.
Kode | Betydning |
---|---|
processing_problem | Som oftest validerings fejl, kan dog også opstå ved en generel fejl i servicen. |
missing_required_header | En sikkerheds eller medcom header mangler i requestet |
security_level_failed | Authentification level som angivet i headeren er ikke tilstrækkelig til at tilgå servicen. |
invalid_idcard | Ugyldigt id-kort. |
expired_idcard | Id-kortet er udløbet. |
not_authorized | Manglende whitelisting (kontakt nsp operatøren for at blive whitelistet) |
Anchor | ||||
---|---|---|---|---|
|
...
Bemærk: NSP miljøernes loadbalancer router trafikken fra ovennævnte endpoint til brs-nsp/service/notification, idet dette er adressen i BRS2BRS.
Forespørgsel til Notifikationsservice
...
Anchor | ||||
---|---|---|---|---|
|
...
JAVA SEAL er et open source bibliotek, der kan håndtere SOSI IDKort, DGWS og integration til SOSI-STS. Biblioteket er dokumenteret på digitaliser.dk:
http://digitaliser.dk/group/374971
...
Request og response-eksemplerne ovenfor kan bruges som inspiration. Mange programmeringssprog har understøttelse for at danne kode udfra en snitfladebeskrivelse (WSDL). Det er op til anvenderen at finde en passende udviklingsstak og passende biblioteker, der kan hjælpe med denne proces.
Udover behovet for at kunne generere klientkode udfra en WSDL, så vil succesfuld anvendelse af BRS services kræve, at der medsendes gyldige akkreditiver (gyldigt SOSI Idkort) i kaldet.
Se feks: STS - Guide til anvendere samt SEAL.JAVA - Guide til anvendere og SEAL.NET Guide til anvendere
...
Der er udviklet testkode, der gør brug af JAVA SEAL biblioteket, sammen med JAXWS webservicestakken til at kalde de to services. Eksemplet kan bruges til at teste de forskellige service-håndtag fra ydersiden. Man kan med fordel tage udgangspunkt i eksemplet, når der implementeres en javabaseret webserviceklient, der gør brug af BRS og opfølgningsservicen.
Test-koden kan hentes fra projektet på nspop:
https://svn.nspop.dk/svn/components/brs
Hvor følgende klasse er indgangspunktet for at kalde behandlingsrelationsservicen production/src/main/java/dk/nsi/behandlingsrelationservice/BRSQueries.java
...
Seal.NET er et open source framework, der kan håndtere SOSI IDKort, DGWS og integration til SOSI-STS. Seal.NET er dokumenteret på digitaliser.dk:
http://digitaliser.dk/group/375117
Der er pt. ikke skrevet eksempelkode på at kalde de to services fra et .NET projekt, men der er WSDL'er til rådighed, som man kan anvende i Visual Studio's webservice wizard, kombineret med Seal.NET.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...