865.5 Teknisk Gæld 2019-1

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


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

Knud de Place (STAR)

(Rune Gram-Madsen (Unlicensed))

(Ulla Larney (Unlicensed))

Rolf Marcher Arndt

Kenneth Ingemann Larsen (KEIL) (Unlicensed)

2019-11.0

KSS(t.o),

A-Kasse(t.o),

Ydelsessystem(t.o),

KY/KMD-aktiv(t.o),

e-Dagpenge(t.o)

PF-1711 - Getting issue details... STATUS



1 Indholdsfortegnelse




2 Afgrænsning af epic

Afgræsning

Som STAR vil jeg have:

  • Udfaset ubrugte kodelister
  • Udfaset ubrugte WSRM besked typer

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.

AcceptkriterierBeskrivelseRelevant for
Nr.

865.5.1Som STAR vil jeg have udfaset ubrugte kodelisterDFDG
865.5.2Som STAR vil jeg have udfaset ubrugte WSRM besked typerDFDG
865.5.3Som STAR vil jeg stadig gerne have tilgang til dokumentation vedr. de fjernede kodelisterDFDG
865.5.4Som STAR vil jeg have have udført konsolidering af organisationstyper for at det fremadrettet bliver nemmere at oprette nyeDFDG, Jobnet, VITAS
865.5.5Som STAR vil jeg have genindført WSRM notifikation når der sker en berigtigelse af en besked vedrørende henvisningerDFDG
Kriterier for tilsagn til serviceaftager i forhold til STARs snitfladerBerørte acceptkriterierBemærkninger

865.5.1865.5.2865.5.3865.5.4865.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 

SnitfladeServiceaftager der er berørtBemærkninger

DFDGJobnetPlanner-systemerKSSA-kasseYdelses-systemJobkonJobagSFBIVitas

CodeListService (Version 5)

  • AvailabilityAssessmentTypeIdentifier
  • CalendarEventReceiptErrorCode
    TypeIdentifier
  • CvCauseTypeIdentifier
  • CvUpdateEventTypeIdentifier
  • EducationSourceCodeTypeIdentifier
  • IBSEventReasonTypeIdentifier
  • IBSRelevancyTypeIdentifier
  • IBSResonableCauseTypeIdentifier
  • IBSSanctionTypeIdentifier
  • IBSSupportTypeIdentifier
  • MunicipalityNotAvailableTypeIdentifier
  • MunicipalitySanctionTypeIdentifier
  • MunicipalityValidReasonTypeIdentifier
  • NonValidityTypeIdentifier
  • ReferralProgramTypeIdentifier
  • SanctionTypeIdentifier
  • ValidReasonTypeIdentifier
X









Der vil blive fjernet følgende kodelister fra CodeListService, da de er udstillet her og ikke længere bliver benyttet.

WsrmMessageService (version 10)

  • GetRecallJobReferralNotification
    EventVersion6
  • GetCitizenMessageEventVersion1
X

XX





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)

  • GetEventHistory
X









Ubrugte kodelister der er tilknyttet WSDL fjernes. Se mere under afsnit 4.1.1 *Note 1
DFDG Foundation (nuget)XX







XNy nuget package vil blive genereret, der indeholder sikkerhedsattributter der benytter de konsoliderede Organisationstyper

WsrmMessageService (version 10)

  • GetRecallJobReferralNotification
    EventVersion6
X

XX





Ved kald af UnemploymentFundMessageService (Version 3)
  • RecallJobReferralNotificationEvent

Vil der nu igen blive enqueued WSRM-besked af typen:

  • GetRecallJobReferralNotificationEventVersion6

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
Loading...
Refresh

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-3901 - Getting 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-3900 - Getting 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:

WSRMWsrmMessageServiceServiceIdBemærkning 
GetRecallJobReferralNotificationEventVersion6/wiki/spaces/GI/pages/525402186213Denne vil ikke blive fjernet se mere under afsnit 4.5 Acc.kr 865.5.5
GetCitizenMessageEventVersion1/wiki/spaces/GI/pages/525402186286

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)
  • 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.
  • Kommunalt sagsbehandlingssystem
  • A-kasse sagsbehandlingssystem
  • Kommunalt bookingsystem
    • JobcenterPlanner (JCP)
    • WorkForcePlanner (WFP)
  • Kommunalt ydelsessystem

Særlige krav til test

Test scenarieBerørte systemområder (herunder nye batchjobs*) Identificeret af

Test at Jobnet er kommet op på den nyeste nuget package

Jobnet, DFDG, DFDG FoundationRolf Marcher Arndt
Test at Vitas er kommet op på den nyeste nuget packageVitas, DFDG, DFDG FoundationRolf Marcher Arndt
Test at DFDG er kommet op på den nyeste nuget packageDFDG, DFDG FoundationRolf 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.