1005.20.7 WSB'er - webservicebeskeder til nye REST services 2024-3

Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning





STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

Epic status

Eksterne snitflader

STAR Projektleder (PL)

Forretningsanalytiker (FA)

STAR Release
tilgængeligt i test

STAR Release
start ibrugtagning

STAR Release
seneste ibrugtagning

Epic status

Eksterne snitflader

@Knud de Place (STAR)

@Jens Andersen

@Jesper Brunholm

@Carsten Olsen

2024-3



2024-3

2024-3

0.3

KSS, A-kasse




Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.

Dato

Version

Hvem

Hvad er ændret?

Dato

Version

Hvem

Hvad er ændret?

11-09-2023

0.1

Carsten Olsen

Oprettelse

17.05.2024

0.1

Jesper Brunholm

TilladteSystemAbonnementer ændring

10.06.2024

0.3

Jesper

Tilsagnsklar med indlagt snitflader mm

24.06.2024

0.3

Knud

Under “Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader“: “og a-kasse” tilføjet på baggrund af indkomne tilsagnsbemærkninger. Endvidere., at overgangsperiode for brug af WSRM ikke er aftalt.

02.07.2024

0.3

Jesper

AC 1: Moededeltagelsesvalgshistorik medtager også deltagelsesvalgIdentifier i v2 af IndkaldelseService



Interne links (indhold i links ikke relevant for eksterne)

key status labels
Loading...
Refresh

https://starwiki.atlassian.net/browse/PLAN-1161

https://starwiki.atlassian.net/browse/BI-4880



Indholdsfortegnelse






Afgrænsning af epic

Afgrænsning

Afgrænsning

Som serviceaftager og STAR

vil jeg have etableres først del af webservicebeskeder (WSB) på de allerede omlagte REST service  som en del af STAR's moderniseringsprogram

for at sikre at DFDG lever op til STARs principper omkring en moderne og vedligeholdelsesvenlig IT-portefølje samt udfaser end of life teknologi. 

Acceptkriterier







Nr.

Beskrivelse

Relevant for

US

1005.20.7.1

Som serviceaftager og STAR vil jeg have etableret følgende webservicebeskeder (WSB) i denne release

  • Moededeltagelse (GetMeetingParticipation)

DFDG



 

1005.20.7.2

Som serviceaftager og STAR vil jeg i en overgangsperiode kunne forsat modtage WSRM beskeder på de omlagte webservicebeskeder (WSB)

DFDG



1005.20.7.3

Som STAR vil jeg have at dokumentation for WSB lever op til STAR's principper på releasetidspunktet

DFDG



1005.20.7.4

Som STAR vil jeg have forenklet WSB abonnementerne så der ikke er behov for at definere hvilke abonnementer et system har lov til at tegne

DFDG

https://starwiki.atlassian.net/browse/KON-3703

1005.20.7.5

Som STAR og aftager ønsker jeg opdatering af WSB-dokumentation, herunder ift. pre-release

DFDG

https://starwiki.atlassian.net/browse/KON-3582

 

 

 

 

Pakke WEBBESK-1 i roadmap



Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger



1005.20.7.1

1005.20.7.2







Som KSS og a-kasse skal jeg overgå til ny WSB, men kan i en overgangsperiode fortsat anvende WSRM beskeder

X

X





24.06.2024:

Overgangsperiode er ikke aftalt, men STAR vil gerne udfase WSRM’er i senest 2025-2

24.06.2024: “og a-kasse” tilføjet på baggrund af indkomne tilsagnsbemærkninger

Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.

(kopiér og indsæt manuelt i tabellen)

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

Summary

Varslingstype

Varslingsnote

Eksterne Snitflader

Interne Snitflader

Project

EksternKommunikation.BeskedtypeService (v1).GetTilladteSystemAbonnementer

Udgået

Metoden udfases da løsningen er opgraderet til at den ikke behøves

A-kasse(f), KSS(f)

N/A

Kontaktforløb

IndkaldelseService (v2). GetSpecifiktDeltagelsesvalg

Ny

Ny metode til at udtrække mødedeltagelsesvalg ved WSB modtagelse

A-kasse(f), KSS(f)

N/A

Kontaktforløb

Moededeltagelsesvalg.wsb

Ny

Ny WSB om mødedeltagelsesvalg, erstatter WSRM GetMeetingParticipation. WSRM kan bruges i en overgangsperiode

A-kasse(f), KSS(f)

N/A

Kontaktforløb

IndkaldelseService (v2).GetDeltagelsesvalg

Ændret

Metoden udvides til at medtage id for deltagelsesvalg

A-kasse(f), KSS(f)

N/A

Kontaktforløb

IndkaldelseService (v2).GetDeltagelsesvalgshistorik

Ændret

Metoden udvides til at medtage id for deltagelsesvalg

A-kasse(f), KSS(f)

N/A

Kontaktforløb

[02.07.2024 Ovenstående tabel opdateret]

Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.

summary Varslingstype Varslingsnote Eksterne snitflader Interne Snitflader project
Loading...
Refresh

 

