Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning


Page Properties


STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader

Knud de Place (STAR)

Jens Andersen

Joel Järlesäter (Unlicensed)

Carsten Olsen

2023-1 (STAR idrift)

Ekstern ibrugtagning: 

  • afløser for PSS og PHS kollektioner: 2023-1.
  • registreringsmetoder: senest 2024-1
0.3KSS




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?

14.10.2022

0.1

Carsten Olsen

Oprettelse

03.11.2022

0.3

Joel Järlesäter

Epic gennemskrevet og klar til tilsagn


Interne links (indhold i links ikke relevant for eksterne)

Jira Legacy
serverSystem JIRA
columnskey,po,fa,ux,sme,eksterne snitflader,interne snitflader,status,labels
maximumIssues4
jqlQueryissuetype = epic AND cf[10006] IN (1005.17.13, 1005.17.13i) order by key
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-10489


Indholdsfortegnelse

Table of Contents
outlinetrue



Info
titleOBS svartider

OBS ift. svartider

Svartiderne forventes at være væsentlig dårligere ved brug af SOAP-versionerne af de gamle services end ved brug af de nye REST services - og svartiderne forventes at være væsentlig højere på SOAP-services end før omlægningen til REST. Det skyldes, at SOAP-versionerne internt kalder videre til de nye REST versioner.

STAR vil derfor gerne undgå, at holde SOAP-versionerne i live, med mindre det konkret efterspørges af de enkelte aftagere ifm. tilsagn til en given epic.

For en service med svartider i dag på fx 4-8 millisekunder (med 7-9 mio. kald pr. måned) forventes, at svartiden på SOAP-version vil være ca x 100.


Afgrænsning af epic

Afgrænsning

Som serviceaftager og STAR

vil jeg have løftet servicesnifladerne for registrering og læsning af aktivitetstillæg (ActivitySupplement) til REST som en del af STAR's moderniseringsprogram

for at sikre at DFDG lever op til STARs principper omkring en moderne og vedligeholdelsesvenlig IT-portefølje samt udfaser end of life teknologi. 

Acceptkriterier


Nr.BeskrivelseRelevant forUS
1005.17.13.1Som STAR vil jeg have flyttet forretningsområdet aktivitetstillæg til forretningsdomænet Visitering og Status inkl. at det lever op til de principper, der er fastsatDFDG, BI



1005.17.13.2Som serviceaftager og STAR vil jeg have udstillet metoderne i PersonRegistrationService vedr. aktivitetstillæg (tidl. ActivitySupplement) via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP serviceDFDG
Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-11145

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-11145

Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-10494
1005.17.13.3Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade DFDG
1005.17.13.4Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktetDFDG, Jobnet
1005.17.13.5Som STAR vil jeg have, at data er omfattet af dataløft og  pseudonymisering mod testmiljøer DFDG, SF

1005.17.13.6

PersonStatusService (version 20) udstiller ikke mere kollektion med oplysninger om aktivitetstillæg. I stedet returneres en tom liste.

DFDG
1005.17.13.7PersonHistoryService (version 4) udstiller ikke mere kollektion med oplysninger om aktivitetstillæg. I stedet returneres en tom liste.DFDG
1005.17.13.8Hidtidige WSRM om aktivitetstillæg GetActivitySupplementVersion8 dannes fortsat til jobcentre.DFDG
Jira Legacy
serverSystem JIRA
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-10493


1005.17.13.9Død kode i DFDG, i forbindelse med aktivitetstillæg, fjernesDFDG


1005.17.13.10Landssupporten/LSS er skiftet over til at brug den nye REST-servicen vedr. i aktivitetstillæg i stedet for at udstille oplysningerne fra PSS / PHS.DFDG
1005.17.3.11VisiteringOgStatus.VisiteringOgStatusStatusService udstiller aktivitetstillægDFDG

Pakke ATILLÆG-1 i Knuds liste - Beta roadmap DFDG


Kriterier for tilsagn til serviceaftager i forhold til STARs snitfladerBerørte acceptkriterierBemærkninger

1005.17.13.21005.17.3.31005.17.13.6 og 71005.17.13.8
Som KSS skal jeg overgå til ny REST snitflade for at registrere og opdatere oplysninger om aktvitetstillæg, men kan i en overgangsperiode indtil 2024-1 fortsat anvende SOAP-versionen PersonRegistrationService til disse registreringerXX


Som bruger af PersonStatusService og PersonHistoryService skal jeg i 2023-1 skifte til REST snitfladen for at læse registreringer om aktivitetstillæg

X

KSS kan som hidtil abonnere på WSRM'er om aktivitetstillæg


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)

