Denne epic er første del af etablering af webservicebeskeder for del 2 Denne epic er første del af etablering af webservicebeskeder. For del 2 se 1005.20.2 Webservicebeskeder (Tidl. WSRM) - Pilot til afsendelse og modtagelse med serviceaftager @2023-3 for . For del tre se 1005.20.3 Webservicebeskeder (Tidl. WSRM) - Drift af på udvalgte afsendelser og modtagelser med serviceaftager @2023-4

...

...

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

Anvendes ved ændringer, der har betydning for eksterne.

...

DFDG epic.

Husk evt. BI epic

Indholdsfortegnelse

...

Afgrænsning af epic

Pakke EXBESKED-1 i DFDG moderniserings og forretnings roadmap for serviceaftagere

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

Automatisk oversigt

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

Beskrivelse af epic

Baggrund

Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til afsendelse af webservicebeskeder, som på sigt erstatter WSRM beskeder følgende:

• Etablering og test af infrastruktur til afsendelse og modtagelse af webservicebeskeder
  Release 2023-1 - Denne epic

• Pilotimplementering hos serviceaftager af ny webservicebesked model således model serviceaftager kan modtage og behandle webservicebeskeder inkl. abonnementsmodel
  Release 2023-2 - Epic 1005.20.2 Webservicebeskeder (Tidl. WSRM) - Pilot til afsendelse og modtagelse med serviceaftager @2023-3  

• Udrulning af
  Release 2023-3 - Epic 1005.20.3 Webservicebeskeder (Tidl. WSRM) - Drift af på udvalgte afsendelser og modtagelser med serviceaftager @2023-4

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.

Acc.kr. 1005.20.1.1 - Som STAR vil jeg have etableret en logisk og fysisk datamodel til webservicebeskeder og for udvalgt(e) beskede(r) eventreciever til forretningsområdet Webservicebeskeder i forretningsdomænet (silo) Eksternkommunikation inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

• Etablering af database i XXXXX

Acc.kr. 1005.17.X.2 - Som serviceaftager og STAR vil jeg have udstillet XXXXX  via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service

Løsningsmodel

• Ny REST service og getmetode i XXXXX 

• Fejlkoder bevares

• Der ændres ikke i adgangsforhold til service/metoder 

XXXXX.XXXXX LINK  

Ny REST service til udstillings af XXXXX .

XXXXX.XXXXX

Ny metode til at hente XXXXX

Acc.kr. 1005.17.X.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade

Løsningsmodel

• Eksisterende SOAP bevares som kalder mod ny getmetode 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2023-4.

XXXXX.XXXXX LINK

Udgår til fordel for XXXXX.XXXXX LINK. Servicen bevares som SOAP snitflade i en overgangsperiode til og med 202X-X, da der ikke forventes ændringer i den periode. 

Acc.kr. 1005.17.X.4 - Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til nye forretningsdomæne (silo)

Løsningsmodel (internt STAR acc.kr.)

• Initial load af data / Tilpasning af BI load til XXXXX domænet (silo)

• Data kommer fra VOA

Acc.kr. 1005.17.X.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet

Løsningsmodel (internt STAR acc.kr.)

• QA af regler fra kode mod dokumenteret regler og fejlkode

• Ajourfører dokumentation

Sider der skal rettes og QA er (liste er ikke udtømmende)

• Servicesnitflade 

Acc.kr. 1005.17.X.6 - Som STAR vil jeg have data er omfattet af dataløft og annonysering mod testmiljøer

Løsningsmodel (internt STAR acc.kr.)

• Tilpasning af regler af for anonymisering og aftale hvornår data skal med i dataløft

• Systemforvalter til retter anonymiseringsflow 

Acc.kr. 1005.17.X.7 Ydelsesudstilling udstiller kodelisterne ForsoergelseshistorikKategoriCodeList og ForsoergelseshistorikomraadeCodeList i Ydelsesudstilling.CodeListService

Løsningsmodel 

• DFDG udstille kodelister for XXXXX 

XXXXX.XXXXX LINK

Kodeliste flytte 1 til 1 fra SustenanceHistoryCategoryTypeIdentifier

Acc.kr. 1005.17.1.8 /wiki/spaces/GI/pages/3690397697 udstiller ikke mere XXXXX . I stedet returneres en tom liste

