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
DFDG epic
- MOD-5382Getting issue details... STATUS Implementerings epic
BI epic
- MOD-6259Getting issue details... STATUS
Indholdsfortegnelse
Afgrænsning af epic
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 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 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.)
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
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