Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
Indholdsfortegnelse
Afgrænsning af epic
| Afgrænsning | ||
|---|---|---|
Som STAR, jobcenter og a-kasse ønsker jeg en modernisering af persongruppeprojekter for at persongruppeprojekter og persongruppemarkeringer bedre understøtter de forretningsmæssige behov | ||
| Acceptkriterier | ||
| Nr. | Beskrivelse | Relevant for |
| 953.1.1 | STAR ønsker, at regionale persongruppeprojekter ikke længere kan oprettes, opdateres, hentes eller slettes. | DFDG |
| 953.1.2 | STAR og jobcentrene ønsker, at der kan oprettes fælles persongruppeprojekter, der alene kan anvendes i udvalgte jobcentre og udvalgte a-kasser | DFDG |
| 953.1.3 | STAR og a-kasser ønsker, at a-kasserne kan anvende persongruppeprojekter | DFDG |
| 953.1.4 | STAR kan angive om statslige persongruppeprojekter må anvendes af jobcentre og/eller a-kasser samt hvilke jobcentre og a-kasser, der må anvende projektet | DFDG |
| 953.1.5 | STAR ønsker en liste på aktive statslige persongruppeprojekter, hvor der ikke er tilknyttet persongruppemarkeringer de seneste 6 måneder med henblik på at foretage oprydning i reelt inaktive projekter | DFDG |
| 953.1.6 | DFDG overgår internt til person-id på persongruppemarkeringer | DFDG |
| 935.1.7 | I LSS kan de moderniserede persongruppeprojekter registreres og opdateres og der vises GUID'en (ved mouse-over på Nøglen) på persongruppeprojekter som andre GUID-visninger. | DFDG |
| Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||||
|---|---|---|---|---|---|---|---|
| 953.1.1 | 953.1.2 | 953.1.3 | 953.1.4 | 953.1.5 | 953.1.6 | ||
| Eventuelle referencer til regionale persongruppeprojekter kan fjernes fra KSS | X | ||||||
| KSS'er og jobcentre og a-kasser kan anvende persongruppeprojekter, der er afgrænset til udvalgte jobcentre og a-kasser | X | ||||||
| A-kasser kan anvende persongruppeprojekter, herunder både statslige og a-kasse-projekter | X | ||||||
| A-kasser kan anvende persongruppeprojekter, der er afgrænset til udvalgte a-kasser | X | ||||||
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.
| Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
| CodeListService(version 5).PersonGroupProjectTypeIdentifier | Ændret | Id 2 (regionale projekter) udgår. Nye id'er 4 og 5. Id 1 opdateret navn. | A-kasse(f) KSS(f) | BI JobKon | D+S |
| PersonGroupProjectService(Version 7).AddProjectParticipatingAuthorities | Ny | Der tilføjes en metode til tilføjelse af myndigheder. Metoden er kun tilgængelig for STAR | D+S | ||
| PersonGroupProjectService(Version 7).CreatePersonGroupMarking | Ny | Metoden til at tilknytte borgere til persongruppeprojekt flytter ind i PersonGroupProjectService | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).CreatePersonGroupProject | Ændret | Metoden til at oprette et persongruppeprojekt opdateres til (også) at kunne benyttes af a-kasser | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).DeletePersonGroupMarking | Ny | Metoden til at fjerne borgertilknytning til persongruppeprojekt flytter ind i PersonGroupProjectService | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).DeletePersonGroupProject | Ændret | Metoden til at slette et persongruppeprojekt opdateres til at kunne benyttes af a-kasser | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).GetPersonGroupProjectMarkingsByCaseworker | Ændret | Der tilføjes en ResponsibleAuthority, myndighed som kan redigere. Periodeudtræk forbedret. A-kasser får adgang | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).GetPersonGroupProjectMarkings | Ændret | Der tilføjes en ResponsibleAuthority, myndighed som kan redigere. Periodeudtræk forbedret. A-kasser får adgang | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).GetPersonGroupProjects | Ændret | Omdøbt da output kan være multipelt. Output opdateres til at kunne indikere de tilknyttede myndigheder. A-kasser får adgang | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).RemoveProjectParticipatingAuthority | Ny | Der tilføjes en metode til fjernelse af myndighed fra tværgående projekt. Metoden er kun tilgængelig for STAR | D+S | ||
| PersonGroupProjectService(Version 7).UpdatePersonGroupMarking | Ny | Metoden til at opdatere borgertilknytning til persongruppeprojekt flytter ind i PersonGroupProjectService | A-kasse(f) KSS(f) | D+S | |
| PersonGroupProjectService(Version 7).UpdatePersonGroupProject | Ændret | Metoden til at opdatere et persongruppeprojekt opdateres til at kunne benyttes af a-kasser | A-kasse(f) KSS(f) | D+S | |
| PersonVisitationStatusService (Version 1).Alle | Udgået | Servicen udfases, brug version 2 i stedet | A-kasse KSS Plannersystemer | D+S | |
| PersonVisitationStatusService (Version 3).GetPersonVisitationStatus | Ændret | Kollektion tilføjes: PersonGroupMarkingInfo med persongruppetilknytninger | A-kasse KSS Plannersystemer | D+S | |
| WSRMMessageService (Version 11).GetPersonGroupProjectVersion6 | Ny | Ny version af beskeden, udvidet med projektdeltagende myndigheder | A-kasse(f) KSS(f) | D+S | |
| WSRMMessageService(Version 10).GetPersonGroupMarkingVersion4 | Udgået | WSRM'en lukkes, brug version 5 i stedet. | KSS | D+S |
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.
| Id | Navn | Beskrivelse | Startdato | Slutdato |
|---|---|---|---|---|
| 1 | Stat - jobcenter | Persongruppen er oprettet af staten og kan ses af alle jobcentre | 26-04-2010 | 01-07-2100 |
| 2 | Region | Persongruppen er oprettet af en region og kan ses af alle jobcentre tilknyttet den enkelte region | 26-04-2010 | 13-03-2020 |
| 3 | Jobcenter | Persongruppen er oprettet af det enkelte jobcenter og kan kun ses af jobcentret og STAR | 01-10-2009 | 01-07-2100 |
| 4 | A-kasse | Persongruppen er oprettet af den enkelte a-kasse og kan kun ses af a-kassen og STAR | 01-06-2019 | 01-07-2100 |
| 5 | Stat, a-kasse og jobcenter | Persongruppen er oprettet af staten og kan ses af tilknyttede a-kasser og jobcentre | 01-06-2019 | 01-07-2100 |
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 de statslige persongruppeprojekter. Ved behov for statslige persongruppeprojekter 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ændring | WSRM ved persontilknytning | 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 (/ Ingen 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 | Deltagende jobcenter | (Oprettende) Jobcenter |
| A-kasse (type 4) | Deltagende a-kasse | Egne borgere | Deltagende a-kasse kan se egne borgere | Deltagende a-kasse | (Oprettende) A-kasse |
| Stat, a-kasse og jobcenter (type 5) | Deltagende myndigheder | Egne borgere | 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.
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. Ved tværgående projekter (type 5 - "Stat, a-kasse og jobcenter") får borgerens jobcenter 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. Ved tværgående projekter får borgerens a-kasse besked om dette med WSRM.
Hvis en projektdeltager fjernes fra et projekt, sættes der slutdato på de borgertilknytninger som den pågældende projektdeltager måtte have oprettet. Der sendes WSRM til denne myndighed.
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 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 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. Der laves validering, så man ikke kan fjerne en myndighed som er ansvarlig for projekttilknyttede borgere.
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).
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).
CreatePersonGroupMarking
Denne servicemetode benyttes til at oprette en tilknytning af en borger til et projekt, altså en persongruppemarkering.
Adgang:
- Jobcentre, kommuner, anden aktør, a-kasser og STAR.
Hvis projektet har en slutdato, skal markeringen også have en slutdato som er mindre end, eller lig projektets slutdato; fejlkode i begge tilfælde 4671 - The enddate must not be later than the project enddate. Hvis projektet ikke har slutdato, er det ikke krævet at markering har en slutdato (der ligger dog en skjult max dato i koden).
En borger kan være tilknyttet et givet projekt flere gange, men ikke samtidig.
- ¤Afklaring udestår: PersonRegistrationService havde følgende i dokumentationen: Anden aktør har kun adgang til at foretage opdateringer (UpdatePersonGroupMarking). Har KSS systemerne et behov for at dette bibeholdes?.
UpdatePersonGroupMarking
Denne servicemetode benyttes til at opdatere en persongruppemarkering.
Adgang:
- Jobcentre, kommuner, anden aktør, a-kasser og STAR.
- Det er kun STAR som har rettigheder til at opdatere en borgertilknytning som de ikke selv har oprettet.
Startdato kan ikke ændres, hvis det registrerede tidspunkt (startdato) er overskredet. Hvis projektet har en slutdato, skal markeringen også have en slutdato, og den må ikke være efter projektets slutdato. Fejlkode er i begge tilfælde 4671 - The enddate must not be later than the project enddate
DeletePersonGroupMarking
Denne servicemetode kan benyttes til at slette en persongruppemarkering hvis den har startdato senere end dags dato.
Adgang:
- Jobcentre, kommuner, anden aktør, a-kasser og STAR.
- Det er kun STAR som har rettigheder til at opdatere en borgertilknytning som myndigheden ikke selv har oprettet.
GetPersonGroupProjectMarkings
Metoden bruges til at hente aktive borgertilknytninger for et specifikt projekt som den kaldende myndighed har lov til at se. Hvis der angives et tidsrum med start- og slutdato returneres udelukkende tilknytninger som er aktive indenfor denne periode (bemærk at dette er en udvidelse ift. den logik der har fungeret på version 6, hvor der udelukkende returneredes tilknytninger hvis start- og slutdato var indeholdt i den angivne tidsperiode)
Der tilføjes en ResponsibleAuthority som er den myndighed som har lov til at opdatere og lukke persongruppetilknytningen.
GetPersonGroupProjectMarkingsByCaseWorker
Metoden returnerer alle de borgere som en sagsbehandler har oprettet en persongruppemarkering på. Hvis der ikke angives et sagsbehandler-id, returneres alle persontilknytninger i perioden med angivelse af tilknyttende sagsbehandler og tilknytningsdato. Hvis der angives et tidsrum med start- og slutdato returneres udelukkende tilknytninger som er aktive indenfor denne periode (bemærk at dette er en udvidelse ift. den logik der har fungeret på version 6, hvor der udelukkende returneredes tilknytninger hvis start- og slutdato var indeholdt i den angivne tidsperiode)
Metoden fremsøger kun aktive persongruppe tilknytninger/markeringer, tilknyttet det givne persongruppeprojekt. Startdato og slutdato kan begrænse resultatet yderligere og er ikke nødvendige parametre.
Der tilføjes en ResponsibleAuthority som er den myndighed som har lov til at opdatere og lukke persongruppetilknytningen.
AddProjectParticipatingAuthorities
Metode til at tilføje myndigheder til et persongruppeprojekt med flere deltagende jobcentre og/eller a-kasser.
Adgang:
- Metoden kan kun kaldes af STAR.
Hvis der laves et request med myndigheder, der ikke er lovlige, fås fejlen ¤XX4 - 1 or more authority identifiers are not valid. Hvis ikke projektet er type 5 fås fejlen ¤XX5 - Only project type 5 allows adding authorities
DeleteProjectParticipant
Metode til at fjerne en myndighed fra et tværgående projekt.
Adgang:
- Metoden kan kun kaldes af STAR.
- Hvis en projektdeltager fjernes fra et projekt sættes der slutdato på de borgertilknytninger som den pågældende projektdeltager måtte have oprettet.
WSRMMessageService (Version 11)
De nuværende WSRMer ligger alle på WSRMMessageService version 10, og er relativt tynde
- GetDeletedPersonGroupProjectVersion5 - besked om et slettet persongruppeprojekt. Her ses umiddelbart intet behov for at udvide med information om deltagende myndigheder.
- GetPersonGroupProjectVersion5 - besked når der oprettes eller opdateres et persongruppeprojekt. Mangler information om deltagende myndigheder, hvilket en ny version6 (se nedenfor) råder bod på.
- GetPersonGroupMarkingVersion4 - (gammel) WSRM om tilknytninger af personer, mangler information om projekttypen.
- GetPersonGroupMarkingVersion5 - WSRM om tilknytninger af personer som har information om projekttypen.
- GetDeletedPersonGroupMarkingVersion5 - WSRM om fjernet tilknytning til projekt (ingen informatin om projekttypen).
GetPersonGroupMarkingVersion4
Version4 ønskes udfaset 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).
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
| GetPersonGroupProjectVersion6Response | GetPersonGroupProjectVersion6ResponseType | 1 | ||
| - PersonGroupProjectRegistration | PersonGroupProjectRegistrationType | 0 - * | ||
| - - PersonGroupProjectIdentifier | guid Base: string | Pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12} | 1 | Identifier på persongruppeprojektet |
| - - PersonGroupProject | PersonGroupProjectType | 1 | Persongruppeprojekt | |
| - - - PersonGroupProjectStartDate | dateTime | 1 | Startdato | |
| - - - PersonGroupProjectEndDate | dateTime | 0 - 1 | Slutdato | |
| - - - PersonGroupProjectTypeIdentifier | CodeListItemIdentifierType | MaxInclusive: 10000000 | 1 | Typen af projekt |
| - - - ProjectName | ProjectNameType Base: string | Length: 1-50 | 1 | Navn på projektet |
| - - - - ParticipatingAuthorityCollection | ¤AuthorityStructureType | 1 | En liste med deltagende myndigheder (a-kasser og jobcentre). Ved projekter af typen 1 - Stat - jobcentre, indeholder listen udelukkende et ParticipationIndicatedByProjectType objekt som repræsenterer alle jobcentre. | |
| - - - - - ParticipationIndicatedByProjectType | boolean | 1 | Indikation på at deltagende myndigheder ikke er angivet enkeltvis da alle myndigheder deltager i denne projekttype | |
| - - - - - ParticipatingAuthority | 0 - * | En deltagende myndighed | ||
- - - - - - AuthorityCode | 1 | Myndighedskode | ||
| - - - - - - AuthorityName | 1 | Myndighedsnavn | ||
| - - - - - - OrganisationTypeIdentifier | 1 | Myndighedstype | ||
| - - CorrectionComment | CorrectionCommentType Base: string | Length: 0-1500 | 0 - 1 | Kommentar til berigtigelse af en registrering. |
| - - BaseType | WSRMMetadataBaseType | 1 | ||
| - - - WSRMMetadata | WSRMMetadataType | 0 - 1 | ||
| - - - - MessageIdentifier | guid Base: string | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 | WSRM id |
| - - - - ClientSystemTypeIdentifier | ClientSystemTypeIdentifierType | 0 - 1 | System som har foranlediget WSRM'en med en indberetning | |
| - - - - RegisteringAuthority | ActiveOrganisationHeaderType | 0 - 1 | Registrerende myndighed | |
| - - - - - OrganisationTypeIdentifier | OrganisationTypeIdentifierType Base: int | MinInclusive: 1 MaxInclusive: 100 | 1 | Kodeliste med organisationstype / myndighedstype |
| - - - - - OrganisationCode | OrganisationCodeType Base: string | Length: 1-20 | 1 | Identifikation af organisation / myndighed |
| - - - - RegisteringUser | RequestUserMetadataType | 0 - 1 | Registrerende bruger | |
| - - - - - RequestUserStructure | RequestUserStructureType | 1 | Information om den kaldende bruger. | |
| - - - - - - UserFullName | UserFullNameType Base: string | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
| - - - - - - RequestUserTypeIdentifier | RequestUserTypeIdentifierType | 1 | Brugertype | |
| - - - - - - UserIdentifier | UserIdentifierType Base: string | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
| - - - - - - UserEmail | EmailAddressIdentifierType Base: string | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
| - - - - - RequestOrganisationStructure | RequestOrganisationStructureType | 1 | Den organisation som registrerende bruger tilhører. | |
| - - - - - - OrganisationTypeIdentifier | OrganisationTypeIdentifierType | 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
| - - - - - - OrganisationCode | OrganisationCodeType Base: string | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| - - - - - RegistrationDateTime | dateTime | 1 | Kaldende systems registreringstidspunkt. | |
| - - - - EnqueueDateTime | dateTime | 0 - 1 | Kølægningstidspunkt for beskeden | |
| - - - - SortKey | unsignedLong | 0 - 1 | Sorteringsnøgle |
PersonVisitationStatusService (Version 3)
Løftes til ny version og får PersonGroupMarkingInfo fra PersonStatusService
| Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
| - PersonGroupMarkingInfo | PersonGroupMarkingInfoType | 0 - 1 | Persongruppemarkeringer. Incl. historiske data. | |
| - - PersonGroupMarkingCollection | PersonGroupMarkingTypeCollection | 0 - 1 | Liste af persongruppetilknytninger. | |
| - - - PersonGroupMarkingType | PersonGroupMarkingType | 0 - * | ||
| - - - - PersonGroupMarkingIdentifier | guid Base: string | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 1 | Unik nøgle for tilknytningen af personen til projektet |
| - - - - PersonGroupMarkingStartTime | dateTime | 1 | Startdato og tidspunkt. | |
| - - - - PersonGroupMarkingEndTime | dateTime | 0 - 1 | Slutdato og tidspunkt. | |
| - - - - PersonGroupProjectName | string | Length: 1-100 | 1 | Navn på persongruppeprojektet |
| - - - - PersonGroupProjectIdentifier | guid Base: string | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 1 | Guid tilknytning til et oprettet persongruppeprojekt |
| - - - - CorrectionComment | string | Length: 0-1500 | 0 - 1 | Berigtigelseskommentar sat ifm. rettelse til registrering |
| - - - - ResponsibleAuthority | 0 - * | Den myndighed som har oprettet tilknytningen og kan opdatere den | ||
- - - - - AuthorityCode | 1 | Myndighedskode | ||
| - - - - - AuthorityName | 1 | Myndighedsnavn | ||
| - - - - - OrganisationTypeIdentifier | 1 | Myndighedstype |
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.
Særlige krav til test
| Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
|---|---|---|
| 2019-4-opsætningen virker fortsat | PersonGroupProjectService v6 virker og fungerer som hidtil - bl.a. i JobKon | Jesper |
| 2019-4-opsætningen virker fortsat | WSRM GetPersonGroupProjectVersion5 og GetPersonGroupMarkingVersion5 sendes som hidtil | Jesper |
| Regressionstest efter konvertering | PersonHistoryService.GetPersonHistory skal kunne udtrække PersonGroupMarkings som hidtil | Jesper |
* 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.