Beskrivelse af epic

Baggrund

Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til forsørgelseshistorik følgende:

  • I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer

  • I Jobnet en overgang til ny REST snitflade samt ny frontend arkitektur (denne opgave er ikke en del af denne epic, men vil blive specificeret i en efterfølgende epic)  

Regler

Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.

Det er ingen indberetningsregler i denne epic, da der alene er tale om GET metoder.



Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer

Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Serviceaftager skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 202X-X) forblive på eksisterende SOAP service således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.

Perioden kan dog ændres, hvis der efterfølgende kommer forretningsændringer til servicen. En sådan efterfølgende ændring af perioden, vil fremgå i epic med de nye forretningsændringer.



1005.20.7.1 - Som serviceaftager og STAR vil jeg have etableret følgende webservicebeskeder (WSB) i denne release

Som serviceaftager og STAR vil jeg have etableret følgende webservicebeskeder (WSB) i denne release

  • Moededeltagelsesvalg

Moededeltagelsesvalg (tidl. WSRM GetMeetingParticipation)

Ny WSB “Moededeltagelsesvalg” med besked om at a-kasse, borger (via a-kasse eller jobcenter) eller STAR (ved nulstilling efter afholdt Jobsamtale) har opdateret mødedeltagelsesvalg

Aht. understøttelse af hentning laves ny id-specifik get-metode GetSpecifiktDeltagelsesvalg på IndkaldelseService: Kontaktforloeb.IndkaldelseService [UDV](Version 2, 2024-3) | GetSpecifiktDeltagelsesvalg (GET /v1/Indkaldelse/deltagelsesvalg){deltagelsesva...

[02.07.2024]: Ydermere aht. understøttelse af udhentning: Moededeltagelsesvalgshistorik medtager også deltagelsesvalgIdentifier i v2 af IndkaldelseService

1005.20.7.4 - Som STAR vil jeg have forenklet WSB abonnementerne så der ikke er behov for at definere hvilke abonnementer et system har lov til at tegne

STAR vil jeg have forenklet WSB abonnementerne så man som ekstern kan oprette abonnementer på beskedtyper, der er tilladt for den organisationstype man tilhører(eller repræsenterer).

Det vil sige at efter 2024-3 frigives er der ikke behov for bestillinger til SF angående at tillade beskedtyper for sine abonnerende systemer i miljøerne eller i en 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.

Baggrunden for ændringen er at den nuværende databasemodel er meget restriktiv og skaber ekstra arbejde for både aftagere og interne. Hensigten med denne simplificering er at man ikke skal tillade beskedtyper pr system for hver enkelt organisationskode. I stedet skal beskedtypen blot være tilladt for den pågældende organisationstype i PermittedMessageTypeSubscription

EksternKommunikation.BeskedtypeService (Version 1, 2023-4)#GetTilladteSystemAbonnementer-(GET-/v1/Beskedtype/tilladtsystemabonnement)


1005.20.7.5 - Som STAR og aftager ønsker jeg opdatering af WSB-dokumentation, herunder ift. pre-release

Som STAR og aftager ønsker jeg opdatering af WSB-dokumentation, herunder ift. pre-release

  • Dokumentationen på tjekliste for eksterne ift. WSB udbygges med links til især links til pre-relase men også øvrige materialer om, hvordan man får oprettet abonnement

  • Pre-release dokumentationen bliver udskilt fra den generelle dokumentation om abonnementsoprettelse

Løsning

Følgende Confluence-sider er opdateret:

Webservicebesked (WSB) administration i LSS for eksterne
https://starwiki.atlassian.net/wiki/x/OIDpCQE
Webservicebesked (WSB) abonnementsoprettelser frem til 2024-3archived
Webservicebesked (WSB) Præ-release varslingerarchived

Præ-release af nye Webservicebeskedtyper (WSB)

Tjekliste modernisering DFDG:

  • DFDG

    • Services

      • Er pakken af service snittet jf. behov i DFDG, Jobnet, eksterne m.f.

      • Er der behov for at bevare SOAP snitfladen

      • Er dansk navngivning QA'et

      • Er der teknisk gæld eller andet der skal rettes op på (evt. spike til team/arkitekt for at identificerer)

    • Konvertering

      • Initielt load / konvertering og i hvilke siloer

    • WSRM'er

      • Skal eksisterende WSRM udsendes og hvor længe

      • Skal ny besked etableres nu eller senere

    • Kodelister, er disse flyttet til ejende domæne, er der lavet slavekodelister

    • Eventbroker

      • Er nye beskeder der skal etableres, QA af indehold og navngivning

      • Er det dokumenteret hvilke beskeder, der anvendes, og hvilke forretningsregler der er i den forbindelse

    • StatusService

      • Udfasning i PersonStatusService (PSS) 

      • Udvidelser til domænespecifikke statusservices

      • Udfasning i PersonHistoryService (PHS)

      • Udvidelse til domænespecifikke historik services

    • LSS (Landssupportsystem) og/eller Datakanon og herunder Registerudtræk (hvis STAR har dataejerskab)

    • Datamonitor. ny eller ændret overvågninger

    • Dokumentation

      • QA i forhold til at alle forretningsregler / fejlkode er tilstede

      • Dokumentation følger nye principper

  • Nye batchjobs / ændret behandling af events

    • Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon) 

  • Dataløft

    • Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.

  • Ændringer i forhold til aflevering at Rigsarkivet

  • GDPR sletninger m.v.

  • Interne afhængigheder indenitfiseret (Jobnet, VITAS, JobAG, BI integrationsplatform andre domæner m.v.)

  • Eksterne afhængigheder indenitfiseret (Kommunalt sagsbehandlingssystem, A-kasse sagsbehandlingssystem, Kommunalt bookingsystem (WorkForcePlanner (WFP), M4 Booking, Schultz Booking). Kommunalt ydelsessystem (KY), Kommunalt sygedagpengesystem (KSD), EG kommune informatiom m.fl.)

