714.2 Modernisering af WSRM-beskeder - opfølgning i 2016-4
- Mathilde Stisen (STAR) (Unlicensed)
714.2 Modernisering af WSRM-beskeder - opfølgning i 2016-4
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
714.2.1 Der er etableret en simplere måde at afhente WSRM-beskeder, som kun efterspørger relevant information
714.2.2 Den nye model for metadata anvendes på alle fremadrettede beskeder
723.2.3 Det sikres at implementeringen af nye WSRM metadata gøres ensrettet i DFDG
5 Særlige krav til test
6 Kendte udeståender fra udviklingsfasen
7 User stories
8 Implementeringsnoter
Ændringslog
Dato | Version | Forfatter | Berørte afsnit |
15.06.2016 | 0.1 | Jesper Brunholm | Epic oprettet på grundlag af 714.1 |
28.06.2016 | 0.3 | Jesper Brunholm | Opdatering ifm. planning. Løft til version 0.3. OcesCertHeaderInput taget ud, dette er allerede fjernet i version 2 |
07.07.2016 | 0.5 | Jesper Brunholm | Tydeliggjort at fravalg af beskeder er med abonnements opsætning. Blanket for ændringer efter løft til 0.5 |
05.09.2016 | 0.5 | Jesper Brunholm | Tilføjet link til ISB. Tilføjet WSRM-beskeder som får nye metadata i 2016-4 i afsnit 3. Listen er pt. ikke komplet. |
22.09.2016 | 1.0 | Jesper Brunholm | Kompletteret listen af WSRM beskeder som får ny metadatamodel. Løft til 1.0 |
Afgrænsning af epic
Afgrænsning | |||
Som aftager af DFDGs WSRM-beskeder ønsker jeg at afhentning så vidt muligt gøres simpel for at jeg nemmere kan implementere og vedligeholde beskederne i mit system. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for Beskriver hvilke af STARs leverandører som skal løse dette acceptkriterie | |
714.2.1 | Der er etableret en simplere måde at afhente WSRM-beskeder, som kun efterspørger relevant information | DFDG | |
714.2.2 | Den nye model for metadata anvendes på alle fremadrettede beskeder | DFDG | |
714.2.3 | Det sikres at implementeringen af nye WSRM metadata gøres ensrettet i DFDG | DFDG |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | ||||||||
714.2.1 | 714.2.2 | 714.2.3 | ||||||||
Integration til ny WsrmService (Version 3) | X | Det vil fortsat være muligt at anvende Version 2 i en overgangsfase. | ||||||||
Modtagelse af nye metadata i WSRM beskeder | X |
Bemærk at der ikke er defineret en forretningsmæssig rækkefølge for alle WSRM-beskeder i DFDG og det ligger ikke i scope for denne epic at rette op på eventuelle uhensigtsmæssigheder i rækkefølgen. Sådanne ændringer vil skulle komme til i andre epics i efterfølgende releases.
Oversigt over berørte web services
Snitflade | Serviceaftager der er berørt | Bemærkninger | |||||||||
DFDG | Jobnet | Plannersystemer | KSS | A-kasse | Ydelsessystem | JobKon | Andet | ||||
WsrmService (Version 3) | X | X | X | X | X | Version 2 bevares ind til videre. | |||||
WSRMMessageService (Version 10)
| X | X | Løftet i 2016-3 med epic 714.1. Får tilføjet SortKey m.m. i 2016-4 | ||||||||
| x[x] | x[x] | Epic 746.1Der bevares ind til videre mulighed for at aftage en gammel version hvor der laves nye versioner. | ||||||||
| x | x | Epic 746.1 | ||||||||
| x | x | Epic 642.4 | ||||||||
| x | Epic 642.4 | |||||||||
| x | Epic 642.4 | |||||||||
| X | X | Epic 727.1 | ||||||||
WSRMbeskederne nævnt herover er blot opremsede for at man skal kunne få overblik over hvilke WSRM'er der berøres af den nye model. Detaljer om deres indhold skal søges i andre epics, nævnt under kommentarer.
Der bevares ind til videre mulighed for at aftage en gammel version hvor der laves nye versioner. Nyoprettede beskeder bliver kun tilgængelige med ny metadatamodel, men på såvel WSRMService version 2 som version 3.
Beskrivelse af epic
ISB 714 som er rammen for denne Epic er under udarbejdelse.
Denne Epic beskriver en ensretning og lidt oprydning i WSRM understøttelsen.
714.2.1 Der er etableret en simplere måde at afhente WSRM-beskeder, som kun efterspørger relevant information
Den nuværende snitflade til afhentning af WSRM beskeder udstilles via WsrmService (Version 2).
Der oprettes en Version 3 af samme service hvor der foretages følgende ændringer:
- Operationen SequenceAcknowledgement fjernes helt
- I operationen TerminateSequence fjernes responseelementet
- MissingRangeCollection
- I operationen CreateSequenceResponse fjernes følgende response-elementer:
- Expires
- AcknowledgementInterval
- Accept
Tilføjelse at sorteringsnøgle på alle WSRM beskeder pr. sekvensafhentning.
Logikken I WsrmService forsimples sådan at TerminateSequence altid afslutter sekvensen. Det skal derfor ikke længere tjekkes at alle hændelser i kvitteret og heller ikke tjekkes at alle hændelser er forsøgt hentet. TerminateSequence vil fortsat logge om hændelser er forsøgt hentet.
Det bliver på denne måde op til aftager selv at sikre at alle hændelser hentes og herefter kalde TerminateSequence for at gå videre eller CloseSequence for at forsøge igen.
Det giver ingen ekstra sikkerhed at kvittering som i dag. Kvitteringslogikken er unødig kompleks og manglende kvittering betyder blot at WSRM modtagelsen går i stå, så aftager er tvunget til at kvittere.
Aftager kan stadig kalde CloseSequence for at opgive afhentning og lade sekvensen gå forfra. Hvis aftager får fejl under afhentning af hændelser, kan aftager enten forsøge at hente de berørte hændelser igen eller i yderste konsekvens kalde CloseSequence for at starte forfra. 
Aftager kan aktivt fravælge beskeder som ikke ønskes ved blot at undlade at hente disse med opsætning af WSRM abonnement.
Denne ændring betyder også at fejlkode 4005-"Not all messages in the WS-RM Sequence were acknowledged" udgår.
Bemærk: Den nuværende Version 2 bibeholdes, men genimplementeres så den kalder Version 3 inde bagved. Dvs. at kald til SequenceAcknowledgement ignoreres og andre felter vil enten blive ignoreret eller sat til null hvor de returneres.
714.2.2 Den nye model for metadata anvendes på alle fremadrettede beskeder
Liste over implementerede beskeder i 2016-4 vedligeholdes i Oversigt over berørte web services.
723.2.3 Det sikres at implementeringen af nye WSRM metadata gøres ensrettet i DFDG
Dette kan være gennem en implementeringsguide eller anden form for støtte til de teams som skal implementere de nye WSRM metadata.
Særlige krav til test
Testscenarie | Berørte systemområder | Identificeret af |
Modtag hændelser via ny WsrmService | ||
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.
Implementeringsnoter
Elementerne EnqueueDateTime og SortKey tilføjes i databasen til WSRM køen.
Felterne sættes til NULL eller lignende indtil når beskeden enqueues. Når WSRM beskederne dequeues læses de to felter fra databasen og skrives ind i beskederne inden de returneres til aftagerne.