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

1 Indholdsfortegnelse

2 Afgrænsning af epic

3 Oversigt over berørte webservices 

4 Beskrivelse af epic

Det er et forretningsmæssigt mål at Vitas skal til at udstede egne webservices som serviceaftagere kan kalde direkte for at undgå at proxy store datamængder igennem DFDG, dette vil endvidere give mulighed for at udstille tynde WSRMer via DFDG, hvor serviceaftagere på baggrund af nøgler/andet kan kalde Vitas udstillede services for at få det resterende data, dette sikre større fleksibilitet for både service aftagere og STAR:

• Serviceaftagere vil kunne kalde Vitas udstillede services for at få ekstra data når det behøves, i modsætning til i dag, hvor serviceaftagerene modtager store mængder data over WSRMerne som de er nødsaget til at persistere.
• STAR vil i modsætning til i dag undgå datamæssige proxy ændringer og kun skulle ændre WSRMer i DFDG, hvis der kommer nye nøgler/andet der er et behov for at service aftagere har informationer nok til at kalde de Vitas udstillede services.

Den eksisterende VitasNotificationService udvides med oplysninger når der en oprettelse af en ansøgning eller der er sket en ændringer ved en bevilling/vurdering.

Den nye tynde WSRM besked - beskrevet i 942.1.2 - vil fremadrettet være gældende for de fem ordninger der er omfattet af LAB. Disse er følgende:

• Fleksjob
• Personlig Assistance
• Mentor
• Jobrotation
• Hjælpemidler

Den vil dog kun gælde for fleksjob i 19-1, men på sigt både Personlig Assistance, Mentor, Jobrotation og hjælpemidler. De gamle ordninger vil stadig fungere som tykke WSRM (nuværende design), indtil der kommer plads til at overføre disse til samme design med tynd WSRM og tilhørende Get. Der er et fremtidigt ønske om at alle ordninger, i Vitas, skal overgå til tynde WSRM beskeder, og dertilhørende Get metoder. Rent tidsmæssigt er dette stadig uvist grundet, at LAB udviklingen vil skulle prioriteres først, men LAB vil også involvere gamle ordninger. Der vil foretages analyser af de gamle ordninger (de tykke WSRM), når udviklingen rammer disse, men tidshorisonten for dette er uklart, da de nye ordninger vil skulle prioriteres først.   

Nedenfor gennemgås flow for Vitas notifikationer:

1. Når en ansøgning fleksjobanmodning, bevilling/vurdering eller IGU-aftale oprettes eller når en hændelse indtræffer i Vitas, udføres servicekald fra Vitas til DFDG med en JobCenterCodeType som kan afgøre, hvem der skal modtage beskeden samt information om ansøgning, bevilling eller aftalen.
   Der udføres dette servicekald når en af nedenstående hændelser indtræffer for hhv. ansøgninger/anmodninger og bevillinger/vurderinger. 
   • Ansøgningshændelser (se: JobOfferStatusTypeIdentifier)
   • Bevillingshændelser/vurderingshændelser (se: JobAllocationStatusTypeIdentifier)
   • Aftalehændelser (Se: AgreementStatusTypeIdentifier)
   • VitasNotifikationServicen trigger en WRSM besked til KSS’erne (det jobcenter med den angivende JobCenterCodeType) i de situationer, der er angivet ovenfor.
     I disse WSRM beskeder vil der være nøjagtigt så meget data at KSSerne har mulighed for at hente yderligere informationer vedrørende sagen ved at kalde nye services oprettet direkte i VItas.

2. Der oprettes således WSRM-besked når ansøgning oprettes og indsendes til jobcenter

3. Der oprettes WSRM-besked når ansøgning godkendes

4. Der oprettes WSRM-besked når bevilling/vurdering oprettes og afsluttes.

5. Det er muligt for aftager system at kalde webservice ved Vitas og aftage sagsdata direkte fra Vitas.

4.1 Acc.kr. 942.1.1 Som Vitas vil jeg kunne kalde servicemetode i DFDG for at gøre det pågældende jobcenter opmærksom på når en ansøgning, fleksjobanmodning, bevilling/vurdering eller IGU-aftale oprettes eller når en hændelse indtræffer

Som del af implementeringen, er det tiltænkt at Vitas skal kalde ny servicemetode i DFDG, for at DFDG på baggrund af servicekaldet generere en WSRM til det pågældende jobcenter ACC 942.1.2.

