639.3 639.3 Sikring af synkronitet for bookingsystemer
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
(Skabelon af dato 17/12-2015)
Indholdsfortegnelse
1 Ændringslog
2 Afgrænsning af epic
3 Oversigt over berørte web services
4 Beskrivelse af epic
4.1 639.3.1 DFDG understøtter at kalde ExternalBookingService.GetBookingDetails som del af flowet for oprettelse af et selvbooket møde
4.2 639.3.2 DFDG understøtter at ikke alle planner systemer understøtter ExternalBookingService.GetBookingDetails
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
Ændringslog
Dato |
Version |
Forfatter |
Berørte afsnit |
24.11.2016 |
0.01 |
Jesper Brunholm |
Nyoprettet |
25.11.2016 |
0.01 |
Kim Jørgensen |
Skrevet på afsnit 4.1, tilføjet afsnit 4.2 og acceptkriterie 639.3.2 |
28.11.2016 |
0.01 |
Kim Jørgensen |
Diagrammer lagt til afsnit 4.1 og 4.2 |
21.12.2016 |
1.0 |
Jesper Brunholm |
Løftet til 1.0 |
15.02.2017 |
1.0 |
Jesper Brunholm |
Tydeliggjort at det er deprecated funktionalitet at arbejde uden GetBookingDetails |
Afgrænsning af epic
Afgrænsning |
|
|
|
Som STAR vil jeg have serviceunderstøttelse af at sikre imod synkroniseringsfejl for bookninger ved flere bookingsystemer |
|
|
|
Acceptkriterier |
|
|
|
Nr. |
Beskrivelse |
Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie |
|
639.23.1 |
DFDG understøtter at kalde ExternalBookingService.GetBookingDetails som del af flowet for oprettelse af et selvbooket møde |
DFDG |
|
639.3.2 |
DFDG understøtter at ikke alle planner systemer understøtter ExternalBookingService.GetBookingDetails |
DFDG |
|
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader |
Berørte acceptkriterier |
|
|
|
|
|
|
Bemærkninger |
|
|
|
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
Acceptkriterie <nr.> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Oversigt over berørte web services
Snitflade |
Serviceaftager der er berørt |
|
|
|
|
|
|
|
Bemærkninger |
|
|
|
DFDG |
Jobnet |
Plannersystemer |
KSS |
A-kasse |
Ydelsessystem |
JobKon |
Andet |
|
|
|
ExternalBookingService (Version 2) |
X |
|
|
|
|
|
|
|
Ingen ændringer til snitfladen. NNIT-Planner behøver ikke at implementere og testunderstøtte i samme release |
|
Beskrivelse af epic
Denne epic til denne ISB: 639 639 Snitflade til kommunale bookingsystemer
639.23.1 DFDG understøtter at kalde ExternalBookingService.GetBookingDetails som del af flowet for oprettelse af et selvbooket møde
For at sikre synkronitet mellem Planner og DFDG, er det vigtigt at vi validerer en (om)booking i begge systemer inden vi opretter dem. For begge metoder skal flowet i JobnetBookingService være:
BookingInfo = CreateBookingInfo()
Booking = ExternalBookingService.GetBookingDetails(BookingInfo)
Validate(Booking)
CreateBooking(Booking)
ExternalBookingService.CreateBooking(BookingInfo)
Det er vigtigt at alle kald af ExternalBookingService er indlejret i try/catch og der er ordentlig logging, se FB94334.
Det er vigtigt at plannersystemerne laver en reservation af timeslottet for borgeren fra kaldet af GetBookingDetails og indtil CreateBooking eller RescheduleBooking bliver kaldt. Denne reservation skal have en timeout på ganske kort tid, fx 10 sek.
De to flows, CreateBooking og RescheduleBooking, er vise herunder.
¤¤detaljer udfyldes
Figur 1. Nyt flow for CreateBooking med brug af GetBookingDetails.
Figur 2. Nyt flow for RescheduleBooking med brug af GetBookingDetails.
Overveje hvordan vi rimeligt overholder testbehov
639.3.2 DFDG understøtter at ikke alle planner systemer understøtter ExternalBookingService.GetBookingDetails
Dette er deprecated funktionalitet som er under udfasning, men som der er givet arkitekturforums-dispensation til at bevare frem til 2017-2 hvor alle bookingsystemer forventes at være overgået til GetBookingDetails brug.
For at understøtte den situation at et planner system understøtter GetBookingDetails, imens et andet endnu ikke gør det, skal vi kunne skifte mellem den eksisterende logik og den nye logik beskrevet i afsnit 4.1. I dag har vi et skiftespor i ExternalBookingServiceClient, hvor vi ud fra jobcenteret slå endpoint konfigurationen op i tabellen tblExternalBookingSystemEndpointName, se nedenfor.
Figur 3. tblExternalBookingSystemEndpointName som pt kun indeholder en enkelt række.
Tabellen skal udvides med en ekstra kolonne "SupportGetBookingDetails" som angiver hvilket flow der skal bruges til (om)booking.
Flowet for support af flere Planner systemer som ikke alle understøtter GetBookingdetails er vise herunder
Figur 4. Flow for flere plannersystemer der ikke all understøtter GetBookingDetails. Her er kun flowet for CerateBooking vist.
Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:
- DFDG
- Services
- WSRMer
- Kodelister
- Jobnet
- VITAS
- JobKon
- JobAG
- BI integrationsplatform
- Kommunalt sagsbehandlingssystem
- A-kasse sagsbehandlingssystem
- Kommunalt bookingsystem
- Planner
- Kommunalt ydelsessystem
- LSS (Landssupportsystem)
Særlige krav til test
Testscenarie |
Berørte systemområder |
Identificeret af |
|
|
|
|
|
|
Kendte udeståender fra udviklingsfasen
Link til søgeresultat fra FogBugz på epic-nummer:
User stories
User stories er kun til interne brug for STAR's leverandører.