Løsningsbeskrivelse til P12-28-B1 Ydelser til Ydelsesindeks (Bølge 1, spor 1)

Transkript

1 Løsningsbeskrivelse til P12-28-B1 Ydelser til Ydelsesindeks (Bølge 1, spr 1) Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 1 af 10

2 Indhld 1 Prjektets rammer Frmål g baggrund fr prjektet Prjektets frventede hvedresultat Prjektets målgruppe Myndighedskrav til løsningen Referencer Løsningsbeskrivelse Arkitektur Frretningsgange Anvendte snitflader på STS Udfyldelse af data i snitfladerne Fejlscenarier Lgning hs KMD Sikkerhed Drift g pstart Frudsætninger Test Versinsversigt Versin Dat Oprettet af Beskrivelse af ændring CE Første versin af dkumentet PSZ Opdateret på wrkshp efter review kmmentarer fra KOMBIT PSZ Opdateret referencer jf. ny baseline i frb. m ÆA PSZ Opdateret at UUIDer g URNer ligger i database PSZ Svar på kmmentarer fra KOMBIT PSZ Afsnit m sikkerhed rettet jf. beslutning af PSZ Tilføjet inf vdr. begrænsende finkrnet sikkerhed TTE Opdateret med link til mapning under 1.5. Referencer CVS Baseline efter SIT HVJ Afsnit m lgning er tilføjet Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 2 af 10

3 1 Prjektets rammer 1.1 Frmål g baggrund fr prjektet I frbindelse med udfasningsassistancen, er det aftalt, at der skal ske en publicering af ydelseshændelser til KOMBITs Støttesystem Ydelsesindeks fr de KMD-fagsystemer tilknyttet KMD Sag, der arbejder med ydelsessager. Frmålet er således at understøtte rammearkitekturens støttesystem Ydelsesindeks ifm. udfasningen. Til publicering af ydelseshændelser er prindeligt udviklet følgende snitflade under klippekrt: P12-28 Ydelseshændelser Denne snitflade er implementeret med interne MQ-køer mellem KMD Sag g 3. part. Denne implementering, er det aftalt at ændre i Bølge 1 med: P12-28-B1 Ydelseshændelser (spr 1)(ÆA 84) Frmålet med nærværende klippekrtsprjekt, P12-28-B1 er, at sikre at KMD publicerer ydelseshændelser ved at pdatere Ydelsesindeks i KOMBITs Støttesystemer (STS) via gennemstilling fretaget af Serviceplatfrmen, defineret sm Bølge 1, spr Prjektets frventede hvedresultat En standard service på KMD Sag, der faciliterer en hændelsesbaseret integratin af ydelseshændelser mellem KMD-fagsystemer g Ydelsesindeks, således at der fr hver gang, der i KMD-fagsystemer dannes en Øknmisk effektuering, sker en synkrnisering af data til Ydelsesindeks. Når KMD-fagsystemer sender en ydelseshændelse, vil den altid bestå af en Bevilling g en Øknmisk effektuering. 1.3 Prjektets målgruppe Kmmunerne g UDK er den primære målgruppe gennem deres kmmende anvendelse af løsninger realiseret via rammearkitekturen. 1.4 Myndighedskrav til løsningen Servicen skal benytte den fælleskmmunale Serviceplatfrm g anvende services udstillet af STS Ydelsesindeks. Dataudvekslingen skal følge den mellem KL, ATP, KMD g KOMBIT udarbejdede mdel fr Dataudvekslingsaftale. 1.5 Referencer Følgende dkumenter refereres. Reference Beskrivelse Dkumentnavn Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 3 af 10