/wiki/spaces/GI/pages/3690397697

GetVariablePersonStatus

Udstiller ikke mere XXXXX. I stedet returneres en tom liste

...

Pakke EXBESKED-1 i DFDG moderniserings og forretnings roadmap for serviceaftagere

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)

Automatisk oversigt

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

Beskrivelse af epic

Baggrund

Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til afsendelse af webservicebeskeder, som på sigt erstatter WSRM beskeder følgende:

• Etablering og test af infrastruktur til afsendelse og modtagelse af webservicebeskeder
  Release 2023-1 - Denne epic

• Pilotimplementering hos serviceaftager af ny webservicebesked model således serviceaftager kan modtage og behandle webservicebeskeder inkl. abonnementsmodel
  Release 2023-2 - Epic 1005.20.2 Webservicebeskeder (Tidl. WSRM) - Pilot til afsendelse og modtagelse med serviceaftager @2023-3  

• Udrulning af webervicebeskeder
  Release 2023-3 - Epic 1005.20.3 Webservicebeskeder (Tidl. WSRM) - Drift af på udvalgte afsendelser og modtagelser med serviceaftager @2023-4

Regler

Det er ingen indberetningsregler i denne epic, da der alene er tale om afsendelse af webservicebeskeder.

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

Serviceaftager forventes ikke at blive påvirket implementeringemæssige af denne epic. Dette vil først ske i 2023-3 med epic 1005.20.2 Webservicebeskeder (Tidl. WSRM) - Pilot til afsendelse og modtagelse med serviceaftager @2023-3

Bemærk: Hvis der er serviceaftager, der gerne vil involveres i noget test allerede i relation til denne epic og 2023-2, kunne dette være muligt, men vil kræve dette aftales med STAR, da denne epic umiddelbart er tænkt til at være intern STAR.

1005.20.1.1 - Som STAR vil jeg have etableret en logisk og fysisk datamodel til webservicebeskeder og for udvalgt(e) beskede(r) eventreciever til forretningsområdet Webservicebeskeder i forretningsdomænet (silo) Eksternkommunikation inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

• Etablering af database i Eksternkommunikation, der indeholder de webservicebeskeder, der skal afsendes og er blevet afsendt

• Der laves en model for, hvordan domæner skal rejse et event, der skal udløst en webservicebesked

• Der etableres eventreciever, der modtager event og gemmer data til afsendelse

• Der etableres push funktionalitet

• Der er etableret skemavalidering af beskeden

1005.20.1.2 - Som STAR vil jeg have etableret en logisk og fysisk datamodel til styring af afsendelse samt afsendelse af besked

Løsningsmodel (internt STAR acc.kr.)

• Etablering af abonnement/styringsdatabase i Eksternkommunikation der indeholder de styringsdata der bestemmer webservicebesked afsendelsen (evt. kun de relevante data for vi kan udfører denne epic)

• Der etableres/justeres push funktionalitet se også 1005.20.1.1 så man kan push i forhold til abonnement

1005.20.1.3 - Som STAR vil jeg have etableret et endpoint hvor STAR selv kan modtage webservicebeskeder

Løsningsmodel

• Der etableres et STAR endpoint som STAR kan test modtagelse af webservicebeskeder på

• Der skal sættes et abonnement plus en test-tilslutningsaftale op til dette endpoint

1005.20.1.4 - Som STAR vil jeg have implementeret mindst én tværgående test (Cross Domain Test), der tester, at det tværgående testrammeværk kan modtage og verificere en given Webservicebesked

Løsningsmodel (internt STAR acc.kr.)

• Der etableres tværgående test vha. det nye tværgående testrammeværk der:

  • Generet en hændelse i en silo, der udløser en eventbesked på eventbroker

  • Det tester at event rammer ekstern kommunikation og ligger i DB

  • Det testes, at der kommer en webservicebesked ud på det forventede endpoint med korrekt indhold

  • Det testes, at beskeden kan aftages og ekstern kommunikation registrerer beskeden er modtaget korrekt

• Der etableres tværgående test vha. det nye tværgående testrammeværk der:

  • Tester ikke happy day scenarier inkl. fejlende webservicebeskeder

  • Hvis webhook er nede eller fejler