Særlige krav til test

Test scenarie

Berørte systemområder (herunder nye batchjobs*) 

Identificeret af

Test scenarie

Berørte systemområder (herunder nye batchjobs*) 

Identificeret af



















* Batchjobs

  • bør testes både med delta og fuldt load,

  • bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden

  • bør testes i samarbejde med teams som har afhængigheder

  • kørselstid, særligt hvis det er en del af NightlyBatch

Konsekvenser for drift/idriftsættelse

I forbindelse med idriftsættelse:

  • Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres:  

  • Skal der køres konvertering:  

  • Skal der køres databasescripts for opdatering af tabeller i databasen:  

BI foretager initial load af forsørgelseshistorik i ydelsesudstilling silo. Der er ikke tale om konvertering i denne forbindelse da det er samme loadmodel som i den gamle forsørgelseshistorik på DFDG classic.

Efter idriftsættelse:

N/A

Arkitektur- og implementeringsnoter 

Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:

  • Nye dataområder: Nej, flytning til domæne Ydelsesudstilling 

  • Nye snitflader: Nej, flytning til domæne Ydelsesudstilling

  • Nye komponenter: Nej 

  • Nye miljøer: Nej 

  • Nye teknologier: Modernisering 

  • Nye aftagertyper: Nej 

  • Eller afvigelser fra principperne: Nej 

  • Eventuelle behov for reduktion af teknisk gæld skal afdækkes: N/A 



Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.

Husk GDPR stillingtagen

Ingen personfølsomme data i epics

Illustrationer, skærmdumps m.v. må ikke indeholde cpr.nr., CV. nr., rigtige personnavne på borgere eller deres kontaktoplysninger i form af e-mail, telefonnr., adresse m.v.

 Ja, det er tjekket, at epic ikke indeholder dette.
  • Angiv hvem der har foretaget dette tjek: 

  • Angiv dato for tjek: 

Opbevaring af oplysninger i STARs it-systemer

Ved oprettelse af nye dataområder skal der tages stilling til, hvornår formålet med data ophører og dermed fastlægges en slettepolitik.

Ved indførelse af nye data på eksisterende dataområder skal GDPR slettejobs opdateres.

Dette er ikke et nyt dataområde blot en flytning fra DFDG classic og til XXXXX

Hvem må tilgå oplysningerne?

Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.

Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.  

Korrekte sikkerhedsattributter på services

PO skal for hver enkelt servicemetode angive hvilke myndighedstyper, der må kalde de forskellige servicemetoder.

Tilladte organisationer (eksempel - se den fulde liste over myndighedstyper på siden DFDGs sikkerhedsmodel )



Alle borgere

Egne borgere

Tidligere egne borgere

Gæsteadgang

Anden Aktør - egne borgere

Anden Aktør - gæsteadgang



Alle borgere

Egne borgere

Tidligere egne borgere

Gæsteadgang

Anden Aktør - egne borgere

Anden Aktør - gæsteadgang

A-kasse



X









JobCenter



X





X



Kommune



X









STAR

X











AUB













UDK













STIL















A-kasse filtrering

Hvis a-kassen må anvende metoden, må a-kassen så se / hente alle data? Eller skal der foretages filtrering ift. at a-kassen fx kun må se nogle udfaldsrum / kodelisteværdier? Husk at filtreringen skal ramme eventuel visning på Jobnet aht. sagsbehandlerlogin

XXXXX

Sagsbehandlerlogin på Jobnet - tag stilling til adgang!

En sagsbehandler i et jobcenter kan tilgå en borger tilknyttet det konkrete jobcenter.

En sagsbehandler i en a-kasse kan tilgå en borger, som er medlem af a-kassen og KG 1 (tilmeldt og ikke-tilmeldt) eller KG 8 og tilmeldekategori 5 - dimittend.

Begrænsninger kan foretages via (a-kasse-) filtrering, eller ved at afgrænse på action niveau på konkrete sider på Jobnet.

Stillingtagen: Beskriv kort, at der er taget stilling til sagsbehandlerlogin

XXXXX