Page History

...

Nedenstående er en tabel over endpoints for de forskellige services. 

Idlist har 2 wsdl endpoints. Forskellen på de 2 endpoints er alene at  for 20251030 versionen har elementet FixedTopicSet ikke default værdien true. Udviklere der anvender .Net anbefales at bruge 20251030 versionen.

Topics

Inden der kan leveres adviseringer til et Topic skal dette eksplicit oprettes. Dette sker gennem en supporthenvendelse oprettet på nspop.dk.

Bemærk: Der skal indgås 'Tilslutningsaftale: - Specifikke vilkår for oprettelse af NAS 2.0 Topics, med opfyldelse navnestandard m.v. Venligst kontakt af NSP-Operatør på operator@nspop.dk

Navnet på alle Topics der ønskes oprettet skal følge denne skabelon:

...

Afsendersnitfladen er ikke for nuværende beskyttet af DGWS, og dermed sker sikkerhed på baggrund af IP whitelisting og det faktum at topic skal være oprettet i systemet for at det er muligt at afsende adviseringer.
Det vil dog overgå til at DGWS bliver påkrævet, og afsendere bør opdatere deres systemer til at håndtere dette, så man optager et token i STS'en inden man kalder nedenstående snitflader.  
Hvis der er DGWS headers på kaldet vil disse blive verificeret. Hvis de ikke er inkluderet, vil requests gå igennem uden tjek, så længe det endnu ikke er påkrævet. 

...

Adviseringsservicens abonnent-snitflade anvender fødereret sikkerhed og kræver Den Gode Webservice 1.0.1-ID-kort på minimum niveau 3. Derfor skal EOJ-systemet indhente et ID-kort signereret af STS’en, der kan anvendes i kald af abonnent-snitfladens operationer. Denne del er ikke med i nedenstående beskrivelser og eksempler da det antages at anvender har kendskab til DGWS. 
Bemærk, at der for adgang til Topics med whitelisting, kræves at ID-kortet er fra NewSecurityTokenService (ID-kort fra den tidligere anvendte SecurityTokenService kan ikke give adgang).

Anvendersystem opretter en id-liste

Der oprettes en CPR-nummer-baseret id-liste.

I anvendelse af id-listen herunder er det navnet (Name elementet) på id-listen, der indgår som kald-parameter.

Snitflade

Dette er ikke en del af WS-notification og derfor er hele snitfladen dokumenteret nedenfor. Det er CreateIDList operationen i IDList servicen der kaldes. 

Oprettelse af ID liste sker ved hjælp af CreateIDListRequest elementet.

...

Anvendersystemet kan opdatere sin id-liste løbende. Identifikation af ID listen er det navn som der er anvendt da listen blev oprettet. Er id-listen (som her) anvendt i et abonnement, betyder det, når adviseringer efterfølgende afhentes er det den nye id liste der evalueres op mod. Opdatering sker ved at alle eksisterende ID'er slettes og de nye indsættes. 

...

Request består af nedenstående.  Bemærk at den subscription der ønskes nedlagt refereres via sidste del ag URL'en.

...

Når et anvendersystem ikke længere anvender et pullpoint kan det nedlægges med DestroyPullPoint operationen. Bemærk at pull point id anvendes som en del af endpoint når servicen den kaldes. 

For at det er muligt at nedlægge et pull point må der IKKE være nogle subscriptions tilknyttet. Hvis der er dette returneres der en fejl til kalder. 

Snitflade

Dette er operationen DestroyPullPoint på PullPoint der kaldes. I WS-notification hedder operationen DestroyPullPoint. 

Request består af nedenstående. Bemærk at det pull point der ønskes nedlagt refereres via sidste del af URL'en. 

...

Når en ID liste ikke længere er tilknyttet en eller flere subscriptions kan det slettes med nedenstående kald. I svaret er der en indikation af om ID listen den fandtes eller ej.

Snitflade

Dette er operationen DestroyIDList på IDList der kaldes. Dette er ikke en del af WS-Notification.

Request består af nedenstående. 

...

Hvis et anvender system får brug at hente allerede afhentede notifikationer igen er det muligt at spole en given subscription tilbage til et givent tidspunkt. Det kan f.eks. være nødvendigt hvis en anvender har mistet data. NAS gemmer med jævne mellemrum hvor langt alle subscriptions er nået og der spoles tilbage til et tidspunkt umiddelbart før det ønskede tidspunkt.

Bemærk at der ikke kan spoles tilbage til et tidspunkt hvor data ikke længere er tilgængelige i NAS. Forsøger man alligevel får man returneret en fejl med mindste mulige tidspunkt. Selvom man spoler tilbage til det tidligst mulige tidspunkt så er der stadig risiko for at man ikke kan hente data da data kan være blevet slettet i det tidsrum man kalder RewindSubscription servicen og man kalder GetMessages.

Snitflade

Dette er operationen RewindSubscription på RewindSubscriptionServicen  der kaldes. Servicen den udstilles af SubscriptionManager servicen.  Dette er ikke en del af WS-Notification.

Request består af nedenstående. 

...