1005.20.1.5 - Som STAR vil jeg have at webservicebeskeder løsningen er robust og understøtter genfremsendelse af fejlede webservicebeskeder

Løsningsmodel (internt STAR acc.kr.)

• XXXXX modtager persondata via ny event receiver 

Acc.kr. 1005.17.1.10 Død kode i DFDG, i forbindelse med forsørgelseshistorik, fjernes

Løsningsmodel (internt STAR acc.kr.)

• Fjernelse af gammel og død kode i DFDG classic

Acc.kr. 1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i XXXXX, i stedet for XXXXX

Løsningsmodel (internt STAR acc.kr.)

• Landssupport/LSS er skiftet til at brug XXXXX ved brug af nyt ClientApi fra XXXXX.

• Kode brugt i forbindelse med XXXXX er fjernet fra LSS

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.)

• Der er implementeret en model, som kontrollerer, at webhooket returnerer http status kode 2xx. Hvis ikke gensendes beskeden med en konfigurerbar vente-algoritme.

• Genafsendelse skal aldrig stoppe

1005.20.1.6 - Som STAR vil jeg have at webservicebeskeder løsning er robust og understøtter fremsendelse af allerede fremsendte on demand fra aftager

Dette anvendes f.eks. hvis en serviceaftager skifter system, der så skal synkroniseres med DFDG eller der er sket en fejl i aftagesystem, hvor det mangler nogle beskeder

Løsningsmodel

•  Der etableres en servicesnitflade, hvor man for en given person kan får gensendt allerede afsendte webservicebeskeder for en given periode (max 6 md tilbage)

1005.20.1.7 - Som STAR vil jeg have at webservicebeskeder løsning understøtter logning

Løsningsmodel 

• Der etableres logning af alle pushbeskeder inkl. at de er modtaget (behandlet) at aftager

• Hver genafsendelse skal logges

• Logningen skal i denne iteration ske via star.foundations log4net da EksternKommunikation hostes hos Kyndryl

1005.20.1.8 - Sikkerhed

Løsningsmodel

• TBD

1005.20.1.9 - Som STAR vil jeg have at eksisterende WSRM afsendelse er uforandret.

Løsningsmodel

• Da dette er en intern opgave på at etablere den nye webservicebesked løsning berøres de eksisterende WSRM beskeder ikke.

1005.20.1.10 - Som STAR vil jeg have at dokumentation for denne enabler lever op til STAR's principper på releasetidspunktet

Løsningsmodel (internt STAR acc.kr.)

• Wiki er opdateret og afspejler løsningen

• Dokumentationen skal skrives så der skal omskrives så lidt som muligt når den endelige løsning er etableret

1005.20.1.11 - Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer 

Løsningsmodel (internt STAR acc.kr.)

• Data i eksternekommunikation vedr. webservicebeskeder skal slettes ved dataløft dog ikke abonnementer

1005.20.1.12 - XXXXX udstiller kodelisterne for XXXXX 

Løsningsmodel (internt STAR acc.kr.)

• Det skal afklares om vi har kodelister i denne sammenhæng

1005.20.1.13 - Der skal laves en model for at man kan søge på beskeder ud fra CPR, aftager og tidsperiode

Løsningsmodel (internt STAR acc.kr.)

• Der laven en arkitektur på hvordan det understøttes at man kan søge på beskeder ud fra CPR, aftager og tidsperiode (gerne dato og klokkeslæt) og denne dokumenteres på wiki. Dette skal kunne udstilles via WebApi.

1005.20.1.14 - Der skal laves en model for håndtering af sameksistens mellem WSRM og webservicebesked løsningerne

Løsningsmodel (internt STAR acc.kr.)

• Der laven en arkitektur på hvordan sameksistens understøttes mellen WSRm og webservicebeskeder og denne dokumenteres på wiki

1005.20.1.15 - Der skal laves en model for hvordan afsendersilo sender til Eksternkommunikation via eventbroker

Løsningsmodel (internt STAR acc.kr.)

• Der laven en arkitektur på hvordan kommunikationen fra en afsende silo via eventbroker til Eksternkommunikation skal ske og denne dokumenteres på wiki

Særlige krav til test

* 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

...

• 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:  

...

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 Ja

• 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 

...

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 )

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

...