Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
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? |
|---|---|---|---|
22.06.2023 | 0.1 | Jesper Brunholm | Gennemskrivning baseret på 930.6 |
28.06.2023 | 0.3 | Jesper Brunholm | Snitflader opdaterede mm |
29.06.2023 | 0.3 | Knud de Place | Sendes i tilsagn med bølge 1 / 2023-4, selvom koden vil blive en del af 2023-3 leverancen ift. brug i 2023-3 testmiljøer. Men da afklaringen om at aftagerne både ønsker WSRM’er og webhook beskeder ift. NUPH er ret ny, vil udviklingen ikke kunne færdiggøres til normal frist for ekstern aflevering til 2023-3, men forventelig i løbet af august 2023. |
14.08.2023 | 1.0 | Knud de Place | V1.0. Ikke andre ændringer. |
Interne links (indhold i links ikke relevant for eksterne)
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning |
|---|
Som STAR, a-kasse og kommune vil jeg gerne have de nye Webservicebeskeder vedr. NUPH og svar tilgængelige i et testmiljø for at jeg kan indgå i integrationstest og en end-2-end test, hvor indgår registrering og læsning af data fra sagsbehandler brugergrænsefladerne i jobcentrenes og a-kassernes fagsystemer |
Acceptkriterier
Nr. | Beskrivelse | Relevant for | Intern STAR userstory |
|---|---|---|---|
1005.20.4.1 | Som a-kasse og jobcenter vil jeg gerne modtage en webservicebesked (WSB), når jobcentret eller DFDG danner en NUPH | DFDG | |
1005.20.4.2 | Som jobcenter vil jeg gerne modtage en WSB når a-kassen svarer på en NUPH og når DFDG besvarer en NUPH [dvs. a-kasse får ikke WSB på svaret, da de selv danner de svar, der er interessante for a-kassen] | DFDG | |
1005.20.4.3 | Som a-kasse og jobcenter vil jeg gerne modtage en WSB, når den anden part beder om flere oplysninger eller besvarer ønsket om flere oplysninger | DFDG |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader
Kriterie | 1005.20.4.1 | 1005.20.4.2 | 1005.20.4.3 | Bemærkning |
|---|---|---|---|---|
A-kasse og KSS aftager WSB om NUPH | X |
|
|
|
KSS aftager WSB om svar på NUPH |
| X |
|
|
KSS og a-kasse aftager WSB med ønske om yderligere oplysninger og WSB om svaret |
|
| 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.
Summary | Varslingstype | Varslingsnote | Interne Snitflader | Eksterne Snitflader | Project |
|---|---|---|---|---|---|
Ny | Ny webservicebesked om NUPH | N/A | A-kasse, KSS | D+S | |
Ny | Ny webservicebesked om uddybende spørgsmål ifm. en NUPH | N/A | A-kasse, KSS | D+S | |
Ny | Ny webservicebesked om svar på uddybende spørgsmål ifm. en NUPH | N/A | A-kasse, KSS | D+S | |
Ny | Ny webservicebesked om svar på NUPH | N/A | A-kasse, KSS | D+S |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
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.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
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.
Der er en sammenhæng imellem denne epic og 930.6 med WSRM’er, idet aftagerne i prod. skal tage enten WSRM’er eller WSB’er (webservicebeskeder) i brug.
1005.20.4.1 - Som a-kasse og jobcenter vil jeg gerne modtage en webservicebesked (WSB), når jobcentret eller DFDG danner en NUPH
Både JC og a-kasse får WSB om dannelse af NUPH
Nuph webservicebesked
For metadata se https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3950510658/Noter+til+webservicebeskeder#Metadata-eksempel
For teknisk dokumentation se Eksternkommunikation Webservicebeskeddokumentation
For beskedtyper se EksternKommunikation.EntityTypeCodeList
Feltnavn m.v. | Beskrivelse | Indhold |
EntitetNavn | Navn på beskedtypen | Nuph |
EntitetId | Identifikation af beskedtype og Unik Id på tværs af alle miljøer | 100001 |
Beskrivelse | Beskrivelse på beskedtypen | En ny underretningspligtig hændelse er indberettet og når der vedlægges eller slettes et dokument, der er tilknyttet en underretning |
Startdato | Dato for hvornår beskeden kan modtages |
|
Slutdato | Dato for hvornår besked ikke mere sendes | N/A |
EksternIdentifier | Identifikation på den dataentitet beskeden vedrører | UnderretningIdentifier |
Version Identifier | Versionsidentifikation på den dataentitet beskeden vedrører | N/A |
IdentifikationstypeId | Reference til type hvad/hvem besked vedrører | Cpr nr (Id 1) |
Aendringstype | Aktion der kan have udløst besked (Create, Update og eller Delete) | Oprettelse (Id 1), Opdatering (Id 2), Sletning (Id 3) |
Bodyindhold | Hvis der er data i beskeden udover standard | Nej |
Erstatter WSRM | Hvilke(n) WSRM besked(er) webservicebeskeden erstatter helt eller delvis | GetNuphVersion1 som beskrevet i epic 930.6 WSRMer vedr NUPH og svar på NUPH |
Forretningsregler for afsendelse | Specifikke regler for afsendelse |
|
Afsendelsesstrategi | Modtager af webservicebesked jvf. | Jobcenter - Egne borger Nr 2 Kommune - Egne borger Nr 4 A-kasse - Medlem på hændelsestidspunkt Nr 5 A-kasse - ansvarlig a-kasse hvis denne er forskellig fra borgers medlems-a-kasse. Strategi “Distributionsliste”, Nr 1 |
Hent af data | Hvor kan data hentes i DFDG | /wiki/spaces/GI/pages/3767009372.GetUnderretninger |
Eksempel
xxxx = indhold anomymiseret
1111111111 = cpr nr anonymiseret
Nuph - Payload Header | Body - ingen |
|---|---|
{"Oprindelse":{"RegistrerendeMyndighed":{"OrganisationType":8,"OrganisationKode":"16300"},"RegistrerendeBruger":{"BrugertypeId":2,"BrugertypeNavn":"Caseworker","Brugernavn":"xxxxxx","Brugeridentifikation":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","Brugeremail":"xxxxxx@herlev.dk","KaldendeMyndighed":{"OrganisationType":8,"OrganisationKode":"16300"}},"SystemId":5,"Systemnavn":"SchultzFasit"},"BeskedIdentifier":"xxxxxxxx-25e0-4dd2-8172-4aaecbf4c853","HaendelsesTid":"2023-12-18T14:59:35.3+01:00","Miljoe":"PROD","KorrelationsIdentifier":"xxxxxxxx-75ee-4b04-be4d-d1d3b2163ce1","EntitetstypeId":100001,"EntitetstypeNavn":"Nuph","EksternIdentifier":"xxxxxxxx-b91c-43f4-8055-2e12d2a5d3a7","VersionIdentifier":null,"Identifikation":"111111111111","IdentifikationstypeId":1,"IdentifikationstypeNavn":"CPR","AendringstypeId":1,"AendringstypeNavn":"Create"} |
1005.20.4.2 - Som jobcenter vil jeg gerne modtage en WSB når a-kassen svarer på en NUPH og når DFDG besvarer en NUPH
SvarPaaNuph webservicebesked
A-kasse får ikke WSB på svaret, da de selv danner detteFor metadata se https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3950510658/Noter+til+webservicebeskeder#Metadata-eksempel
For teknisk dokumentation se Eksternkommunikation Webservicebeskeddokumentation
For beskedtyper se EksternKommunikation.EntityTypeCodeList
Feltnavn m.v. | Beskrivelse | Indhold |
EntitetNavn | Navn på beskedtypen | SvarPaaNuph |
EntitetId | Identifikation af beskedtype og Unik Id på tværs af alle miljøer | 100002 |
Beskrivelse | Beskrivelse på beskedtypen | Svar på en underretningspligtig hændelse er indkommet eller autooprettet. Dannes endvidere når der vedlægges eller slettes et dokument, der er tilknyttet svar på en underretning |
Startdato | Dato for hvornår beskeden kan modtages |
|
Slutdato | Dato for hvornår besked ikke mere sendes | N/A |
EksternIdentifier | Identifikation på den dataentitet beskeden vedrører | UnderretningSvarIdentifier |
Version Identifier | Versionsidentifikation på den dataentitet beskeden vedrører | N/A |
IdentifikationstypeId | Reference til type hvad/hvem besked vedrører | Cpr nr (Id 1) |
Aendringstype | Aktion der kan have udløst besked (Create, Update og eller Delete) | Oprettelse (Id 1), Opdatering (Id 2), Sletning (Id 3) |
Bodyindhold | Hvis der er data i beskeden udover standard | Nej (UnderretningIdentifier er ikke nødvendig, da man kan bruge UnderretningSvarIdentifier i GetUnderretninger) |
Erstatter WSRM | Hvilke(n) WSRM besked(er) webservicebeskeden erstatter helt eller delvis | GetSvarPaaNuphVersion1 som beskrevet i epic 930.6 WSRMer vedr NUPH og svar på NUPH |
Forretningsregler for afsendelse | Specifikke regler for afsendelse |
|
Afsendelsesstrategi | Modtager af webservicebesked jvf. | Jobcenter - Egne borger Nr 2 Kommune - Egne borger Nr 4 |
Hent af data | Hvor kan data hentes i DFDG | /wiki/spaces/GI/pages/3767009372.GetUnderretninger |
Eksempel
xxxx = indhold anomymiseret
1111111111 = cpr nr anonymiseret
SvarPaaNuph - Payload Header | Body - ingen |
|---|---|
{"Oprindelse":{"RegistrerendeMyndighed":{"OrganisationType":2,"OrganisationKode":"15"},"RegistrerendeBruger":{"BrugertypeId":2,"BrugertypeNavn":"Caseworker","Brugernavn":"xxxxxx","Brugeridentifikation":"xxxxxxx@3f.dk","Brugeremail":"xxxxxx@3f.dk","KaldendeMyndighed":{"OrganisationType":2,"OrganisationKode":"15"}},"SystemId":8,"Systemnavn":"FaciliaAkasse"},"BeskedIdentifier":"xxxxxxxx-d840-4431-b21a-4a769fd6f2d8","HaendelsesTid":"2023-12-18T09:08:09.6+01:00","Miljoe":"PROD","KorrelationsIdentifier":"xxxxxxxx-b052-44a9-99fd-73e5b373fa4f","EntitetstypeId":100002,"EntitetstypeNavn":"SvarPaaNuph","EksternIdentifier":"xxxxxxxx-df1f-43a9-b740-81af6bf004bd","VersionIdentifier":null,"Identifikation":"111111111111","IdentifikationstypeId":1,"IdentifikationstypeNavn":"CPR","AendringstypeId":1,"AendringstypeNavn":"Create"} |
|
1005.20.4.3 - Som a-kasse og jobcenter vil jeg gerne modtage en WSB, når den anden part beder om flere oplysninger eller besvarer ønsket om flere oplysninger
NuphUddybendeSpoergsmaal og NuphUddybendeSvar sendes til begge parter, da det ikke er givet hvem der spørger og svarer
NuphUddybendeSpoergsmaal webservicebesked
For metadata se https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3950510658/Noter+til+webservicebeskeder#Metadata-eksempel
For teknisk dokumentation se Eksternkommunikation Webservicebeskeddokumentation
For beskedtyper se EksternKommunikation.EntityTypeCodeList
Feltnavn m.v. | Beskrivelse | Indhold |
EntitetNavn | Navn på beskedtypen | NuphUddybendeSpoergsmaal |
EntitetId | Identifikation af beskedtype og Unik Id på tværs af alle miljøer | 100003 |
Beskrivelse | Beskrivelse på beskedtypen | Der er oprettet en anmodning om uddybende information om en Nuph |
Startdato | Dato for hvornår beskeden kan modtages |
|
Slutdato | Dato for hvornår besked ikke mere sendes | N/A |
EksternIdentifier | Identifikation på den dataentitet beskeden vedrører | UnderretningIdentifier |
Version Identifier | Versionsidentifikation på den dataentitet beskeden vedrører | N/A |
IdentifikationstypeId | Reference til type hvad/hvem besked vedrører | Cpr nr (Id 1) |
Aendringstype | Aktion der kan have udløst besked (Create, Update og eller Delete) | Oprettelse (Id 1) |
Bodyindhold | Hvis der er data i beskeden udover standard | Nej |
Erstatter WSRM | Hvilke(n) WSRM besked(er) webservicebeskeden erstatter helt eller delvis | GetNuphUddybendeSpoergsmaalVersion1 som beskrevet i epic 930.6 WSRMer vedr NUPH og svar på NUPH |
Forretningsregler for afsendelse | Specifikke regler for afsendelse |
|
Afsendelsesstrategi | Modtager af webservicebesked jvf. | Jobcenter - Egne borger Nr 2 Kommune - Egne borger Nr 4 A-kasse - Medlem på hændelsestidspunkt Nr 5 |
Hent af data | Hvor kan data hentes i DFDG | VisiteringOgStatus.UnderretningService.GetUnderretninger |
Eksempel
xxxx = indhold anomymiseret
1111111111 = cpr nr anonymiseret
NuphUddybendeSpoergsmaal - Payload Header | Body - ingen |
|---|---|
{"Oprindelse":{"RegistrerendeMyndighed":{"OrganisationType":8,"OrganisationKode":"85100"},"RegistrerendeBruger":{"BrugertypeId":2,"BrugertypeNavn":"Caseworker","Brugernavn":"xxxxxx","Brugeridentifikation":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","Brugeremail":"xxxx@aalborg.dk","KaldendeMyndighed":{"OrganisationType":8,"OrganisationKode":"85100"}},"SystemId":4,"Systemnavn":"KMDMomentum"},"BeskedIdentifier":"xxxxxxxx-f4ce-4115-8b5b-4de376a76bd2","HaendelsesTid":"2023-12-19T14:42:50.8+01:00","Miljoe":"PROD","KorrelationsIdentifier":"xxxxxxxx-20ff-4bca-b6b9-4865d329effc","EntitetstypeId":100003,"EntitetstypeNavn":"NuphUddybendeSpoergsmaal","EksternIdentifier":"xxxxxxxx-2ae1-4377-a4c8-80c02e01abdb","VersionIdentifier":null,"Identifikation":"111111111111","IdentifikationstypeId":1,"IdentifikationstypeNavn":"CPR","AendringstypeId":1,"AendringstypeNavn":"Create"} |
|
NuphUddybendeSvar webservicebesked
For metadata se https://starwiki.atlassian.net/wiki/spaces/ISB/pages/3950510658/Noter+til+webservicebeskeder#Metadata-eksempel
For teknisk dokumentation se Eksternkommunikation Webservicebeskeddokumentation
For beskedtyper se EksternKommunikation.EntityTypeCodeList
Feltnavn m.v. | Beskrivelse | Indhold |
EntitetNavn | Navn på beskedtypen | NuphUddybendeSvar |
EntitetId | Identifikation af beskedtype og Unik Id på tværs af alle miljøer | 100004 |
Beskrivelse | Beskrivelse på beskedtypen | Der er indberettet et svar med uddybende information om en Nuph |
Startdato | Dato for hvornår beskeden kan modtages |
|
Slutdato | Dato for hvornår besked ikke mere sendes | N/A |
EksternIdentifier | Identifikation på den dataentitet beskeden vedrører | UnderretningIdentifier |
Version Identifier | Versionsidentifikation på den dataentitet beskeden vedrører | N/A |
IdentifikationstypeId | Reference til type hvad/hvem besked vedrører | Cpr nr (Id 1) |
Aendringstype | Aktion der kan have udløst besked (Create, Update og eller Delete) | Oprettelse (Id 1) |
Bodyindhold | Hvis der er data i beskeden udover standard | Nej |
Erstatter WSRM | Hvilke(n) WSRM besked(er) webservicebeskeden erstatter helt eller delvis | GetNuphUddybendeSvarVersion1 som beskrevet i epic 930.6 WSRMer vedr NUPH og svar på NUPH |
Forretningsregler for afsendelse | Specifikke regler for afsendelse |
|
Afsendelsesstrategi | Modtager af webservicebesked jvf. | Jobcenter - Egne borger Nr 2 Kommune - Egne borger Nr 4 A-kasse - Egne medlemmer Nr 5 |
Hent af data | Hvor kan data hentes i DFDG | VisiteringOgStatus.UnderretningService.GetUnderretninger |
Eksempel
xxxx = indhold anomymiseret
1111111111 = cpr nr anonymiseret
NuphUddybendeSvar - Payload Header | Body - ingen |
|---|---|
{"Oprindelse":{"RegistrerendeMyndighed":{"OrganisationType":8,"OrganisationKode":"56100"},"RegistrerendeBruger":{"BrugertypeId":2,"BrugertypeNavn":"Caseworker","Brugernavn":"xxxxxx","Brugeridentifikation":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","Brugeremail":"xxxx@esbjerg.dk","KaldendeMyndighed":{"OrganisationType":8,"OrganisationKode":"56100"}},"SystemId":5,"Systemnavn":"SchultzFasit"},"BeskedIdentifier":"xxxxxxxx-ddaf-4745-a0c5-dff56c485864","HaendelsesTid":"2023-12-19T15:20:56.8+01:00","Miljoe":"PROD","KorrelationsIdentifier":"xxxxxxxx-36d7-43c5-a05b-ef3b87214bef","EntitetstypeId":100004,"EntitetstypeNavn":"NuphUddybendeSvar","EksternIdentifier":"xxxxxxxx-7e8a-4361-ae1d-43a447bc0541","VersionIdentifier":null,"Identifikation":"111111111111","IdentifikationstypeId":1,"IdentifikationstypeNavn":"CPR","AendringstypeId":1,"AendringstypeNavn":"Create"} |
|
|
|
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
|---|---|---|
Der dannes webservicebesked til jobcentre / KSS ved
|
| Knud de Place |
Der dannes webservicebesked til a-kasser ved
|
| Knud de Place |
Test scenarie | Deltagelse i test | 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:
Efter idriftsættelse:
Her beskriver PO/FA konsekvenser for løsninger efter idriftsættelse, hvis noget afviger fra normale setup.
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
Nye dataområder:
Nye snitflader:
Nye komponenter:
Nye miljøer:
Nye teknologier:
Nye aftagertyper:
Eller afvigelser fra principperne:
Eventuelle behov for reduktion af teknisk gæld skal afdækkes:
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.
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
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