SummaryVarslingstypeVarslingsnoteEksterne SnitfladerInterne SnitfladerProject
PersonStatusService (version 20).GetVariablePersonStatus - kollektionen ActivitySupplementUdgårKollektion udgår i 2023-1. Brug i stedet metode på ny REST-serviceKSSN/AD+S
PersonHistoryService (version 4).GetPersonHistory - kollektionen ActivitySupplementHistoryCollectionUdgårKollektion udgår i 2023-1. Brug i stedet metode på ny REST-serviceKSSN/AD+S
PersonRegistrationService (version 9).CreateActivitySupplementAndetUdgår senest i 2024-1. Brug metode på nye REST-service: VisiteringOgStatusServices.AktivitetstillaegService (version 1).CreateAktivitetstillaegKSSN/AD+S
PersonRegistrationService (version 9).UpdateActivitySupplementAndetUdgår senest i 2024-1. Brug metode på nye REST-service: VisiteringOgStatusServices.AktivitetstillaegService (version 1).UpdateAktivitetstillaeg KSSN/AD+S
VisiteringOgStatusServices.AktivitetstillaegService (version 1).CreateAktivitetstillaegNyNy REST-service. Metode til registrering af aktivitetstillægKSSN/AD+S
VisiteringOgStatusServices.AktivitetstillaegService (version 1).UpdateAktivitetstillaeg NyNy REST-service. Metode til opdatering af registrerede aktivitetstillægKSSN/AD+S
VisiteringOgStatusServices.AktivitetstillaegService (version 1).GetAktivitetstillaegNyErstatter kollektion i PSS.KSSN/AD+S
VisiteringOgStatusServices.AktivitetstillaegService (version 1).GetAktivitetstillaegHistorikNyErstatter kollektion i PHS.KSSN/AD+S
WsrmMessageService (version 10).GetActivitySupplementVersion8AndetWsrm-besked fortsætter uændret, indtil beskeden omlægges til ny webservicebesked i en senere releaseKSSN/AD+S


Automatisk oversigt

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

Jira Legacy
serverSystem JIRA
columnssummary,varslingstype,varslingsnote,eksterne snitflader,interne snitflader,project
maximumIssues100
jqlQueryissuetype = Varsling AND linkedIssue in (DS-10489) ORDER BY summary, Varslingstype, "Eksterne snitflader", "Interne Snitflader"
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a


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.

Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til PersonRegistrationService og metoderne til registrering og opdatering af oplysninger om aktivitetstillæg følgende:

  • I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer
  • Kollektioner i PSS og PHS om aktivitetstillæg udgår (returnerer tomme lister) og oplysninger udstilles i stedet i nye Get-metoder på ny REST-service.

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.

Serviceaftager skal overgå til ny REST snitflade, men kan i en overgangsperiode (indtil 2024-1) forblive på eksisterende SOAP service ift. registrering af aktivitetstillæg således, at serviceaftager mere frit kan tilrettelægge deres IT udvikling.

Serviceaftager påvirkes i 2023-1 af, at kollektioner i PSS og PHS om aktivitetstillæg udgår (returnerer tomme lister) og oplysninger udstilles i stedet i nye Get-metoder på ny REST-service.

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.

Bemærk også infoboksen om svartider ovenfor.


AC1005.17.13.1 - Som STAR vil jeg have flyttet forretningsområdet aktivitetstillæg til forretningsdomænet Visitering og Status inkl. at det lever op til de principper, der er fastsat

Løsningsmodel (internt STAR acc.kr.)

  • Etablering af database i VisiteringOgStatus.

AC 1005.17.13.2 - Som serviceaftager og STAR vil jeg have udstillet metoderne i PersonRegistrationService vedr. aktivitetstillæg (tidl. ActivitySupplement) via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service

Der er tale om at følgende metoder i PersonRegistrationService omlægges til ny REST-service

  • CreateActivitySupplement
  • UpdateActivitySupplement

Løsningsmodel

  • Ny REST service med POST, PUT og DELETE-operationer i VisiteringOgStatus.
  • Fejlkoder bevares
  • Der ændres ikke i adgangsforhold til service/metoder 

Forretningsside for ny service til registrering og læsning oplysninger om borgers anmodning om aktivitetstillæg

VisiteringOgStatus.AktivitetstillaegService (2023-1)

Ny REST service til oprettelse og opdatering anmodninger om aktivitetstillæg. Forretningsregler for de enkelte metoder fremgår på forretningssiden for servicen.


CreateAktivitetstillaeg - ny metode til registrering af anmodninger om aktivitetstillæg

Metoden erstatter PersonRegistrationService (version 9).CreateActivitySupplement.

VisiteringOgStatusServices.AktivitetstillaegService [UDV] (Version 1, 2023-1)#CreateAktivitetstillaeg-(POST-/v1/aktivitetstillaeg)

