865.5 Teknisk Gæld 2019-1
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
1 Indholdsfortegnelse
2 Afgrænsning af epic
Afgræsning | ||
---|---|---|
Som STAR vil jeg have:
for at kompleksiteten og ubrugt kode i DFDG nedbringes og så eksterne aftagere ikke skal bruge ressourcer på at overveje brug af / hvad ubrugte kodelister og WSRM'er mon skal bruges til. Som STAR vil jeg have udført konsolidering af organisationstyper for at det fremadrettet bliver nemmere at oprette nye. Som STAR vil jeg have, at serviceaftagere der har brug for UPH/NUPH informationer igen får WSRM ved berigtigelser af henvisninger. | ||
Acceptkriterier | Beskrivelse | Relevant for |
Nr. | ||
865.5.1 | Som STAR vil jeg have udfaset ubrugte kodelister | DFDG |
865.5.2 | Som STAR vil jeg have udfaset ubrugte WSRM besked typer | DFDG |
865.5.3 | Som STAR vil jeg stadig gerne have tilgang til dokumentation vedr. de fjernede kodelister | DFDG |
865.5.4 | Som STAR vil jeg have have udført konsolidering af organisationstyper for at det fremadrettet bliver nemmere at oprette nye | DFDG, Jobnet, VITAS |
865.5.5 | Som STAR vil jeg have genindført WSRM notifikation når der sker en berigtigelse af en besked vedrørende henvisninger | DFDG |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | ||||
---|---|---|---|---|---|---|
865.5.1 | 865.5.2 | 865.5.3 | 865.5.4 | 865.5.5 | ||
Som STAR vil jeg have udfaset ubrugte kodelister | X | Der vil blive fjernet metoder på CodeListService for de ubrugte kodelister, der er udstillet her. | ||||
Som STAR vil jeg have udfaset ubrugte WSRM besked typer | X | Der vil også blive fjernet metoder på WsrmMessageService (version 10), som ikke længere bliver enqueued. WSRM besked metoderne ligger også på andre services og det identificeres, om der er nogen af dem som kan fjernes. | ||||
Ingen ændringer til serviceaftagere, DFDG og DFDG Foundation validerer via sikkerhedsattributter med de konsoliderede Organisationstyper fremfor tidligere, hvor der var flere lister af organisationstyper i brug. | X | T.O. da der disse bliver benyttet af sikkerhedsattributter på samtlige services. Der er ingen kode ændringer i forbindelse med dette til serviceaftagere, da det skal fungere på samme måde som tidligere. | ||||
Genindførsel af enqueing af WSRM'en GetRecallJobReferralNotificationEventVersion6 | X | T.O. da serviceaftagere, der abonnerer på denne besked, igen vil modtage WSRM ved kald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent NB. Efter kodegennemgang har det vist sig at denne WSRM bliver enqueued ved kald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent dog bliver service metoden ikke benyttet ofte. |
3 Oversigt over berørte webservices
Snitflade | Serviceaftager der er berørt | Bemærkninger | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
DFDG | Jobnet | Planner-systemer | KSS | A-kasse | Ydelses-system | Jobkon | Jobag | SF | BI | Vitas | ||
CodeListService (Version 5)
| X | Der vil blive fjernet følgende kodelister fra CodeListService, da de er udstillet her og ikke længere bliver benyttet. | ||||||||||
WsrmMessageService (version 10)
| X | X | X | Metoder vil blive fjernet, da beskederne ikke længere bliver enqueued NB. GetRecallJobReferralNotificationEventVersion6 vil ikke blive fjernet men vil i stedet blive enqueued se Acc.kr 865.5.5 NB. Efter kodegennemgang har det vist sig at denne WSRM GetRecallJobReferralNotificationEventVersion6 bliver enqueued ved kald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent dog bliver service metoden ikke benyttet ofte. | ||||||||
UnemploymentFundEventHistoryService (Version 3)
| X | Ubrugte kodelister der er tilknyttet WSDL fjernes. Se mere under afsnit 4.1.1 *Note 1 | ||||||||||
DFDG Foundation (nuget) | X | X | X | Ny nuget package vil blive genereret, der indeholder sikkerhedsattributter der benytter de konsoliderede Organisationstyper | ||||||||
WsrmMessageService (version 10)
| X | X | X | Ved kald af UnemploymentFundMessageService (Version 3)
Vil der nu igen blive enqueued WSRM-besked af typen:
NB. Efter kodegennemgang har det vist sig at denne WSRM GetRecallJobReferralNotificationEventVersion6 bliver enqueued ved kald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent dog bliver service metoden ikke benyttet ofte. |
Førsøg fra Jira nedenstående:
summary | varslingstype | varslingsnote | eksterne snitflader | interne snitflader | project | description |
---|
4 Beskrivelse af epic
4.1 Acc.kr. 865.5.1 - Ubrugte kodelister
4.1.1 Identificering af kodelister der kan fjernes og hvilke der er udstillet af CodeListService (Version 5)
Af userstory - US-3901Getting issue details... STATUS
Er der blevet identificeret følgende kodelister:
4.1.1.1 *Note 1
Det er identificeret at nogle af kodelisterne under afsnit 4.1.1 *Note 1 bliver refereret i WSDLen til UnemploymentFundEventHistoryService (Version 3)
I metoden GetEventHistory.
Disse kodelister vil blive fjernet fra WSDLen, i PjaktassWCFServices og DFDG.ServiceGateway
4.2 Acc.kr. 865.5.2 - Ubrugte WSRM beskeder
4.2.1 Identificering af WSRM beskeder der ikke længere blive enqueued
Af analyse-userstory - US-3900Getting issue details... STATUS er der blevet identificeret følgende WSRMer, analysen gik på at finde WSRM beskeder der ikke længere bliver enqueued:
GetRecallJobReferralNotificationEventVersion6
Under siden /wiki/spaces/CITY/pages/38666748 er denne WSRM omtalt under afsnittet:
Oversigt over webservices og WSRM-beskeder som implementeres i fase 2
WsrmMessageService (Version 6): Denne service gør det muligt at hente diverse WSRM-beskeder. Specifikt for a-kassekommunikation, så implementerer den understående metoder som omhandler UPH'er, henvisninger, cv'er og tilbagemeldinger.
- GetCompulsoryNotificationEventVersion6 - WSRM besked, som sendes ved underretningspligtige hændelser (UPH'er).
- GetRecallCompulsoryNotificationEventVersion6 - WSRM besked, som sendes ved berigtigelse af en underretningspligtige hændelser.
- GetJobReferralNotificationEventVersion6 - WSRM besked, som sendes ved alle beskeder, der vedrører henvisninger (også UPH'er).
- GetRecallJobReferralNotificationEventVersion6 - WSRM besked, som sendes ved berigtigelse af beskeder, der vedrører henvisninger.
- GetJobPlanEventVersion6 - WSRM-besked vedrørende aktiveringer både inden for og uden for en jobplan.
- GetCVStatusVersion5 - Jobcentret kan hente WSRM-beskeden GetCVStatusVersion5, når a-kassen via a-kassemotoren meddeler, at den har gennemført en CV-samtale. A-kassen vil modtage denne i kopi.
- GetUnemploymentAvailabilityAssessment - Jobcentret kan hente WSRM-beskeden GetUnemploymentAvailabilityAssessment som svar på en N-UPH, der medfører en tilbagemelding/rådighedsvurdering fra a-kassen og a-kassen vil modtage dette i kopi.
GetCitizenMessageEventVersion1
Er omtalt på siden /wiki/spaces/GI/pages/525074503
Besked om, at der er lavet besked til borger eller sagsbehandler i dialogmodulet (CitizenMessageService (2016-4)).
Det er identificeret, at der både eksisterer version 2 og en version 3 af beskeden (GetCitizenMessageEventVersion2 og en GetCitizenMessageEventVersion3).
4.2.2 WsrmMessageService (version 10)
Følgende metoder på WsrmMessageService (version 10) vil udfases, da der ikke længere bliver enqueued beskeder til WSRM køen:
WSRM | WsrmMessageService | ServiceId | Bemærkning |
---|---|---|---|
Denne vil ikke blive fjernet se mere under afsnit 4.5 Acc.kr 865.5.5 | |||
GetCitizenMessageEventVersion1 | /wiki/spaces/GI/pages/525402186 | 286 |
NB. tidligere var GetRecallJobReferralNotificationEventVersion6 på denne liste men er flyttet til afsnit 4.5 Acc.kr 865.5.5
4.3 Acc.kr. 856.5.3 - Dokumentation af fjernede kodelister
På nuværende tidspunkt er alle kodelister præsenteret på WIKI:
Der er et ønske fra STARs side, at der stadig er mulighed for at fremsøge dokumentation om de fjernede kodelister på WIKI. Dette er blandt andet til brug i fremtidige tvivlsspørgsmål og til dokumentations overlevering til Statens Arkiver.
I forbindelse med identificering af kodelisterne, der kan fjernes i afsnit 4.1.1, flyttes disse til rummet Gammelt indhold under punktet:
4.4 Acc.kr. 865.5.4 Konsolidering af Organisationstyper
Det er et forretningsmæssigt ønske at gøre DFDG-oprettelsesprocessen for organisationstyper nemmere.
I Manuscript sag 121929 blev der oprettet en ny organisationstype, hvor også Wiki siden /wiki/spaces/CITY/pages/38666407 blev opdateret.
Oprettelsesprocessen for nye organisationstyper er i dag ret besværlig, da der er en del teknisk gæld på dette område. For at gøre processen for oprettelse nemmere fremadrettet, er det derfor besluttet at gøre dette mere ensformigt.
Dette gøres ved at konsolidere organisationstyper så der i kun er en liste, hvilket vil gøre det væsentligt nemmere fremadrettet at oprette nye.
Dette vil berøre alle webservices udstillet af DFDG og services udstillet via DFDG Foundation, da disse organisationstyper benyttes i de sikkerhedsattributter, der er på disse services.
Interne projekter (p.t. Jobnet og VITAS) der gør brug af DFDG Foundation
- Vil skulle opdatere til nuget package der indeholder denne rettelse.
- Konsekvensrette hvis der i projekterne benyttes login funktionalitet fra DFDG Foundation.
Gevinst for interne projekter der gør brug af DFDG Foundation
- Gevinsten er antallet af konsekvensrettelser, der skal laves i projekterne, der benytter sig af DFDG Foundation, "nu" fremfor hvis ændringen først foretages senere.
- I øjeblikket er det en ret begrænset mængde services, der bliver udstillet via DFDG Foundation, hvilket gør, at antallet af konsekvensrettelser er relativt lavt.
- Antallet af services, der gør brug af DFDG Foundation, vil med al sandsynlighed blive større fremadrettet, hvilket vil gøre at antallet af konsekvensrettelser vil vokse, hvis det er man venter med denne opgave.
Serviceaftagere der gør brug af DFDG services og/eller services, der udstilles via DFDG Foundation
- Vil IKKE skulle lave ændringer på eksisterende servicekald, da konsolideringsopgaven er en opgave, der sker internt i DFDG/DFDG Foundation.
4.4.1 Risiko minimering i forbindelse med implementering
I forbindelse med implementering af dette er der en del risici, da da man konsoliderer organisationstyper, hvilket bliver brugt af de sikkerhedsattributter som services/metoder i DFDG samt de services/metoder projekterne der benytter sig af DFDG Foundation udstiller.
For at nedbringe denne risiko bliver følgende tiltag gjort i forbindelse med implementeringen og testningen af denne konsolidering:
- Da det vil være en massiv manuel testopgave med chance for manuelle fejl, at teste samtlige services/metoder DFDG udstiller med samtlige organisationstyper, vil man forsøge at gøre dette ved hjælp af en automatisk sammenligning for at sikre sig at organisationstyperne efter implementering er den samme som tidligere.
- Manuel test opgave i AmpAdmin2, hvor man har mulighed for at sætte sikkerheden op på services og metoder, der er udstillet via DFDG og DFDG Foundation.
- Her vil samtlige kombinationer af konsoliderede organisationstyper blive testet.
4.5 Acc.kr 865.5.5 Som STAR vil jeg have genindført WSRM notifikation når der sker en berigtigelse af en besked der vedrører henvisninger
Af afsnit 4.2.1 blev der fortaget en analyse af WSRM beskeder der ikke længere bliver enqueued, her blev det identificeret, at blandt andet WSRM GetRecallJobReferralNotificationEventVersion6 ikke blev enqueued.
Dette er i midlertidigt en fejl, da der er et forretningsmæssigt behov for, at aftagere af UPH/NUPH bliver gjort opmærksom på berigtigelser på henvisninger.
- Ved servicekald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent vil der igen blive enqueued WSRM besked af typen GetRecallJobReferralNotificationEventVersion6.
Der vil ikke blive fortaget datagenopretning og sendt WSRMer af typen GetRecallJobReferralNotificationEventVersion6 på historiske kald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent.
NB. Efter kodegennemgang viser det sig at denne WSRM bliver enqueued ved kald af UnemploymentFundMessageService (Version 3).RecallJobReferralNotificationEvent, dog bliver service metoden ikke benyttet ofte.
Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:
- DFDG
- Services
- WsrmMessageService (Version 10): Metoder vil blive fjernet, hvis beskederne ikke længere bliver enqueued fra koden.
- CodeListService (Version 5): Metoder vil blive fjernet, hvis ubrugte kodelister bliver udstillet her.
- WSRM'er
- WSRM' er der ikke længere bliver enqueded: Beskedtyperne fjernes.
- Kodelister
- Kodelister der ikke længere bliver benyttet: Kodelisterne fjernes i koden.
- PersonStatusService (PSS)
- PersonHistoryService (PHS)
- LSS (Landssupportsystem) og herunder Registerudtræk (hvis STAR har dataejerskab og der er lavet PHS på domænet)
- Services
- Jobnet
- VITAS
- JobKon
- JobAG
- BI integrationsplatform
- Alle områder
- Nye batchjobs
- Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon)
- Dataløft
- Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.
- Nye batchjobs
- Kommunalt sagsbehandlingssystem
- A-kasse sagsbehandlingssystem
- Kommunalt bookingsystem
- JobcenterPlanner (JCP)
- WorkForcePlanner (WFP)
- Kommunalt ydelsessystem
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
Test at Jobnet er kommet op på den nyeste nuget package | Jobnet, DFDG, DFDG Foundation | Rolf Marcher Arndt |
Test at Vitas er kommet op på den nyeste nuget package | Vitas, DFDG, DFDG Foundation | Rolf Marcher Arndt |
Test at DFDG er kommet op på den nyeste nuget package | DFDG, DFDG Foundation | Rolf Marcher Arndt |
* 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:
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
- Nye dataområder: Nej
- Nye snitflader; Nej
- Nye komponenter: Nej, men Nuget package skal opdateres
- Nye miljøer: Nej
- Nye teknologier: Nej
- Nye aftagertyper: Nej
- Eller afvigelser fra principperne: Nej
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.