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

Indholdsfortegnelse

Afgrænsning af epic

Oversigt over berørte webservices 

Manuelt dannet oversigt

Oversigt over berørte webservices 

Manuelt dannet oversigt

Links er ikke klikbare for eksterne, men de indeholder i øvrigt ikke mere relevant information end hvad der fremgår af tabellen.

Bemærk at vi holder den kørende "opsætning" i live aht. åben ibrugtagningsdato for KSS-systemerne. Det handler om at

• PersonGroupProjectService (Version 6)
• PersonStatusService collection GetPersonGroupMarkingInfo
• PersonRegistrationService metoder til projekt-markeringer og
• WSRM  GetPersonGroupProjectVersion5

fortsat kan anvendes.

Derimod håber vi at I vil lade os lukke

• GetPersonGroupMarkingVersion4 og 
• PersonVisitationStatusService (Version 1) - denne service har endnu ikke (pr. 1.11.2019) været anvendt af jobcentre og a-kasser i produktion.

Nye aftagere forventes at bruge de nyeste versioner af alle services.

Automatisk dannet oversigt

Oversigt er ikke synlig for eksterne brugere uden STAR Jira-konto.

Beskrivelse af epic

Persongruppeprojekterne moderniseres til at kunne omfatte a-kasserne, og kombinationer af a-kasser og jobcentre.

Med arkitekturmålene i tankerne flyttes tilknytningsfunktionerne væk fra PersonRegistrationService, og ind i PersonGroupProjectService. På samme baggrund overtager PersonVisitationStatusService PersonGroupMarkingInfo fra PersonStatusService.

Bemærk dog, jf. indledningen (se nærmere i beskrivelse under afsnit om berørte services), at vi holder den kørende "opsætning" i live aht. åben ibrugtagningsdato for KSS-systemerne.

Acc.kr. 953.1.1 - Regionale persongruppeprojekter udgår

Webserviceunderstøttelsen indeholder mulighed for anvendelse af regionale persongruppeprojekter og afspejler dermed ikke, at beskæftigelsesregionerne er nedlagt i 2015.

Ønsket er derfor, at regionale persongruppeprojekter ikke længere kan oprettes, opdateres, hentes eller slettes. 

Der er pr. 04.01.2019 samlet set 7.786 persongruppeprojekter, hvor ét er et regionalt projekt ("Etableringsordning om vækst- og vidensiværksætteri", der var aktivt i perioden 28-06-2013 til 31-12-2014). Data vedrørende dette projekt vil derfor være afleveret til Statens Arkiver ved seneste aflevering i 2017/2018 - og online data i DFDG vedrørende regionale projekter vil derfor uden hensyn til fremtidig aflevering til Statens Arkiver kunne slettes eller arkiveres. 

CodeListService (version 5).PersonGroupProjectTypeIdentifier

Id 1 rettes med justeret navn for at tydeliggøre at det er alle jobcentre der er med i et statsligt projekt. Id 2 får slutdato. Id 3 får tilføjet "og STAR". Id 4 og 5: Nye id'er jf. acceptkriterie 3 og 4.

Acc.kr. 953.1.3 - A-kasser kan anvende persongruppeprojekter

A-kasserne kan i dag ikke anvende eller registrere persongruppeprojekter (via PersonGroupProjectService) eller persongruppemarkeringer (via PersonRegistrationService). Der har gennem tiden været behov for, at a-kasserne kunne anvende persongruppeprojekter og persongruppemarkeringer, men det er aldrig blevet etableret, da der ikke har været tilstrækkelig kalendertid mellem behovets opstået og behovet for anvendelsen af en sådan understøttelse.

Ønsket er derfor, at a-kasser skal kunne oprette, opdatere, hente og slette a-kasse projekter og a-kasse markeringer. STAR skal også kunne oprette, opdatere, hente og slette a-kasse-projekter (svarende til, at STAR kan oprette og redigere jobcenterprojekter).

A-kasserne kan ikke se persongruppeprojekter af typen "1 - Stat - Jobcenter". Ved behov for statslige persongruppeprojekter med a-kassedeltagelse oprettes i stedet et type 5 - "Stat, a-kasse og jobcenter" hvor alle a-kasser tilføjes.

WSRM-behov: A-kasserne skal modtage WSRM'er svarende til hvad jobcentrene modtager ved oprettelse og redigering af jobcenter persongruppeprojekter og persongruppemarkeringer.

Det er frivilligt for a-kasser at tage denne nye mulighed i brug i release 2020-1.

Acc.kr. 953.1.2 - Fælles projekter afgrænset til udvalgte jobcentre og a-kasser

Forretningsbehov: Formidlingsopgaver på tværs af jobcentre og a-kasser

