639.3 Sikring af synkronitet for bookingsystemer

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)

STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader


2017-11.0

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


(error)







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.