Præ-release af nye Webservicebeskedtyper (WSB)

Introduktion

Denne side er rettet mod Udviklere og Systemforvaltningen. Formålet med denne side er at beskrive flowet omkring Prærelease.

Prærelease betyder at vi gør webservicebeskeder tilgængelige i den nuværerende release så de eksterne har mulighed for at oprette deres WSB abonnementer inden den kommende releasen frigives. Dette gøres for at give de eksterne tid til at sætte deres abonnementer op så de kan modtage alle relevante WSB’er når releasen er klar på produktion.

VIGTIGT!
I 2024-3 bliver WSB databasestrukturen simplificeret således at TilladtesystemAbonnementer udgår.
Det betyder at eksterne kan oprette abonnementer på beskedtyper, der er tilladt for den organisationstype man tilhører(eller repræsenterer) uden at skulle oprette en sag til SF for at tillade WSB’er for deres abonnerende systemer til en specifik organisationskode.

Det vil også sige at op til 2024-4 releasen er mængden af arbejdsopgaver væsentligt reduceret.
Derfor vil denne side præsenterer to flows for prærelease.

• Flowet for Prærelease 2024-2 og 2024-3:

• Flowet for Prærelease 2024-4 og frem:

Flowet for Prærelease 2024-2 og 2024-3:

Open

I dette flow skal vi tillade organisationskoder for abonnerende systemer på WSB’er som frigives i den kommende release.

I tidligere prærelease flows har vi bedt de eksterne komme med lister af ønskede WSB’er til deres abonnerendesystemer, men fra 2024-2 og 2024-3 opretter vi blot tilladelser i linje med den fremtidige funktionalitet som implementeres i 2024-3.

Som beskrevet i introduktionen så bliver WSB db strukturen simplificeret, der betyder at man kan oprette abonnementer på vegne af hvilken somhelst organisationskode så længe WSB’en er tilladt for organisationstypen.
Da 2024-3 introducerer mindre restriktioner vil tilladtesystemabonnementer også blive behandlet mindre restriktivt indtil da.

Det vil sige at vi tillader alle WSB for abonnerende systemer på de organisationskoder som “giver mening”(for at undgå for mange permutationer af AbonnerendeSystem/Orgkode som ikke behøves).

De eksterne nævnes i dette flow, men vi har oprettet en separat side som beskriver deres steps.

Webservicebesked prærelease guide og WSB release skema - Fysisk arkitektur - Confluence (atlassian.net)

Udvikler:

Udarbejd script -

Udviklerne tager den information og klargøre et script til SF som opretter tilladelserne til prærelease.
Før 2024-1 blev der også oprettet abonnementer for de eksterne da LSS funktionaliteten ikke var tilgængelig. Dette reflekteres i dette script, men kan med fordel genbruges og rettes til behovene for den gældende release.
Scriptet skal oprette tilladelser for de abonnerende systemer som eksisterer i produktion og give adgang til alle WSB i den kommende release for de abonnerende systemer.

2023-4:

2024-2:

I denne er det besluttet at alle subscribersystems skal have adgang til alt inden for sin organisationstype.
Dermed er vi ikke afhængige af de eksternes ønsker til WSB’er.

De relevante tabeller er:

• SubscriberSystem - Abonnerende systemer

• PermittedSystemMessageTypeSubscription - Tiladteabonnementer

• PermittedMessageTypeSubscription - Tilladtesystemabonnementer (udgår efter 2024-3)

• EntityType 

• MessageType

Disse scripts skal laves så virker på den nuværende release i produktion det vil sige at hvis der er sket ændringer i tabeller eller lignende skal det passe sammen med den release og ikke den kommende release.

Test på stafetmiljø:

• Sæt et Stafetmiljø til den nuværende release og kør scripts på.

  • Test at man kan se de abonnerende systemer i LSS og man ligeledes kan oprette abonnementer fra perspektivet af en ekstern.

    • Oprettelse af abonnementer kan ske via LSS eller API.

• Opgradér stafetmiljøet til den kommende release.

  • Tjek at abonnerende systemer og oprettede abonnementer stadig eksisterer både eksisterende og nyoprettede fra første step.

Efter test skal scriptet og eventuelle ekstra filer sendes til SF til oprettelse på produktion.

SF:

Kør script på produktion

Udvikler:

De eksterne skal informeres at det nu er muligt at oprette abonnementer på de kommende WSB’er

Dette gøres via denne side: https://starwiki.atlassian.net/wiki/x/SABrCgE

Flowet for Prærelease 2024-4 og frem:

Open

Udvikler:
Efter 2024-3 er tilladtesystemabonnementer udgået, det vil sige at prærelease blot kræver de migrations der er oprettet som relaterer sig til nye WSB typer til den kommende release.
R02 ligger efter ekstern aflevering hvilket vil sige at alle WSB’er burde være klar.
Hvis dette ikke er tilfældet kan man stadig scripte dem på produktion efter aftale med SF.

Derfor går vi fra at skulle scripte WSB’erne tilproduktion til blot at cherrypick migrations med disse baseklasser:

• AddWebServiceMessageBase

• AddPermittedMessageTypeBase

• AddEntityTypeBase
  
  

VIGTIGT!

Tjek om der er potentielle Alters til de relevante WSB migrations som skal tages med.

Disse migrations skal med i R02 således de bliver tilgængelige inden releasen.

Udvikler:
Så snart SF har deployed R02 skal de eksterne informeres om at de nu kan oprette deres abonnementer på de beskedtyper der frigives i den nye release.
Dette gøres via https://starwiki.atlassian.net/wiki/x/SABrCgE