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

Indholdsfortegnelse

Afgrænsning af epic

Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne (links i listen virker kun med STAR Jira konto):

Der vil ikke være snitfladeændringer til nogen service.

Der vil være valideringsændringer og dermed såvel nye som udgående fejlkoder på BookingService (Version 2), JobnetBookingService (Version 3) og ExternalBookingService (Version 3) 

Automatisk oversigt (vi arbejder på løsning på at gøre den synlig)

Beskrivelse af epic

Indtil LAB har det i lovgrundlaget for borgers selvbook af samtaler til afholdelse i Jobcenterregi været defineret at det skulle foregå på Jobnet.

Det bliver der lavet om på med LAB, så det bliver muligt at indberette borgers selvbookede aftaler som selvbookede i eksempelvis lokale plannersystemer eller apps.

I vid udstrækning løses muliggøres dette ved at DFDG modtager aftaler (bookings) i BookingService hvor feltet SelfBooked indikerer at aftalen er selvbooket af borger.Bookingsystemet skal sikre at borger ikke får tilbudt jobsamtaler eller opfølgningssamtaler hvis borger allerede har en fremtidig samtale af en af disse to typer. Fejl: 8273 "Citizen already has a booking of type Jobsamtale." og 9220 "Citizen already has a booking of type Opfølgningssamtale".

De bookings som dermed fremkommer forventes at være fuldbårne bookings som kan indgå i det eksisterende samlede flow, og fx kan ombookes fra Jobnet i det omfang der er udstillet tider i det plannersystem som det pågældende jobcenter har valgt.

Borgers accept af booking til møde i jobcenter

Aftaler med påtegning om at borger har selvbooket vil som alle andre blive udstillet til borger på Jobnet. De sættes af DFDG til at have BookingAccepted = true (borger har accepteret bookingen) og BookingAcceptedTime sat til modtagelsestidspunktet for bookingen i DFDG.

Hvis sagsbehandler efterfølgende ændrer bookingen vil borgers accept blive nulstillet, og borger kan så efterfølgende acceptere bookingen igen på Jobnet.

.

Det tiltænkte flow fra KSS/A-K/plannersystem er:

Image RemovedImage Added

Ansvar for udstiller af brugergrænsesnitflade til selvbook ift. overholdelse af frist til selvbook med henblik på samtaleforløbets kadence af samtaler

I de tilfælde hvor borger har en frist til selvbooking vil det i et vist omfang påhvile det system som stiller brugersnitflade til rådighed for borgeren at sikre at borger ikke får mulighed for at booke til afholdelse senere end 7 dage efter den udstedte frist.

For at hjælpe med dette validerer DFDG på aftaler der kommer ind i BookingServices.CreateBooking med SelfBooking sat true. Disse må ikke ligge til afholdelse mere end 7 dage efter frist. Manglende overholdelse giver fejlen: 8288 "Booking is later than deadline of existing InterviewDeadline with same InterviewType.". Denne validering udføres kun for CreateBooking. For UpdateBooking kan flaget være "gammelt", fra oprettelsen - altså at en sagsbehandler ombooker en aftale som borger oprindeligt har booket. Vi vil ikke validere på dette, da vi så skal kræve at alle systemer som indberetter bookings nulstiller SelfBooked ved hver opdatering, det er ikke ønsket.

Bookingsystemet skal derudover sikre at borger ikke får tilbudt jobsamtaler eller opfølgningssamtaler hvis borger allerede har en fremtidig samtale af en af disse to typer. Fejl: 8273 "Citizen already has a booking of type Jobsamtale." og 9220 "Citizen already has a booking of type Opfølgningssamtale".

Alle disse valideringer og tilhørende fejlkoder er kun relevante når det er borger der ageres på vegne af, de vil ikke berøre sagsbehandleres indeberetninger af bookings.

Straksbooking

Straksbooking er begrebet for at en borger har haft en frist til selvbooking, men ikke har booket indenfor fristen, som dermed nu er overskredet.

Det forventes at når en borger er straksbookingramt (dvs. har en aktiv frist for selvbooking som er overskredet, og ikke har et fremtidigt møde af den samtaletype der er frist til): Henvises borger til at booke på Jobnet fordi han har overskredet sin frist og der dermed er strengere krav til booking. 

Fejl: ¤xxxx 9390 "Citizen is required to make an immediate booking because of an exceeded interview deadline, and can only selfbook via Jobnet". Denne validering er kun relevant i forhold til bookinger i jobcenterregi, selvbookede bookinger fra a-kasse vil ikke være omfattede af valideringen.

905.3.3 Metadata og indikation af bookingens ophav

Behovet for at genkende hvilket system der har initieret en booking er størst i WSRM sammenhæng, med henblik på at identificere hvilke WSRM'er der er bekræftelse af bookings oprettede i eget system, og hvilke der de facto genererer en opgave.

I BookingWsrmMessageService.GetBookings /wiki/spaces/GI/pages/75151995 medtages RequestUserMetadata fra oprettelsen af en booking.

I PersonStatusService /wiki/spaces/GI/pages/1320419455 har man BookingOriginator med UserIdentifier og OrganisationType som ved selvbooking fra Jobnet er henholdsvis Cv nummer og Star (id 5).