Persongruppemarkeringerne benyttes i større og større udstrækning til formidlingsopgaver, hvor grupper af jobcentre samarbejder omkring persongruppemarkeringer. For at de kan benyttes til udsøgning på tværs af jobcentrene, skal persongruppeprojektet idag oprettes som statsligt persongruppeprojekt, hvilket betyder, at alle jobcentre kan benytte de samme projekter, og dermed utilsigtet spænde ben for hinanden. Når statslige projekter i dag oprettes til brug i alene få jobcentre, gør det endvidere drop-down-lister m.v. i KSS uoverskuelige i alle jobcentre, da der udstilles valgmuligheder, der reelt ikke skal bruges i de enkelte jobcentre.

Ønsket er derfor, at der ved oprettelse af persongruppeprojekter kan markeres for, om persongruppeprojektet skal kunne benyttes af alle jobcentre eller en mindre gruppe, hvor jobcentrene i gruppen kan markeres, så persongruppeprojektet kun kan ses og benyttes af disse jobcentre.

For samtidigt at understøtte at a-kasser og jobcentre kan samarbejde omrking en gruppe borgere, åbnes der op for at der på et sådant tværgående projekt kan være myndigheder af begge typer.

WSRM-behov skal afklares: Forventet løsning er at de deltagende a-kasser og jobcentre skal have WSRM'er om de pågældende persongruppeprojekter.

Forsøg og projekter

Persongruppemarkeringerne benyttes ofte ved forsøg, hvor der kan være flere deltagerkommuner/-jobcentre, der indgår i forsøget. For at kunne foretage udsøgning, registrering m.v. af deltagere på tværs af jobcentre - og samtidig gøre statistisk opfølgning på forsøget mulig via brug af ét eller få persongruppe projekter - oprettes persongruppeprojektet/-erne som statslige projekter, hvilket betyder, at alle jobcentre kan benytte de samme projekter, og dermed risikere utilsigtet at registrere på et projekt som kun deltagende forsøgskommuner/-jobcentre bør anvende. Når statslige projekter i dag oprettes til brug i alene få forsøgsdeltager-jobcentre, gør det endvidere drop-down-lister m.v. i KSS uoverskuelige i alle jobcentre, da der udstilles valgmuligheder, der reelt ikke skal bruges i de enkelte jobcentre uden for et givet forsøg.

Ønsket er derfor, at der ved oprettelse af persongruppeprojekter kan markeres for, om persongruppeprojektet skal kunne benyttes af alle jobcentre eller en mindre gruppe, hvor jobcentrene i gruppen kan markeres, så persongruppeprojektet kun kan ses og benyttes af disse jobcentre.

WSRM-behov: Formentlig skal alene de deltagende forsøgsdeltager-jobcentre have WSRM'er om de pågældende persongruppeprojekter.

WSRM-udsendelse og adgang generelt

WSRM-udsendelsen kompliceres af at der i et givent tværgående projekt (type 1 og 5) vil være en del borgere som ikke er "egne" (dvs. i eget jobcenter eller a-kasse) og som man derfor ikke bør have WSRM om.

Den myndighed som har knyttet en borger til et projekt, er også den der kan opdatere (og dermed sætte slutdato) på borgerens tilkytning til projektet.

Projekttype	WSRM ved projektændring2	WSRM ved ændret persontilknytning3	Adgang til at se borgers deltagelse i statusservice	Adgang til at se borgers deltagelse når projektdeltagere slås op på specifikt projekt	Adgang til at oprette og håndtere projekt
Stat - jobcenter (type 1)	Alle jobcentre får WSRM	Egne borgere	Alle jobcentre kan se egne borgere	Alle jobcentre kan se alle deltagende borgere	STAR
Jobcenter (type 3)	Deltagende jobcenter	Egne borgere	Deltagende jobcenter kan se egne borgere	Oprettende jobcenter	(Oprettende) Jobcenter
A-kasse (type 4)	Deltagende a-kasse	Egne borgere4	Deltagende a-kasse kan se egne borgere	Oprettende a-kasse	(Oprettende) A-kasse
Stat, a-kasse og jobcenter (type 5)	Deltagende myndigheder	Egne borgere4	Deltagende myndigheder kan se egne borgere	Deltagende myndigheder kan se alle deltagende borgere1	STAR

: STAR kan se og håndtere alle borgeres deltagelse (af support-hensyn).

Note 1: Bemærk at vi her fraviger en norm, idet a-kasser for en sjælden gangs skyld får adgang til at se borgere som ikke er medlemmer i den pågældende a-kasse.

Note 2: Ved ændringer til projekter sendes både WSRM GetPersonGroupProjectVersion5 og GetPersonGroupProjectVersion6 til deltagende myndigheder. Dog sendes kun version6 hvis ændringen udelukkende består af at der tilknyttes eller afkobles myndigheder fra et tværgående projekt, da deltagende myndigheder ikke fremgår af version 5. Når der tilføjes eller fjernes en myndighed fra et projekt er det kun den direkte berørte myndighed der får WSRM om dette (og altså ikke øvrige projektdeltagere). På version6 af WSRM'en har man listen af tilknyttede myndigheder, hvor man kan se at man er tilføjet respektive ikke længere er med.

Note 3: Ved ændringer til persongruppemarkeringer på et projekt sendes WSRM GetPersonGroupMarkingVersion5

Note 4: Bemærk at a-kasser udelukkende får WSRM om dagpengemodtagere (kontaktgruppe id 1). Der sendes ikke WSRM til a-kasserne om borgere som er i øvrige kontaktgrupper. 

Flytning og skift af a-kasse samt Landssupportens fjernelse af myndighed fra et tværgående projekt

Hvis en borger skifter a-kasse, sætter DFDG slutdato på de tilknytninger til persongruppeprojekter, som a-kassen har oprettet på medlemmet og sender WSRM GetPersonGroupMarkingVersion5. Ved tværgående projekter (type 5 - "Stat, a-kasse og jobcenter") får borgerens jobcenter også besked om dette med WSRM.

Hvis en borger flytter (CPR-flytning mellem kommuner) sættes der tilsvarende slutdato på de tilknytninger til persongruppeprojekter som jobcentret har oprettet på medlemmet og der sendes WSRM. Ved tværgående projekter får borgerens a-kasse besked om dette med WSRM.

Hvis en borger som er tilknyttet et statsligt projekt flytter, opdateres ejerskabet af projektmarkeringen til at være det jobcenter som borgeren flytter til. 

Hvis en projektdeltagende myndighed fjernes fra et projekt, sættes der slutdato på de borgertilknytninger som den pågældende myndighed måtte have oprettet. Der sendes WSRM til denne myndighed og eventuel anden myndighed som har borgeren. 

Acc.kr. 953.1.4 - STAR kan angive om tværgående persongruppeprojekter må anvendes af jobcentre og/eller a-kasser

Af hensyn til datakvalitet/-fangst er der brug for, at STAR kan angive om statslige persongruppeprojekter må anvendes af jobcentre og/eller a-kasser.

Løsningen slås sammen med løsningen af 953.1.2 umiddelbart ovenfor

PersonGroupProjectService (Version 7)

Der er navngivningsændringer til metoder, til felter og opdaterede returtyper til såvel eksisterende metoder som metoder som flytter ind fra andre services.

Persontilknytningsmetoderne CreatePersonGroupMarking, UpdatePersonGroupMarking og DeletePersonGroupMarking flytter ind i denne service (de har tidligere ligget i PersonRegistrationService).

GetPersonGroupProject metoden udvides med en kollektion af deltagende myndigheder, ParticipatingAuthorityCollection. Myndigheder i denne collection kan hente projektet, se projektets deltagende borgere, håndtere persongruppemarkeringer af egne borgere på projektet, og får WSRM om egne borgere som deltager i projektet. Der sendes ind til videre WSRM GetPersonGroupProjectVersion5 og GetPersonGroupProjectVersion6.

GetPersonGroupProjectMarking udgår og erstattes af GetPersonGroupMarking som er målrettet imod at hente en marking ud (i stedet for markeringer på et projekt).

Der tilføjes to nye metoder: AddParticipatingAuthorities og RemoveParticipatingAuthority som giver STAR mulighed for at tilføje og fjerne myndigheder som deltager i projekter med flere myndigheder. Ved fjernelse af en myndighed fra et projekt, sættes der slutdato på de markeringer (projekttilknytninger af borgere) som den pågældende myndighed er ansvarlig for.

Den fulde snitflade ligger på undersiden 953.1 PersonGroupProjectService (Version 7)

CreatePersonGroupProject

Metode til at oprette et persongruppeprojekt. 

Valideringen om at startdato ikke kan være i fortiden udgår.

Adgang:

• Jobcentre, kommuner og anden aktør til projekter med PersonGroupProjectTypeIdentifier id 3. 
• A-kasser til projekter med id 4 og
• STAR til 1 og 5 (da STAR ikke meningsfuldt kan oprette et type 3 eller 4 projekt fordi det så ikke får tilknyttet en myndighed).

Den CreatedItemIdentifier som returneres er den PersonGroupProjectIdentifier som vil kunne anvendes til opdatering og hentning af persongruppeprojektet

UpdatePersonGroupProject

Metode til at opdatere et persongruppeprojekt.

Adgang:

