| Table of Contents |
|---|
...
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 abonnement 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
Abonnement system navn eller ID
WebhookURL
Abonnement 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
Abonnement system navn eller ID
WebhookURL
Abonnement 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 abonnement system i produktion eller beskrive et nyt abonnement 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:
| Code Block |
|---|
{
"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.
...
Hvordan får man oprettet abonnementer?
Oprettelse af abonnementer er 4. step på tjeklisten for at modtage WSB’er.
Kriteriet for at påbegynde oprettelse af sine abonnementer er følgende kategorier i tjeklisten er færdigbehandlet:
✅ Rekvirer STARs klientcertifikat og evt. IP adresser til whitelist
✅ Opsæt ønskede abonnementer (WebApi eller LSS brugergrænseflade)
Liste af WSB’er der kan oprettes abonnement på, samt hvilke WSRM’er de afløser:/wiki/spaces/GI/pages/4311220386
Detaljer om abonnementer og den nye model findes her: https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3950510658/Den+gode+WSB+webservicebesked#Abonnementsmodel
Oprettelse af abonnementer 2024-1 og 2024-2
Først skal dit abonnerendesystem/Subscribersystem (Step 3 på tjeklisten) have tildelt tilladelser til at oprette abonnementer.
Opret Topdesk sag og definér hvilke organisationskoder man ønsker at kunne modtage WSB’er på vegne af.
Der er ikke en template til oprettelse af abonnementtilladelser, men generelt er denne information brugbar for Systemforvaltningen.
Ønskede abonnementer:
Organisationskode (I tilfælde af at jeres systemer administrere flere akasser, kommuner eller jobcentrer)
Abonnerende system navn (Hvis der anvendes flere abonnerende systemer som kræver forskellige opsætning)
Tilladteabonnementer & Tilladtesystemabonnementer (Relevant for 2024-1 og 2024-2)
Star har brug for denne information på grund af hvordan WSBtilladelser fungerer.
Tilladelserne er todelt.
Tilladteabonnementer:
...
Tilladtesystemabonnementer:
Tilladelsen til at abonnere på en WSB kræver at ens abonnement 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
...
EntitetsNavn(Beskedtypenavn)
...
EntitetsId
...
Erstatter
...
“Jobcentertilknytning”
...
60000
...
/wiki/spaces/GI/pages/4041180511.GetPersonJobcenterVersion4
...
“AndenAktoerHenvisning”
...
60002
...
/wiki/spaces/GI/pages/4041180511.GetExternalOperatorReferralVersion1
/wiki/spaces/GI/pages/4041180511.GetCancelledExternalOperatorReferralVersion1
...
“Personkommentar”
...
60001
...
WsrmMessageService (Version 10).GetPersonStatusComment
...
“Jobcenteroplysninger”
...
70000
...
/wiki/spaces/GI/pages/4098392838.GetJobcenterContactInfoVersion1
...
“CvStatus”
...
30001
...
/wiki/spaces/GI/pages/4041475202.
...
“AfholdtSamtale”
...
90002
...
WsrmMessageService (version 10).GetPersonInterviewVersion9
WsrmMessageService (version 11).GetPersonInterviewVersion10
...
“Frist”
...
90001
...
WsrmMessageService (version 10). GetInterviewDeadlineVersion1
WsrmMessageService (version 10). GetInterviewDeadlineVersion2
...
“Indkaldelse”
...
90000
...
Indkaldelseshaendelse: IndkaldelseshaendelseTypeIdentifier [UDV] 2024-1
...
“EscoStar”
...
40000
...
/wiki/spaces/GI/pages/4098392838.GetEscoStarOccupationVersion1
...
“Aktivitetstillaeg”
...
100005
...
/wiki/spaces/GI/pages/4041180511.GetActivitySupplementVersion8
...
“Helbredsbegraensning”
...
100000
...
/wiki/spaces/GI/pages/4041180511.GetPersonHealthLimitationVersion4
/wiki/spaces/GI/pages/4041180511.GetPersonHealthLimitationVersion5
/wiki/spaces/GI/pages/4041180511.GetDeletedHealthLimitationVersion5
...
“Spoergeskema”
...
100005
...
Abonnementoprettelse 2024-3 og frem
Fra 2024-3 bliver WSB abonnement oprettelse simplificeret.
Eksternkommunikation.BeskedtypeService metoder der relaterer sig til TilladteSystemAbonnementer udgår.
Eksternkommunikation.BeskedtypeService
GetTilladteSystemAbonnementer
Metoden returnerer hvilke Beskedtyper man kan oprette abonnementer på for en bestemt organisationskode til sit abonnerende system.
Efter nøje overvejelse er det besluttet at fjerne tilladtesystemabonnementer fra WSB således, at man som ekstern kan oprette abonnementer på beskedtyper, der er tilladt for den organisationstype man tilhører(eller repræsenterer).
Det vil sige at der fra 2024-3 ikke længere skal oprettes bestillinger til Systemforvaltningen med henlblik på at tillade beskedtyper for sine abonnerende systemer i miljøerne eller i prærelease sammenhæng.
Denne ændring vil gøre det nemmere at oprette abonnementer på WSB'er og skabe større gennemsigtighed for, hvilke beskedtyper man kan oprette abonnementer på, fordi der ikke er uoverensstemmelse mellem beskedtyper, som er tilladte for organisationertyper og dem der er tilladt for et abonnerende system.
...
Administration af WSB via LSS fra 2024-3
Fra 2024-3 kan man oprette abonnementer på de tilladte WSB’er - se følgende sider: