714.2 Modernisering af WSRM-beskeder - opfølgning i 2016-4

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)

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


2016-41.0KSS, A-kasse, andre

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)

  • GetCitizenMessageEventVersion3




X

X





Løftet i 2016-3 med epic 714.1. Får tilføjet SortKey m.m. i 2016-4


      • [WSRMbeskeder som løftes til ny version får den nye WSRMMetadataType]GetCompanyRecruitmentVersion1




x[x]

x[x]





Epic 746.1Der bevares ind til videre mulighed for at aftage en gammel version hvor der laves nye versioner.


      • GetCompanyRecruitmentEventVersion1




x

x





Epic 746.1


  • GetJobAllocationAddonsStatus NotificationVersion1




x




x


Epic 642.4


      • GetJobOfferStatusNotificationVersion3




x






Epic 642.4


    • Get{*}JobAllocationsNotificationVersion3




x






Epic 642.4


  • GetUnemploymentBenefitsAccount Version1




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.