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 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.
Dato | Version | Hvem | Hvad er ændret? |
---|---|---|---|
21-02-2023 | 0.1 | Carsten Olsen | Oprettelse |
Interne links (indhold i links ikke relevant for eksterne)
- MOD-2509Getting issue details... STATUS Samle og krav epic.
- MOD-5382Getting issue details... STATUS Implementerings epic
Husk evt. BI epic
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning | |||
---|---|---|---|
Som STAR vil jeg have etablerer afsendelse og modtagelse webservicebeskeder samt tværgående test som en del af STAR's moderniseringsprogram for at sikre at DFDG får etablerer og testet infrastruktur for ny beskedmodel til erstatning af WSRM inden serviceaftager kobles på samt 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.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 | DFDG | |
1005.20.1.2 | Som STAR vil jeg have etableret en logisk og fysisk datamodel til styring af afsendelse samt afsende af besked af webservicebeskeder til forretningsområdet Webservicebeskeder i forretningsdomænet (silo) Eksternkommunikation. | DFDG | |
1005.20.1.3 | Som STAR vil jeg have etableret et endpoint hvor STAR selv kan modtage webservicebeskeder udstillet fra forretningsdomænet (silo) Eksternkommunikation | DFDG | |
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, når det tværgående testrammeværk kalder en webservice i et forretningsdomæne. | DFDG | |
1005.20.1.5 | Som STAR vil jeg have at understøtte webservicebeskeder løsning er robust og understøtter genfremsendelse af fejlet webservicebeskeder Det skal afklares om dette skal undestøttes og i hvilken grad i 23-2 henholdsvis 23-3 | DFDG | |
1005.20.1.6 | Som STAR vil jeg have at understøtte webservicebeskeder løsning er robust og understøtter fremsendelse af allerede fremsendte on demand fra aftager Det skal afklares om dette skal undestøttes og i hvilken grad i 23-2 henholdsvis 23-3 | DFDG | |
1005.20.1.7 | Som STAR vil jeg have at understøtte webservicebeskeder løsning understøtter logning Det skal afklares om dette skal undestøttes og i hvilken grad i 23-2 henholdsvis 23-3 | DFDG | |
1005.20.1.8 | Sikkerhed | DFDG | |
1005.20.1.9 | Som STAR vil jeg have at eksisterende WSRM afsendelse er uforandret. | DFDG | N/A |
1005.20.1.10 | Som STAR vil jeg have at dokumentation for denne enabler lever op til STAR's principper på releasetidspunktet | DFDG | |
1005.20.1.11 | Som STAR vil jeg have, at data er omfattet af dataløft og annonysering mod testmiljøer Det skal afklares om dette skal undestøttes og i hvilken grad i 23-2 henholdsvis 23-3 | DFDG, SF | |
1005.20.1.12 | XXXXX udstiller kodelisterne for XXXXX Det skal afklares om vi har kodelister i denne sammenhæng | DFDG | |
1005.20.1.13 | Der skal laves en model for at man kan søge på beskeder ud fra CPR og tidsperiode | DFDG | |
1005.20.1.14 | Der skal laves en model for håndtering af sameksistens mellen WSRM og webservicebesked løsningerne | DFDG | |
1005.20.1.15 | Der skal laves en model for hvordan afsendersilo sender til Eksternkommunikation via eventbroker | DFDG |
Pakke EXBESKED-1 i DFDG moderniserings og forretnings roadmap for serviceaftagere
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
1005.20.1.3 | |||||
Som serviceaftager er der ingen implementeringsopgave i denne epic, dette kommer i 2023-3 og epic https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3979313153/1005.20.2+Webservicebeskeder+Tidl.+WSRM+-+Pilot+til+afsendelse+og+modtagelse+med+serviceaftager+2023-3 Hvis der er serviceaftager der gerne vil involveret 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 | X |
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 epicPilotimplementering 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-3Udrulning af
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 bleve 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 involveret 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.
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 Eksternkommunikation der indeholder de webservicebeskeder der skal og er blevet afsendt
Der lave en model for hvordan er domæner skal rejse et event det skal udløst en webservicebesked
Der etableres eventreciever det modtager event og gemmer data til afsendelse
Der etableres push funktionalitet
Der er etableret skemavalidering af beskeden
Acc.kr. 1005.20.1.2 - Som STAR vil jeg have etableret en logisk og fysisk datamodel til styring af afsendelse samt afsende 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
Acc.kr. 1005.20.1.3 - Som STAR vil jeg have etableret et endpoint hvor STAR selv kan modtage webservicebeskeder
Løsningsmodel
Der etableres en STAR endpoint som STAR kan test modtagelse af webservicebeskeder på
Der skal sættes en abonnement plus en test-tilslutningsaftale op til dette endpoint
Acc.kr. 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 ligge i DB
Det testes at der komme en webservicebesked ud på det forventet endpoint men korrekt indhold
Det testes at beskeden kan aftages og ekstern kommunikation registrere beskede en 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 ned eller fejler
Acc.kr. 1005.20.1.5 - Som STAR vil jeg have at understøtte webservicebeskeder løsning er robust og understøtter genfremsendelse af fejlet webservicebeskeder
Løsningsmodel (internt STAR acc.kr.)
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 stoppr
Acc.kr. 1005.20.1.6 - Som STAR vil jeg understøtte 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 synkronisteres 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 webservicebeskerer for en given periode (max 6 md tilbage)
Acc.kr. 1005.20.1.7 Som STAR vil jeg have at understøtte webservicebeskeder løsning understøtter logning
Løsningsmodel
Der etableres logning af alle pushbeskeder inkl. at de er modtaget (behandler) at aftager
Hver genafsendelse skal logges
Logningen skal i denne iteration ske via star.foundations log4net da EksternKommunikation hostes hos Kyndryl
Acc.kr. 1005.20.1.8 Sikkerhed
Løsningsmodel
Acc.kr. 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.
Acc.kr. 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
Acc.kr. 1005.20.1.11 Som STAR vil jeg have, at data er omfattet af dataløft og anonymisering mod testmiljøer
Løsningsmodel (internt STAR acc.kr.)
Data i eksternekommunikation vedr. webservicebeskeder skal slettes ved dataløft dog ikke abonnementer
Acc.kr. 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
Acc.kr. 1005.20.1.13 Der skal laves en model for at man kan søge på beskeder ud fra CPR 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 og tidsperiode og denne dokumenteres på wiki. Dette skal kunne udstilles via WebApi.
Acc.kr. 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
Acc.kr. 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 kommunikatione fra en afsende silo via eventbroker til Eksternkommunikation skal ske og denne dokumenteres på wiki
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
Se 1005.20.1.4 | ||
* 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: Ja
Nye snitflader: Nej
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 | |
---|---|---|---|---|---|---|
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