Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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



Page Properties


STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader
Niels Freiberg (STAR)Jesper Brunholm

2019-3 Udvikling

2019-4 Release

0.1 Hovedspor_(LAB)Plannersystemer(t.o.), KSS, A-kasse





Jira Legacy
serverSystem JIRA
columnskey,po,fa,ux,sme,eksterne snitflader,interne snitflader,status,labels
maximumIssues4
jqlQuerykey in (DS-290,JOB-104)
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a

Jira Legacy
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a
keyDS-290



Indholdsfortegnelse

Table of Contents
outlinetrue




Afgrænsning af epic

Afgrænsning

Som borger vil jeg have flere muligheder for selvbooking i kraft af at det er muligt i flere systemer

Acceptkriterier

Nr.BeskrivelseRelevant for
905.3.1Det er muligt at selvbooke møder til afholdelse i jobcenter på andre systemer end JobnetDFDG
905.3.2Selvbookede møder i a-kassen registreres som selvbookede i DFDGDFDG
905.3.3Selvbookede aftaler registreres med borgeren som agerende brugerDFDG


Kriterier for tilsagn til serviceaftager i forhold til STARs snitfladerBerørte acceptkriterierBemærkninger

Acceptkriterie 905.3.1Acceptkriterie 905.3.2Acceptkriterie <nr905.3.>3Acceptkriterie <nr.>
KSS- og plannersystemer: WSRM'er om bookings som er selvbookede, men ikke har STAR som opretter, vil kunne modtages uden at skabe problemerXX


A-kasser: Møder som medlemmer har booket i a-kassens selvbooking-løsning fremstår som selvbookede ved indberettelse af aftalen til DFDG.



X


KSS- og plannersystemer: Det er (fortsat) op til jobcentrene og deres tilknyttede systemer at koordinere sagsbehandlere med tilhørende id, som bruges i bookingsX



KSS-, A-kasse- plannersystemer: Når der er tale om selvbooking registreres der borgeridentifikation i RegistrationMetadata

X


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 nye fejlkoder på BookingService (Version 2).


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

Jira Legacy
serverSystem JIRA
columnssummary,varslingstype,varslingsnote,eksterne snitflader,interne snitflader,project
maximumIssues100
jqlQueryissuetype = Varsling AND linkedIssue in (DS-290) ORDER BY summary, Varslingstype, "Eksterne snitflader", "Interne Snitflader"
serverId479d1618-4a6f-3f88-8ee1-04c6b02c448a


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

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.

En eventuel udvidelse til at borger kan acceptere bookings på øvrige systemer, eller forretningsmæssig ændring, til at borger i forlængelse af ændringer på ret og pligt ikke længere skal acceptere booking overhovedet, udestår, og vil finde afklaring i en senere epic. 

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

Image Added

Ansvar for udstiller af brugergrænsesnitflade 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.

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 "Citizen is required to make an immediate booking because of an exceeded interview deadline, and can only selfbook via Jobnet".

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 medtages RequestUserMetadata fra oprettelsen af en booking.

I PersonStatusService har man BookingOriginator med OrganisationCode og OrganisationType som ved selvbooking fra Jobnet er henholdsvis Cv nummer og Star (id 5).

Flow og sammenhæng imellem registreringsdata

RegistreringDFDG DBPersonStatusService

WSRM GetBookings

ActiveOrganisationHeader

- OrganisationTypeIdentifier

2 a-kasse / 8 jobcenter








- OrganisationCode(a-k nummer / jc-nummer )






































































I request header angives 


¤Løsningsmodel til afklaring: Ved oprettelse af en booking (DFDGs sikkerhedsmodel) skal borgers CPR nummer fremstå sammen med indikation af det Jobcenter han er tilknyttet.

¤Skitsér hvad vi har af data om hvilket system der er selvbooket på.


Hvis vi forlanger (validerer på) at KSS og A-K angiver RequestUserMetadata.RequestUserTypeIdentifier = 1 (Client) og RequestUserMetadata.UserIdentifier skal være borgerens CPR ved SelfBooked = true for CreateBooking, så vil vi kunne identificere en booking som værende selvbooket i et andet system end Jobnet. 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 


CPRSupervisorGivenNameSupervisorSurnameSupervisorIdentifierIsSelfBookedAuthorityTypeIdAuthorityCodeActiveAuthorityTypeIdActiveAuthorityCodeRequestUserIDRequestUserTypeIDRequestUserFullnameRequestUserEmail
101540022Visma - Kim JørgensenVisma - Kim JørgensenCVR:55568510-RID:91000000001730281281CVR:55568510-RID:91000000001732Visma - Kim JørgensenNULL
101540022Visma - Kim JørgensenVisma - Kim JørgensenCVR:55568510-RID:9100000000173028128111111122221Kim JørgensenNULL

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

Borgers accept af booking til møde i jobcenter

Aftaler med denne påtegning vil som alle andre blive udstillet til borger på Jobnet. De 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 ¤Afklares: eller i eventuelle andre systemer som udstiller funktionalitet til dette. Booking accepteres med indmelding på (Ny metode på BookingService, da den metode vi har til Jobnet er CV-identifier-baseret!)

Input

Element
Type
Detaljer
Forekomst
Beskrivelse
AcceptBookingRequestJobnetAcceptBookingRequestType1-    PersonCivilRegistrationIdentifierPersonCivilRegistrationIdentifierType
Base: stringPattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|00000000001CivilRegistrationNumber (PNR)
Description:
Unique identification of a person
The Civil Registration System contains:
- Data on persons, who after 1968 April 2nd Danish registry of citizens.
As for Greenland the corresponding date is 1972 may 1st.
- Danish citizens living outside Denmark (who must pay duty and ATP)
has also been given a civil registration number.
- Civil registration numbers are also assigned for other administrative purposes.
Value space:
The civil registration number consists of two parts.
The first part is the valid birthday in the form DDMMYY.
The following part is a serial number of four digits.
The civil registration number may also hold the value 0000000000.
This value is used where the civil registration number is required but unknown.
Lifecycle:
The civil registration number is generated and assigned at birth, entry and change of civil registration number of for administrative reasons.
The civil registration number may be assigned via hospitals.
The civil registration number is not to be deleted.
Remarks:
1994 June 11th the civil registration number was changed according to this description.-    BookingIdentifierguid
Base: stringPattern: [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}1Booking ID.

Output

Element
Type
Detaljer
Forekomst
Beskrivelse
AcceptBookingResponseJobnetAcceptBookingResponseType1-    ServiceReceiptServiceReceiptType1Servicekvittering-    -    MessageIdentifierguid
Base: stringPattern: [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}1Unik identifikation af transaktion eller registrering-    -    EventDatedateTime1Tidspunkt for transaktionen eller registreing

Det tiltænkte flow fra KSS/AK er:

Image Removed

Ansvar for udstiller af brugergrænsesnitflade 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.

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 "Citizen is required to make an immediate booking because of an exceeded interview deadline, and can only selfbook via Jobnet".

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 medtages RequestUserMetadata fra oprettelsen af en booking.

I PersonStatusService har man BookingOriginator med OrganisationCode og OrganisationType som ved selvbooking fra Jobnet er henholdsvis Cv nummer og Star (id 5).

¤Løsningsmodel til afklaring: Ved oprettelse af en booking (DFDGs sikkerhedsmodel) skal borgers CPR nummer fremstå sammen med indikation af det Jobcenter han er tilknyttet.

¤Skitsér hvad vi har af data om hvilket system der er selvbooket på.



Ø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 på valideringen så der ikke længere valideres på at ombooknings- og afbookningsdeadline 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

Særlige krav til test

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






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