4 [MAPNING-1] [STS-basseline] STS baseline Dkument der beskriver mapningen mellem felter i KMDfagsystemer g XML-strukturer anvendt i snitfladerne. jekter%2fp12%2d28%2db1%20ydel- ser%20til%20ydelsesindeks%2fkom- BIT%20%2D%20Baseline%20pr%2E%2015%2E11%2E2016&Fl derc- TID=0x012000F8476A4ABD8BBF4AB3F6AB AAEB0E13FF&View=%7BEF6E2034%2D4F1 F%2D4221%2D9230%2D132B158A08C4% 7D 2 Løsningsbeskrivelse Den anvendte arkitektur er baseret på diskussiner g afklarende møder med KOMBIT, herunder fundamentet fra klippekrtsprjektet P Arkitektur Den nuværende løsning i P12-28 vil blive tilpasset fr, at kunne understøtte struktur g frretningslgik i STS Ydelsesindeks beskrevet i [STS-snit] g [STS-fælles]. Der udvikles en brker, der kan varetage frsendelse af hændelser fra de interne KMD Sag MQ køer til STS via gennemstilling til Serviceplatfrmen, samt mdtage det synkrne svar fra Serviceplatfrmen. Brkeren skal desuden håndtere sikkerhed. KMD Sag KMD internt KMD eksternt Fagsystem Frmater ydelseshændelse Fagsystem Fagsystem MQ-kø Brker Serviceplatfrmen Støtesystem (Ydelsesindeks) Fagsystem MQ-kø fejlkø Figur 1 - P12-28-B1 Arkitektur Løsningen er en hændelsesbaseret service, sm eksprterer ydelseshændelser, hver gang der dannes en Øknmisk effektuering i et af de til KMD Sag tilsluttede KMD-fagsystemer. Når der Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 4 af 10

5 ikke længere dannes Øknmiske effektueringer, vil der ikke længere ske pdateringer af Bevillingen. Fr alle KMD fagsystemer vil det betyde, at der ikke bliver sat en stp-dat på bevillingen. Kmmunikatinen med Serviceplatfrmen er en synkrn kmmunikatin. Hvis brkeren får fejl fra Serviceplatfrmen/STS, vil den håndtere fejlen jævnfør afsnit Kmmunikatinen mkring hændelsen sker så tæt på hændelsestidspunktet sm muligt. Men hvis der kmmer mange hændelser fra et fagsystem, (f.eks. ver en millin) vil dette kunne tage timer at sende alle hændelser ver til STS. Antal hændelser ver 1 mi. frventes kun fr UDK systemer. De UUID er der sendes videre til STS, vil verhlde standarden fr UUID er. UUID er g URN er er placeret i en database, således at de er nemme at pdatere, hvis der skulle kmme ændringer. Der vil være frskellige UUID fr IT systemer i ekstern test g prduktin. 2.2 Frretningsgange Når et KMD-fagsystem danner en Udbetaling/Øknmisk effektuering, pretter fagsystemet en transaktin, med en ydelseshændelse, bestående af fagsystemets data m den Øknmiske effektuering g den tilhørende Bevilling. Data fra denne transaktin beriges med data fra den tilhørende KMD Sag sag, inden den leveres til Ydelsesindeks. 2.3 Anvendte snitflader på STS I frbindelse med gennemførelse af analysefasen er det fremkmmet, at de snitflader, der skal anvendes i frbindelse med P12-28-B1 til at pdatere Ydelsesindeks med en ydelseshændelse er følgende: Imprter Opdater Opdateringen vil ske efter følgende mdel: 1. Kald fra Brker med Opdater Bevilling Dette kan resultere i: a. OK Bevilling er pdateret Dette efterfølges af kald fra Brker med Imprter Øknmisk effektuering b. Bevilling er ikke fundet Dette efterfølges af kald fra Brker med Imprter Bevilling g Øknmisk effektuering Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 5 af 10

6 2. Hvis Imprter Øknmisk effektuering eller Imprter Bevilling g Øknmisk effektuering fejler med, at Øknmisk effektuering allerede findes, vil der efterfølgende blive kaldt med Opdater Øknmisk effektuering Udfyldelse af data i snitfladerne Fagsystemet fr hvilket der sker dataafgrænsning i STS, er Master IT system, mens afsender system er KMD SAG. Kmbit har bestilt, at UUID fr ekstern test g prduktin er frskellige, g KMD skal understøtte dette. I analyse/designfasen er der gennemført en række wrkshps med KOMBIT, hvr de enkelte snitflader er gennemgået med henblik på at fastlægge, hvrledes datastrukturen g datamapningen skal anvendes. Den XML, der vil blive anvendt ved levering af data til Ydelsesindeks, er beskrevet i [STS Baseline]. De data, der leveres til Ydelsesindeks ved anvendelse af de udstillede snitflader, er beskrevet i [MAPNING-1]. En ydelseshændelse vil indehlde følgende data på et verrdnet niveau: Bevilling AttributListe Egenskaber BevilgetYdelse ItSystem (Master) ItSystem (Afsender) Ydelse/KLE Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 6 af 10

7 TilstandListe RelatinListe OeknmiskEffektueringsplan Bevillingssag Bevillingspart (Ydelsesmdtager) Bevillingspart (Bevillingsmdtager) Bevillingsakter (Ejer) Bevillingsakter (Ansvarlig) ØknmiskEffektuering AttributListe Egenskaber TilstandListe RelatinListe OeknmiskYdelseEffektuering/KLE Akter (Ejer) Akter (Udbetalende enhed) ItSystem (Master) ItSystem (Afsender) OeknmiskEffektueringPart (Effektueringsmdtager) Finkrnet sikkerhed Ydelser der hænger på sager fra KMD SAG der har brugerstyret adgang, der begrænser adgang, verføres ikke. Hvis der tilføjes begrænsende finkrnet sikkerhed efter sagen er synkrniseret, sendes der ikke yderligere pdateringer til STS. Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 7 af 10

8 2.3.2 Fejlscenarier KMD internt KMD eksternt P Fejlkø Datakø 2 3a Brker 3 4 Serviceplatfrmen Fejlhåndtering af fejl fra STS g Serviceplatfrmen sker udelukkende i brker. Vi Alt Fejl fra STS plus SOAP fault kategriseres i t fejltyper: type gensend g type fejl. Eksempelvis m der skal gensendes (prøves igen), eller m ydelsen skal smides på fejlkø til manuel behandling. Flg. svar/fejl kan pstå: Returkde Opdater Imprter Fejl lgning i Handling/beskrivelse AQ78000T (ved Errr sendes mail) 20 OK OK OK 40 Frespørgslen har frkert struktur 41 Ikke autriseret til at kalde servicen 44 Det frespurgte frretningsbjekt ikke fundet Fejl Fejl Errr Det skal undersøges, m XML en er krrekt. Send på fejlkø. Send mail Fejl Fejl Errr Det kan være at autrisatinen (serviceaftalen) endnu ikke prettet. Det kan undersøges, g sendes igen, når den er prettet. Imprter - Ingen Sædvanlig frretningsgang. Kmmer ikke ud, det frbliver i styrring. 45 Registreringstidspunkt er større - Kun ved end dd. imprter (fejl) Errr Registrering angives kun ved Imprt. Der må derfr være fejl i tidsangivelse. Check XML. Send på fejlkø. 47 Virkningsinterval ikke gyldigt Fejl Fejl Errr Send til MQ fejlkø. 48 <Se relevant fejlmeddelelse i Fællesdkument fr Fejl Fejl Errr med teksten fra STS Nget skal undersøges. Fejlteksten frtæller, hvad der er fejl. Sendes på fejlkø. Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 8 af 10