Serviceaftager skal angive RequestUserMetadata.RequestUserTypeIdentifier = 1 (Citizen) og RequestUserMetadata.UserIdentifier skal være borgerens CPR ved SelfBooked = true for CreateBooking. Fejl:9389 - RequestUserMetaData needs to reflect that it is a selfbooking .

Flow og sammenhæng imellem registreringsdata

Kardinaliteter m.m. på header kan ses påDFDGs STARs sikkerhedsmodel

Note 1: InterviewUnemploymentFundParticipation og InterviewWithMoreAuthorities er specifikke for samtaletypen "Fælles jobsamtale med dagpengemodtager" og kan ikke selvbookes. 

¤Afklaring: Serviceaftager angiver RequestUserMetadata.RequestUserTypeIdentifier = 1 (Citizen) og RequestUserMetadata.UserIdentifier skal være borgerens CPR ved SelfBooked = true for CreateBooking. Fejl: ¤XX1 - "When SelfBooked is true, UserIdentifier has to be citizen's CPR and UserType has to be 1 - Citizen".

For en booking med metadata:

<headers>
  <ActiveOrganisationHeaderType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <OrganisationTypeIdentifier xmlns="http://rep.oio.dk/ams.dk/xml/schemas/2005/09/01/">2</OrganisationTypeIdentifier>
    <OrganisationCode xmlns="http://rep.oio.dk/ams.dk/xml/schemas/2005/09/01/">81</OrganisationCode>
  </ActiveOrganisationHeaderType>
  <RequestUserMetadataType xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <RequestUserStructure xmlns="http://service.bm.dk/pjaktass/2015/01/21/RequestUserStructure/">
      <UserFullName>Kim Jørgensen</UserFullName>
      <RequestUserTypeIdentifier xmlns="http://service.bm.dk/pjaktass/2015/01/21/RequestUserTypeIdentifierCodeList/">
        <CodeListItemIdentifier xmlns="http://service.bm.dk/pjaktass/2013/06/07/CodeListBase/">1</CodeListItemIdentifier>
      </RequestUserTypeIdentifier>
      <UserIdentifier>1111112222</UserIdentifier>
    </RequestUserStructure>
    <RequestOrganisationStructure xmlns="http://service.bm.dk/pjaktass/2015/01/21/RequestOrganisationStructure/">
      <OrganisationTypeIdentifier>
        <CodeListItemIdentifier xmlns="http://service.bm.dk/pjaktass/2013/06/07/CodeListBase/">2</CodeListItemIdentifier>
      </OrganisationTypeIdentifier>
      <OrganisationCode>81</OrganisationCode>
    </RequestOrganisationStructure>
    <RegistrationDateTime xmlns="http://service.bm.dk/RequestUserMetadata/2015/01/21/">2019-04-30T15:06:58.9218786+02:00</RegistrationDateTime>
  </RequestUserMetadataType>
</headers>

- vil vi i databasen kunne se række 2 nedenfor:

Øvrig funktionalitet der ændres i tilknytning til bookninger

Huskeservicebeskeder sendes ikke når det er borger selv der har booket fra et andet system end Jobnet.

Der rettes En booking med metadata og sammenhæng til tabelindhold kan ses på undersiden 905.3 Request metadata eksempel

905.3.4 Ombooknings- og aflysningsvalideringer bortfalder på UpdateBooking og RescheduleBooking

Det giver jævnligt anledning til problemer at ombookningsdeadline skal ligge i fremtiden når man fx opdaterer sagsbehandleren på en booking. Der rettes derfor på valideringen så der ikke længere valideres på at ombooknings- og afbookningsdeadline (ReBookingDeadline respektive CancellationDeadline) skal være i fremtiden på BookingService.UpdateBooking og ExternalBookingService.RescheduleBooking. Valideringen forbliver aktiv i CreateBooking situationen.

Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:

• DFDG
  • Services
  • WSRMer
  • Kodelister
  • 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

Følgende fejlkoder bortfalder ift. BookingService.UpdateBooking og JobnetBookingService.RescheduleBooking (sidstnævnte er relevant for plannersystemer, da det er i kommunikationen med ExternalBookingService DFDG ofte finder grund til at håndhæve kravet)

Jobnets udvikling

Jobnet gennemgår programkode for steder hvor der reageres på de slettede fejlkoder. Denne programkode vil jo ikke længere rammes og skal derfor slettes fra Jobnet. 

Øvrig funktionalitet der ændres i tilknytning til bookninger

Kvitteringsmails (mails til borger som informerer om, eller bekræfter ændringer til møder, som nævnt på BookingService) sendes ikke når det er borger selv der har booket fra et andet system end Jobnet. (Huskeservice sendes derimod som hidtil.)

905.3.5 Integrationstest af Jobnet 

Jobnet udfører en integrationstest, så det verificeres, at Jobnet responderer som ønsket på de data der oprettes. Det er nye interessenter der tager eksisterende snitflader i brug, så forventeligt virker alt ud af boksen. For god ordens skyld verificeres dette dog.

DFDG kan være Jobnet behjælpelig, da DFDG har testcases, som indsætter forskellige data. Disse data slettes dog straks efter succesfuld kørsel og er derfor mere en test af snitfladen selv. Såfremt data for en periode får lov at blive, kan Jobnets testere verificere, at Jobnet virker som ønsket. Jobnets test aftaler nærmere med DFDG.

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