Ny servicemetode SendCaseNotification tilføjes til eksisterende version af VitasNotificationService (Version 6), hvor typer indeholder den fornødende mængde data til at KSS vil have mulighed for at kalde Vitas oprettede services for at få yderligere data.

Se servicemetode typer her: VitasNotificationService (Version 6, 2019-1)#1)-SendCaseNotification

I release 2019-1:

Når en evaluering eller en anmodning om fleksjob registreres i Vitas, kalder Vitas denne servicemetode for at generere tynd WSRM til KSS mfl. (Acc.kr 942.1.2)

4.2 Acc.kr 942.1.2 Som Vitas ønsker jeg at ved kald af servicemetode i Acc942.1.1 at der bliver genereret en tynd WSRM besked til den pågældende aftager så aftagersystem har mulighed for at hente yderligere oplysninger direkte i Vitas via service

For at undgå at DFDG skal proxy for meget data er det besluttet at Vitas gør brug af Foundation, hvilket gør det muligt for Vitas at udstille service get-metoder.

Det vælges derfor at udstille følgende via den nye ’tynde’ WSRM:

• De inputparametre der er nødvendige for at kalde en fremtidig Get-metode ved Vitas.
• Statustype, der gør det muligt for aftager, at identificerer hvilken status en ansøgning, bevilling/vurdering befinder sig i.
• Enkelte stamoplysninger på en sag, således det eksempelvis er muligt at identificerer sager på en specifik borger eller en virksomhed og efterfølgende hente data på disse.
• URL til Vitas. Dybt link til sagen i Vitas, således det er muligt udelukkende at lave løsninger, der kan videre stille i til sagen i Vitas via link. (sagsbehandler identificeres som i nuværende løsning igennem kommunalt ADFS når link åbnes).

Ny servicemetode GetVitasCaseNotificationVersion1 tilføjes eksisterende version af WsrmMessageService (Version 11)

Se servicemetode typer her: WsrmMessageService (Version 11, 2019-1)#1)-GetVitasCaseNotificationVersion1

I release 2019-1:

Serviceaftagere der abonnerer på GetVitasCaseNotificationVersion1 vil kunne forvente at modtage WSRM ved registrering af fleksjob evaluering og fleksjob anmodning i Vitas.

4.3 Acc.kr 942.1.3 Som STAR vil jeg have automatisk opdateret dokumentation med de nye snitflader fra Vitas kodet i Foundation

Det er et klart ønske fra STAR, at eksisterende snitflade dokumentation opdateres automatisk.

Da Vitas skal i gang med at benytte Foundation til at udstille egne webservices med DFDGs sikkerheds model, skal disse webservices tilføjes til den automatgenere dokumentation som befinder sig på STARWIKI.

Følgende overvejelser skal gøres i den forbindelse:

• Wiki struktur over disse nye services.

Opgaven der forlægger er at tilrette det eksisterende Wiki oploader tool som generere de eksisterende snitflade beskrivelser ud fra WSDLer fra webservices.

5 Særlige krav til test

* 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

6 Konsekvenser for drift/idriftsættelse

I forbindelse med idriftsættelse

• Serviceaftagere skal kalde nyt service endpoint til de nyoprettede Vitas services udstillet via Foundation.
• Vitas projekt der indeholder services udstillet via Foundation skal have adgang til DFDGs sikkerheds database.
• Servicekatalog til Vitas skal oprettes og vedligeholdes i Profiledata databasens tabeller WebserviceCatalog, Webservice og WebserviceMethod gældende for både testmiljøer hos Vitas samt i PREPROD og PROD.
• Servere, hvorpå Vitas udstiller Foundation-baserede webservices, skal have oprettet eventloggen KC_ERROR. DFDG har Powershell script til dette.

• 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:

7 Arkitektur- og implementeringsnoter

7.1 Tynde WSRM beskeder

Arkitekturmæssigt er det blevet besluttet, at DFDG implementerer en tynd WSRM besked på forretningsområdet for Vitas. Den tynde WSRM besked vil benyttes fremadrettet og på tværs af ordninger. Ligeledes vil den tynde WSRM besked indeholde nok information til, at KSS’erne informeres om hændelser i Vitas og at de på baggrund af den tynde WSRSM besked kan hente yderligere data fra webservices, som udstilles af Vitas.

Den arkitekturmæssige beslutning er taget i forhold til følgende punkter:

• DFDG skal ikke implementerer WSRM beskeder indeholdende domænemodeller for de enkelte ordninger i Vitas.
• DFDG skal ikke implementerer webservices, som bare agere proxy mod Vitas.
• DFDG, Vitas og KSS’er kan genbruge den tynde WSRM besked på tværs af ordninger.