9 snitfladerne i Støttesystemerne> 49 Frretningsbjekt har livscyklus sm ikke tillader imprt - Opdater / Ingen Fejl Vi prøver med det mdsatte af hvad vi gjrde, hvis det ikke virker fejler vi Burde aldrig ske. 49 Frretningsbjekt har livscyklus Imprter/ - Ingen Vi prøver med det mdsatte af hvad sm ikke tillader Opdater Fejl vi gjrde, hvis det ikke virker fejler vi Burde aldrig ske. 51 Service ikke implementeret (??) Fejl Fejl Errr Vi fejler, det vil ikke løse sig selv 53 Service ikke tilgængelig Gensend Gensend Warning Hvis der er servicevindue, så prøver vi igen senere. 55 Serviceversin ikke understøttet Fejl Fejl Errr Vi fejler, det vil ikke løse sig selv (??) 70 Trashcan exceptin frm brker4 Kmmer ikke til kald til STS Kmmer ikke til kald til STS Errr Brkeren kan ikke lide data fra MF. Undersøg, hvad brker er utilfreds med, check evt. lgning på MF af de sendte data, g data på fejlkø Kendte SOAP fault Gensend Gensend Warning Registrer at en sådan er fremkmmet. 98 Ikke valid returkde fra SP/STS Gensend Gensend Warning (ikke SOAP, men ukendt i frhld til 40-55) Dette er ikke SOAP fejl, men ukendt i frhld til fejlkde Ukendt SOAP fault Gensend Gensend Warning Husk registrer fejl, via mail Og der er samtidig en FEJL i 780 lggen Bemærk når hændelser skal gensendes, sendes den tilbage g sidst på køen, dvs. der derefter behandles andre hændelser. Når der pstår en gensend fejl, da sættes Brkeren i Wait. Først i 1 min, næste gang den får en gensend fejl. Ved næste hændelse, da sættes brkeren i wait i 5 min, herefter i 30 min g tilslut i en time. Når den har været i wait en time, starter den p, sm intet var sket. Hvis der stadig er fejl, går den slevfølgelig i wait, først krt g efter flg. længere. Dette fr at understøtte servicevinduer g driftnedbrud. Når en hændelse skal fejle køres denne på fejl køen g brkeren kører bare videre. 2.4 Lgning hs KMD Der indføres ingen ekstra lgning i KMD Sag i frbindelse med at fagsystemet sender ydelser via P12-28-B1. Transaktinshistrikken ver snitfladen bliver gemt sammen med retursvar fra Serviceplatfrmen/STS. Fr hver ydelseshændelse lgges følgende plysninger i KMD Sag sagshændelsestabellen: Hændelsens UUID Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 9 af 10

10 Leverandør (hændelsens leverandør = Fagsystem) RequestID (bevillingssag COID, INSTID mfrmet til UUID) TransaktinsID Timestamp fr kald til SP Request til SP Reply fra SP. Der er histrik på hver hændelse, sm ajurføres i frbindelse med retursvar fra Serviceplatfrmen/STS. 2.5 Sikkerhed Løsningen bruger sikkerhedsmdellen AuthrityCntext, sm består i at vi bruger en speciel versin af WSDL/XSD, udgivet af Serviceplatfrmen, der kræver at man definerer et CVR nummer fr kmmunen i en AuthrityCntext, hvrefter Serviceplatfrmen får Tken fra STS g kalder videre med dette. Vi kalder serviceplatfrmen med certifikat. 2.6 Drift g pstart KOMBIT skal sikre, at den enkelte kmmune klarmeldes til synkrnisering, sm KMD efterfølgende registrerer ved en tilslutningsaftale. KOMBIT kan bestille, at vi psamler hændelser fra KMD fagsystemer, inden vi påbegynder verførslen til STS. KMD skal have besked m dette senest 1 måned i frvejen. KMD kan kun psamle fr alle kmmuner, dvs. at der ikke kan være ngle kmmuner der sender ver, g andre ikke. Og der vil blive sendt fr alle kmmuner når vi starter p. 2.7 Frudsætninger Det frudsættes at KOMBIT har fuldmagt fra dataejerne til de data, sm leveres gennem Serviceplatfrmen til Ydelsesindeks. Den anvendte XML struktur er den af KOMBIT baseline dateret De Øknmiske effektueringer verføres sm tidligere aftalt med KMD-fagsystemerne. Det betyder, at hvis KMD-fagsystemet sender ydelseshændelser med plysninger m skat, ATP eller lignende ver sm effektuerede ydelser, bliver disse videreført til STS Ydelsesindeks. 2.8 Test Der udarbejdes en særskilt teststrategi fr denne løsningsbeskrivelse. Dkument-nr.: Versin: V3.0 Frfatter: CVS Versinsdat: Gdkender: Side 10 af 10