• Jobcentre, kommuner, anden aktør, a-kasser og STAR. 
• Det er kun muligt at ændre på startdatoen frem i tiden.

En slutdato betyder, at det ikke længere er muligt at tilknytte personer til projektet. Der sættes samtidig slutdato på projektets aktive persongruppemarkeringer!

DeletePersonGroupProject

Metode til at slette et persongruppeprojekt. 

Adgang:

• Jobcentre, kommuner, anden aktør, a-kasser og STAR.
• Det er kun muligt at slette persongruppeprojekter med en fremtidig startdato, og det er kun muligt at slette egenoprettede projekter.
• STAR kan dog slette alle projekter.
• Eventuelle tilknytninger til projektet lukkes ved sletning idet der sættes slutdato på dem.

GetPersonGroupProjects

Metode til at hente persongruppeprojekter tilknyttet et givet jobcenter eller en given a-kasse. Omdøbes så det tydeligt fremgår, at response kan indeholde mange projekter. Hentningen kan være generel hvis man er STAR, eller myndighedsspecifik for a-kasser og jobcentre.

JobcenterIdentifier udgår da vi tager kaldende myndighed fra metadata i stedet for.

Output opdateres til at kunne indikere de tilknyttede myndigheder, og til med en boolean at kunne indikere at det jf. projekttypen er alle jobcentre der er tilknyttede (når der er tale om et type "1 - Star - jobcentre" projekt)Star - jobcentre" projekt).

GetPersonGroupProject

Ny metode til at hente et specifikt persongruppeprojekt baseret på et id. Hvis kaldende myndighed ikke deltager i projektet (eller er STAR) får man fejlen 9404 - The authority is not part of the project.

GetPersonGroupMarkingVersion4

Version4 udfases da GetPersonGroupMarkingVersion5 er en bedre udgave af den. Forskellen på de to er at version 5 indeholder feltet PersonGroupProjectType (projekttype).

GetPersonGroupProjectVersion6 

WSRM til besked om ændringer på et persongruppeprojekt. Omlagt til ny WSRM model, og tilføjet samling af de deltagende myndigheder (som har specialfeltet ParticipationIndicatedByProjectType hvis der er tale om et statsligt projekt hvor alle jobcentre deltager).

Løftes til ny version og får PersonGroupMarkingInfo fra PersonStatusService.

Collectionen PersonGroupMarkingService filtreres ift. a-kasser så der kun leveres data på egne borgere, og for projekter som man er del af.

Input

Output

Acc.kr. 953.1.5 - STAR ønsker en liste på aktive statslige persongruppeprojekter, hvor der ikke til tilknyttet persongruppemarkeringer de seneste 6 måneder med henblik på at foretage oprydning i reelt inaktive projekter

STAR ønsker liste udtrukket fra produktion mhp. manuel lukning (i STAR) af persongruppeprojekter, hvor der ikke er foretaget tilknytning af persongruppemarkeringer det seneste 6 måneder.

Script gemmes, så det kan genkøres efter behov.

Når STAR efterfølgende lukker et persongruppeprojekt som led i oprydningen sendes WSRM'er herom til jobcentrene:

• GetPersonGroupProjectVersion5 (eventuelt GetPersonGroupProjectVersion6 hvis denne ibrugtages) med Updated-markering, hvor der er sat slutdato på projektet.

Acc.kr. 953.1.6 - DFDG overgår internt til person-id på persongruppemarkeringer

Arkitekturforbedringen giver ikke anledning til yderligere beskrivelse

Acc.kr. 953.1.7 - I LSS vises GUID på persongruppeprojekter og de nye strukturer kan redigeres fra LSS

GUID fremgår også af persongruppemarkeringerne. Der indføres filtrering på projekterne.

Persongruppeprojekt-markeringer oprettes igennem BI batchoprettelse af STAR

Persongruppemarkeringer oprettes:

1. Som udgangspunkt med eget jobcenter som ejer af markeringen hvis dette er projektdeltager (kun relevant for type 1, 3 og 5 projekter)
2. Ellers med egen a-kasse som ejer af markeringen hvis denne er projektdeltager (kun relevant for typ 4 og 5 projekter)
3. I øvrige tilfælde med STAR som ejer af markeringen

Der sendes WSRM til eget jobcenter og egen a-kasse i det omfang de er deltagere i det projekt der oprettes markeringer på.

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

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: Ja. konvertering internt fra cpr.nr til person-id på persongruppemarkeringer
• 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
• Nye snitflader
• Nye komponenter
• Nye miljøer
• Nye teknologier
• Nye aftagertyper
• Eller afvigelser fra principperne
• Eventuelle behov for reduktion af teknisk gæld skal afdækkes

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.