Denne epic er tredie del af etablering af webservicebeskeder for del et se 1005.20.1 Webservicebeskeder (Tidl. WSRM) - STAR infrastruktur til afsendelse og modtagelse - Intern STAR @2023-2 for del to se 1005.20.2 Webservicebeskeder (Tidl. WSRM) - Pilot til afsendelse og modtagelse med serviceaftager @2023-3
Brug ikke tid på at læse dokumentet - epic er ikke opdateret, men låst op, så aftagere kan se undersider
Page Properties | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
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 |
30.09.2023 | 0.1 | Opdatering |
...
Afgrænsning | |||
---|---|---|---|
Som serviceaftager og STAR vil jeg fra 2023-4 understøtte pilotdrift af WSB abonnementsopsætning og WSB-beskedafsendelse for at sikre at STAR/moderniseret DFDG og aftagerne kan få erfaringer med WSB abonnementsopsætning, beskedafsendelse og beskedmodtagelse (og videre behandling) hos aftager, inden det bliver obligatorisk at overgå fra WSRM til WSB aftagelse | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for | US |
1005.20.3.1 | Mulighed for pilotdrift for udvalgte WSB’er fra 2023-4 | DFDG, SF | |
1005.20.3.2 | Serviceaftager kan opsætte abonnement på de for aftager tilladte WSB’er via webservice | DFDG | |
1005.20.3.3 | Understøttelse i LSS af udvalgte funktioner ift. SF’s opsætning af af tilladte abonnementer | DFDG, SF | |
1005.20.3.4 | Understøttelse i LSS af udvalgte funktioner ift. aftagers opsætning af egne abonnementer eller klientsystems opsætning af abonnement for flere kunder/aftagere | DFDG, SF | |
1005.20.3.5 | Aftagere, der får nyt system, der skal aftage WSB’er skal oplyse herom til SF i god tid før ibrugtagning (mindst 3 måneder før ordinær DFDG release) | DFDG | Ingen kode |
1005.20.3.6 | Adgangsstyring til menupunkter i LSS | DFDG, SF | |
1005.20.3.7 | WSB’er GDPR-slettes 6 måneder efter afsendelse | DFDG, SG |
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.3.1 | 1005.20.3.2 | 1005.20.3.3 | 1005.20.3.4 | 1005.20.3.5 | 1005.20.3.7 | ||
Som aftager kan jeg fra 2023-4 i pilotdrift aftage én eller flere WSB’er | X | ||||||
Serviceaftager kan vælge at opsætte abonnement på WSB’er via webservicekald | X | ||||||
Serviceaftager kan vælge at opsætte abonnement via brugergrænseflade i LSS | X | ||||||
Aftagere, der får nyt system, der skal aftage WSB’er skal oplyse herom til SF i god tid før ibrugtagning (mindst 3 måneder før ordinær DFDG release) | X | ||||||
Hvis aftager ikke er klar til at bruge webservicesnitflade til opsætning af abonnement i 2023-4 eller LSS brugergrænseflade ikke fuldt ud er klar til brug, vil aftager kunne bestille opsætning af WSB abonnement via Fogbugz sag til SF | X | X |
Oversigt over berørte webservices
Manuel oversigt som er synlig for eksterne
...
Aftager er opmærksom på, at WSB’er GDPR-slettes i DFDG 6 mdr. efter afsendelse. STAR foretager dermed ikke fejlsøgning på fejlmeldinger om manglende beskeder, hvis det indmeldes mere end 6 mdr. efter beskedafsendelse | 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 |
---|---|---|---|---|---|
...
Etablering og test af infrastruktur til afsendelse og modtagelse af webservicebeskeder
Release 2023-1 - Epic 1005.20.1 Webservicebeskeder (Tidl. WSRM) - STAR infrastruktur til afsendelse og modtagelse - Intern STAR @2023-2Pilotimplementering hos serviceaftagere 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-3Release 2023-3 - Denne epic
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
N/A
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.
Aftager vil skulle udvikle at anvende webservices til opsætning og opdatering af WSB-abonnementer eller anvende brugergrænseflade i LSS til at opsætte WSB abonnementer.
...
link til teknisk underside med snitfladebeskrivelse for den udviklede service: EksternKommunikation.AbonnementService (Version 1, 2023-4)
Bemærk, at den udviklede snitflade er under ændringer på baggrund af input fra aftagerne på WSB-møde i STAR den 27. september 2023. Ændringer på vej er beskrevet nedenfor:
Opret abonnement
Via webservicesnitflade oprettes abonnement med denne service: EksternKommunikation.AbonnementService (version 1).CreateAbonnement. Denne metode opretter enkeltabonnement - og udgår for ekstern anvendelse. Der oprettes efter ønske fra aftagere i stedet en ny metode til bulk-oprettelse af abonnementer.
...
Startdato på webhook abonnement gøres nullable (ændring ift. nu udviklede). Dette indebærer følgende:
...
Internt link:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Ændring forventes påbegyndt i uge 41 / 2023.
Hent alle gældende abonnementer
Der udvikles servicemetode således, at aftager kan hente alle abonnementer for et bestemt SubscriberSystem.
Endnu ikke fastlagt, om
GetAbonnementer” skal udvides eller om der skal oprettes “GetAbonnement” I EksternKommunikation
Hvis udvidelse: GetAbonnementer rettes så der er en optional parameter “subscriberSystemIdentifier”
Hvis ny metode: GetAbonnement er oprettet med subscriberSystemIdentifier som required parameter.
Internt link:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Ændring forventes påbegyndt i uge 41 / 2023.
Mulighed for bulk-oprettelse
...
Internt link:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Ændring forventes påbegyndt i uge 41 / 2023.
Oprettelse af enkelt abonnement
...
Interne links:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Ændringen forventes foretaget, når ny bulk-oprettelsesmetode er oprettet.
Finjustering af hvilke Get-metoder eksterne må kalde - og hvad de skal returnere
...
Baseret på vurderinger/undersøgelser er kaldene rettet til (hvis der er nødvendigt)
Internt link: Ændring forventes påbegyndt i uge 41 / 2023.
1005.20.3.3 - Understøttelse i LSS af udvalgte funktioner ift. SF’s opsætning af af tilladte abonnementer
Der etableres brugergrænseflade til SF’s opsætning af tilladte abonnementer på system og organisation:
Oprettelse af tilladt system abonnement
Oprettelse af tilladt system abonnement via
Tilføj TilladtSystemAbonnement
Registrér Systemidentifikation, Entitetstype, organisationstype og Organisationskode - og tryk Opret
...
Sletning af tilladt system abonnement
Sletning af tilladte system abonnementer via fluebens markering af en oprettet tilladelse - og derefter Slet
...
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Ændring forventes påbegyndt i uge 41 / 2023.
Præ-release af beskedtyper og tilladte beskedtyper
Det skal være muligt at præ-release nye beskedtyper og tilladte beskedtyper således, at aftager ikke på STAR’s releaseaften skal foretage opsætning af nye abonnementer for at være sikker på at modtage nye beskedtyper straks DFDG åbnes efter en release.
Løsning i DFDG
Nye beskedtyper skal kunne releases til PROD før den egentlige release frigives.
Aftager skal kunne importere abonnementsopsætning fra ét miljø på et andet miljø (fx PROD).
Manuel proces, da det ikke er gangbart at bore huller mellem testmiljøer og prod.!
Internt link:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
1005.20.3.
...
3 - Understøttelse i LSS af udvalgte funktioner ift.
...
SF’s opsætning af af
...
MitId Erhverv certifikat
For at anvende LSS skal aftager have et MitId erhverv certifikat og i tilknytning hertil tillige anvende et MitId erhverv brugercertifikat, der skal installeres hos brugeren - og efterfølgende sammenknyttes med evt. eksisterende brugerprofil i Arbejdsmarkedsportalen. Sammenknytningen foretages af aftagerens LBA - og hvis en sådan ikke haves, så af STAR-SPOC.
Bestilling af MitId erhverv brugercertifikat
MitId erhverv brugercertifikat skal bestilles af aftagers egen MitID Erhverv certifikat brugeradministator. STAR kan ikke bestille det på aftagers vegne.
Opsætning af abonnementer eller tilpasning af eksisterende abonnementer
Illustration og beskrivelse udestår
Søgning efter beskeder
Der kan i LSS søges efter beskeder ved brug af følgende søgekriterier:
Obligatoriske søgekriterier:
Myndighed (som beskeden er afsendt eller forsøgt afsendt til)
Beskedstatus (Alle, Fejlende, Success)
Valgfri søgekriterier:
Beskedtype
Fra- og til-dato (datointerval, der søges i)
Identifikation, fx
CPR-nr for borgercentriske beskeder
CVR-nr eller jobordrenr. for virksomhedscentriske beskeder
Antal beskeder (der max ønskes returneret)
...
Visning af abonnementer
Når WSB menupunktet tilgås vises også abonnementer, der er opsat:
...
1005.20.3.5 - Aftagere, der får nyt system, der skal aftage WSB’er skal oplyse herom til SF i god tid før ibrugtagning (mindst 3 måneder før ordinær DFDG release)
Aftagere, der får nyt system, der skal aftage WSB’er skal oplyse herom til SF i god tid før ibrugtagning (mindst 3 måneder før ordinær DFDG release). Dette af hensyn til, at kodelisten for klientsystem skal opdateres og indarbejdes (kodes) i sikkerhedssetup i DFDG.
De aktuelt mulige WSB-aftagere fremgår af kodelisten:
ClientSystemTypeIdentifier (prod. pr. 30.09.2023): ClientSystemTypeIdentifier
ClientSystemTypeIdentifier (på vej til 2023-4 pr. 30.09.2023): ClientSystemTypeIdentifier - UDV-udgaven af kodelisten
1005.20.3.6 Adgangsstyring til menupunkter i LSS
Der udvikles udvidet adgangsstyring til menupunkter i LSS således, at klientsystem aftagere kan få adgang til WSB menupunkter i test og prod. - uden at få unødvendige adgange til andre oplysninger i test og prod.
...
tilladte abonnementer
Der etableres brugergrænseflade til SF’s opsætning af tilladte abonnementer på system og organisation:
Oprettelse af tilladt system abonnement
Oprettelse af tilladt system abonnement via
Tilføj TilladtSystemAbonnement
Registrér Systemidentifikation, Entitetstype, organisationstype og Organisationskode - og tryk Opret
...
Sletning af tilladt system abonnement
Sletning af tilladte system abonnementer via fluebens markering af en oprettet tilladelse - og derefter Slet
...
1005.20.3.4 - Understøttelse i LSS af udvalgte funktioner ift. aftagers opsætning af egne abonnementer eller klientsystems opsætning af abonnement for flere kunder/aftagere
MitId Erhverv certifikat
For at anvende LSS skal aftager have et MitId erhverv certifikat og i tilknytning hertil tillige anvende et MitId erhverv brugercertifikat, der skal installeres hos brugeren - og efterfølgende sammenknyttes med evt. eksisterende brugerprofil i Arbejdsmarkedsportalen. Sammenknytningen foretages af aftagerens LBA - og hvis en sådan ikke haves, så af STAR-SPOC.
Bestilling af MitId erhverv brugercertifikat
MitId erhverv brugercertifikat skal bestilles af aftagers egen MitID Erhverv certifikat brugeradministator. STAR kan ikke bestille det på aftagers vegne.
Opsætning af abonnementer eller tilpasning af eksisterende abonnementer
Illustration og beskrivelse udestår
Søgning efter beskeder
Der kan i LSS søges efter beskeder ved brug af følgende søgekriterier:
Obligatoriske søgekriterier:
Myndighed (som beskeden er afsendt eller forsøgt afsendt til)
Beskedstatus (Alle, Fejlende, Success)
Valgfri søgekriterier:
Beskedtype
Fra- og til-dato (datointerval, der søges i)
Identifikation, fx
CPR-nr for borgercentriske beskeder
CVR-nr eller jobordrenr. for virksomhedscentriske beskeder
Antal beskeder (der max ønskes returneret)
...
Visning af abonnementer
Når WSB menupunktet tilgås vises også abonnementer, der er opsat:
...
1005.20.3.5 - Aftagere, der får nyt system, der skal aftage WSB’er skal oplyse herom til SF i god tid før ibrugtagning (mindst 3 måneder før ordinær DFDG release)
Aftagere, der får nyt system, der skal aftage WSB’er skal oplyse herom til SF i god tid før ibrugtagning (mindst 3 måneder før ordinær DFDG release). Dette af hensyn til, at kodelisten for klientsystem skal opdateres og indarbejdes (kodes) i sikkerhedssetup i DFDG.
De aktuelt mulige WSB-aftagere fremgår af kodelisten:
ClientSystemTypeIdentifier (prod. pr. 30.09.2023): ClientSystemTypeIdentifier
ClientSystemTypeIdentifier (på vej til 2023-4 pr. 30.09.2023): ClientSystemTypeIdentifier - UDV-udgaven af kodelisten
1005.20.3.6 Adgangsstyring til menupunkter i LSS
Der udvikles udvidet adgangsstyring til menupunkter i LSS således, at klientsystem aftagere kan få adgang til WSB menupunkter i test og prod. - uden at få unødvendige adgange til andre oplysninger i test og prod.
Der foretages følgende afgrænsninger i test og prod.: Se underside (internt link - under er ikke og skal ikke være tilgængelig for eksterne): /wiki/spaces/ISB/pages/4157899963
1005.20.3.7 - WSB’er GDPR-slettes 6 måneder efter afsendelse
WSB’er GDPR-slettes 6 måneder efter afsendelsestidspunkt. Dette svarer til hidtidig praksis for GDPR-sletning af WSRM-beskeder.
Løsning i DFDG
Nyt batchjob EK(?) EksternKommunikation -GDPR-SletWebservicebeskeder
Sletter webservicebeskeder 6 måneder efter afsendelsestidspunkt
Jobbet sættes til at køre hver lørdag kl. 12 i op til 50 minutter
Der dannes ikke GDPR-slette besked til eksterne aftage om sletning af WSB’er
Internt link:
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
...
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:
...
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
...