De kodelister, som indgår i den tynde WSRM besked, er ejet af DFDG og udstilles på DFDG’s CodeListService.

7.2 Miljøbeskrivelse til test af tynde WSRM beskeder i 2019-1

De tynde WSRM beskeder, der i DFDG implementeres på forretningsområdet for Vitas, bliver udviklet til 2019-1. Dette er ensbetydende med, at Vitas i denne Release vil lægge tynde WSRM beskeder på WSRM køerne i T3 ved hjælp af webservicemetoden SendCaseNotification på VitasNotificationService (version 6).

KSS’erne kan hente de tynde WSRM beskeder for dette forretningsområde på webservicemetoden GetVitasCaseNotificationVersion1 på WsrmMessageService (version 11) i T3.

Vitas vil fremadrettet udstille selvstændige webservices, som indeholder Get metoder, hvorpå KSS’erne kan hente yderligere information (data) til de ordninger, som har givet anledning til en tynd WSRM besked. Disse af Vitas udstillede webservices kan tilgås på det Vitas link, som er tilknyttet T3.

7.3 DFDG agerer ikke proxy for Vitas

For at afkoble logiske og såvel som fysiske forretningsmodeller (domænemodeller) i STAR’s systemportefølje er det blevet besluttet, at DFDG ikke længere skal agere proxy for Vitas. Dette betyder, at DFDG fremadrettet ikke vil implementere servicemetoder, som indeholder domænemodeller for de enkelte ordninger i Vitas.

DFDG implementerer kun en tynd WSRM besked i henhold til ovenstående afsnit. Vitas udstiller selv webservices, som er baseret på Foundation, hvorfra KSS’erne kan hente domænemodellerne i Vitas.

7.4 Sikkerhed på webservicemetoder udstillet i Vitas

De webservices, hvorpå KSS’erne kan hente data fra Vitas, er baseret på Foundation, hvilket betyder, at de benytter samme sikkerhedsmodel, fejlkontrakt m.m. som services i DFDG. Nedenstående figur illustrerer de siloer, som i STAR’s systemporteføje p.t. udstiller webservices, der er baseret på Foundation.

Figuren viser også, at Foundation gør brug af databasen Profiledata, hvilket betyder, at hver silo skal have kendskab til denne fælles database.

Gældende for siloen til Vitas er, at:

• Testmiljøer hos Vitas skal have adgang til en Profiledata database, som enten kan være en selvstædig kopi af databasen fra DFDG eller den samme database, som DFDG benytter i deres testmiljøer.
• PREPROD og PROD hos Vitas skal have adgang til samme Profiledata database, som benyttes af DFDG og Jobnet i PREPROD og PROD.
• Servicekatalog til Vitas skal oprettes og vedligeholdes i Profiledata databasens tabeller WebserviceCatalog, Webservice og WebserviceMethod, således at den graduerede sikkerhedsmodel kan benyttes på de af Vitas udstillede webservicemetoder. Dette er gældende for både testmiljøer hos Vitas samt i PREPROD og PROD.

Myndigheders adgang til borgere på de webservicemetoder, som udstilles af Vitas, styres også gennem Foundation ved hjælp af attributten AllowAccessAttribute. Alle webservicemetoder i Vitas dekoreres med en til flere forekomster af denne attribut, hvor det angives, hvilken myndighedstype, der må tilgå hvilke borgere, eksempelvis at STAR må tilgå alle borgere.

Jobcentre må i visse tilfælde tilgå alle borgere, da det ved eksempelvis voksenlærlingeordningen er virksomhedens geografi, der er bestemmende for, hvilket jobcenter, der behandler ansøgningen og ikke borgeres tilhørsforhold. I de situationer, hvor jobcentre og kommuner kun må tilgå egne borgere, er det en forudsætning, at der indgår en Property af typen PersonCivilRegistrationIdentifierType (typen findes i Foundation) med navnet PersonCivilRegistrationIdentifier i Requests til de webservicemetoder, hvor myndigheden kun må tilgå egne borgere.

Der åbnes også for, at anden aktør kan handle på vejene af jobcentre.

7.5 Implementerings- og idriftsættelsesnoter i forbindelse med ibrugtagelse af Foundation i Vitas

Foundation gør brug af eventloggen med navnet KC_ERROR, hvilket betyder, at de servere, hvorpå Vitas udstiller deres webservices, skal have oprettet eventloggen KC_ERROR. DFDG har i deres installationspakke et Powershell script, der kan oprette denne eventlog.