Webservicebesked prærelease guide og WSB release skema

Denne side er henvendt til eksterne som ønsker at oprette abonnementer på WSB’er på henholdsvis produktion i et prærelease scenarie eller testmiljøer.

Siden indeholder også viden om opbygningen af WSB tilladelser og hvilke WSB der frigives i den kommende release.

Test

Hvis man ønsker et nyt abonnerende system, ændringer til eksisterende eller adgang til nye WSB på testmiljøerne bedes man oprette en Topdesk sag til SF med den ønskede information.

Ønsket abonnement(er):

• Beskedtype(Navn eller EntitetstypeId)

• Organisationskode

• Abonnerende system navn eller ID

• WebhookURL

Abonnerende system(er):

• Navn

• BaseUrl

• SystemNavn * (Fx. Modulus, KMD Momentum, Fasit)

* I tilfælde af at I har flere forskellige systemer må i meget gerne medgive denne.

Produktion(Prærelease)

Som ekstern har man mulighed for at oprette abonnementer på beskedtyper inden en release frigives på produktion.

For at gøre dette skal man oprette en TopDesk sag til SF inden deadlinen.

Deadlinen er 14dage inden releasen.

2024-1 Deadline: 01.03.2024

I sagen skal man beskrivefølgende:

Ønsket abonnement(er):

• Beskedtype(Navn eller EntitetstypeId)

• Organisationskode

• Abonnerende system navn eller ID

• WebhookURL
  

Abonnerende system(er):

• Navn

• BaseUrl
  

Hvis man allerede har oprettet sine ønskede abonnementer i et testmiljø kan man anvende “Vis opsætning som JSON” knappen under abonnementer på WSB siden via LSS(Se billede). Denne information skal kopieres og vedlægges i sagen. I dette tilfælde er der kun behov for at beskrive et eksisterende abonnerende system i produktion eller beskrive et nyt abonnerende system man ønsker skal anvendes til disse abonnementer(ligesom ovenstående eksempel tilskriver).

Vi anbefaler JSON opsætningen løsningen da det ensarter outputtet og dermed mindsker fejl.

Outputtet vil ligne følgende:

{
  "systemIdentifier": "7011c0b5-40c0-4431-ae65-33dab67a7002",
  "abonnementer": [
    {
      "organisationType": 8,
      "organisationskode": "79100",
      "entitetType": 100001,
      "webhookUrl": "test",
      "startDato": "2023-11-15T00:00:00",
      "slutDato": "2023-11-30T00:00:00"
    },
    [...]
  ]
}

Efterfølgende kan man følge sagen og holde sig opdateret om hvornår man kan oprette sine abonnementer via LSS eller de udstillede services.

Tilladteabonnementer & Tilladtesystemabonnementer

Star har brug for denne information på grund af hvordan WSBtilladelser fungerer.

Tilladelserne er todelt.

Tilladteabonnementer:

Vi har erfaret er der nemt kan opstå forvirring omkring denne da det er muligt at kalde “GetTilladteAbonnementer” via API’en. Men dette kald viser ikke det fulde billede.
WSB’er kan være tilladte for organisationstyper som kommune, jobcenter eller a-kasse, men dette betyder ikke at man kan oprette abonnementer på dem.

Tilladtesystemabonnementer:
Tilladelsen til at abonnere på en WSB kræver at ens abonnerende system har tilladelse til at oprette et abonnement på vegne af specifikke organisationskoder.

Det betyder at STAR har brug for information om hvilke abonnementer man ønsker at oprette på hvilket abonnement system så de kan tillades inden en release eller i testsammenhæng.

WSB release skema

Dette skema er en opsamling af EksternKommunikation WebServiceBesked (WSB) - Fysisk arkitektur - Confluence (atlassian.net)

Skemaet viser hvilke beskedtyper man forventer bliver tilgængelige i den kommende release og hvilke WSRM’er de erstatter.

2024-1