Tilgå snitfladebeskrivelse via linket.


UpdateAktivitetstillaeg - ny metode til opdatering og berigtigelse af registrerede anmodninger om aktivitetstillæg

Metoden erstatter PersonRegistrationService (version 9).UpdateActivitySupplement.

VisiteringOgStatusServices.AktivitetstillaegService [UDV] (Version 1, 2023-1)#UpdateAktivitetstillaeg--(PUT-/v1/aktivitetstillaeg/{aktivitetstillaegId})

Tilgå snitfladebeskrivelse via linket.


GetAktivitetstillaeg - ny metode til læsning af aktuelle oplysninger om aktivitetstillæg

Metoden erstatter PersonStatusService (version 20).GetVariablePersonStatus - kollektionen ActivitySupplement

VisiteringOgStatusServices.AktivitetstillaegService [UDV] (Version 1, 2023-1)#GetAktivitetstillaeg-(GET-/v1/aktivitetstillaeg/)

Tilgå snitfladebeskrivelse via linket.


GetAktivitetstillaegHistorik - ny metode til læsning af historik oplysninger om aktivitetstillæg

Metoden erstatter PersonHistoryService (version 4).GetPersonHistory - kollektionen ActivitySupplementHistoryCollection

VisiteringOgStatusServices.AktivitetstillaegService [UDV] (Version 1, 2023-1)#GetAktivitetstillaegHistorik-(GET-/v1/aktivitetstillaeg/historik)

Tilgå snitfladebeskrivelse via linket


AC 1005.17.13.3 - Som serviceaftager vil jeg gerne beholde den eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til ny snitflade 

Løsningsmodel

  • Eksisterende SOAP-registreringsmetoder bevares 1 til 1 internt i DFDG i en overgangsperiode frem til og med 2024-1.

Serviceaftager skal dog være forberedt på, at svartiden ved kald af SOAP-udgaverne forventes at være forringet, jf. Info-boks i top af epic-dokumentet.


AC 1005.17.13.4 - 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 

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

Løsningsmodel (internt STAR acc.kr.)

  • Tilpasning af regler af for pseudonymisering og aftale hvornår data skal med i dataløft
  • Systemforvalter til retter pseudonymiseringsflow 


AC 1005.17.13.6 - PersonStatusService (version 20) udstiller ikke mere kollektion med oplysninger om aktivitetstillæg. I stedet returneres en tom liste.

PersonStatusService (version 20) udstiller ikke mere kollektionen ActivitySupplement. I stedet returneres en tom liste.

Der udstilles i stedet Get-metode i ny REST-service. Se nærmere under AC-2.


AC 1005.17.13.7 - PersonHistoryService (version 4) udstiller ikke mere kollektion med oplysninger om aktivitetstillæg. I stedet returneres en tom liste.

PersonHistoryService (version 4) udstiller ikke mere kollektionen ActivitySupplementHistoryCollection. I stedet returneres en tom liste.

Der udstilles i stedet Get-metode i ny REST-service. Se nærmere under AC-2.


AC 1005.17.13.8 Hidtidige WSRM om aktivitetstillæg GetActivitySupplementVersion8 dannes fortsat til jobcentre.

Hidtidig WSRM om aktivitetstillæg anvendes (indtil der i senere release omlægges til nye webservicebeskeder):

  • GetActivitySupplementVersion8


AC 1005.17.13.9 - Død kode i DFDG, i forbindelse med aktivitetstillæg, fjernes

Løsningsmodel (internt STAR acc.kr.)

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


AC 1005.17.13.10 - Landssupporten/LSS er skiftet over til at brug den nye REST-servicen vedr. i aktivitetstillæg i stedet for at udstille oplysningerne fra PSS / PHS.

Landssupporten/LSS er skiftet over til at brug den nye REST-servicen vedr. i aktivitetstillæg i stedet for at udstille oplysningerne fra PSS / PHS.

Løsningsmodel (internt STAR acc.kr.)

  • Landssupport/LSS er skiftet til at brug XXXXX ved brug af nyt ClientApi fra VisiteringOgStatus 
  • Kode brugt i forbindelse med XXXXX er fjernet fra LSS


AC 1005.17.13.11 - VisiteringOgStatus.VisiteringOgStatusStatusService udstiller Aktivitetstillæg

Løsningsmodel

GetPersonVisiteringOgStatusStatus-

Metoden erstatter PersonStatusService (version 20).GetVariablePersonStatus - kollektionen ActivitySupplement

VisiteringOgStatusStatusService [UDV] (Version 1, 2023-1)

Tilgå snitfladebeskrivelse via linket.


Særlige krav til test

Test scenarieBerø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:  

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: Nej, flytning til domæne 
  • Nye snitflader: Nej, flytning til domæne
  • 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