Integration 1411_E Besked om tillægsprocent Integrationsbeskrivelse - version 0.3.2

Transkript

1 Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer PBO 0.1 Første version EDM Opdateret efter sammenlægning af SF1411_D og _F MHO Gennemskrivning og sammenlægning af afsnit MHO Kommentarer fra KY indarbejdet. Struktur i afsnit om BF ændret til nyt format MHO Opdatering af afsnit 1.2, volumen og beskedkuvert Referencer Ref. Titel Kommentarer [SPref] [SIKKERHED] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v [STS-Sikkerhed] Integrationsvilkår Bilag 2. Sikkerhed version 1.3 [STS Beskedfordeler] Beskedfordeler kuvert: nderbilag%203.a%20beskedkuvert%20version%2 01.3%2018.%20marts% pdf [SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeleren [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeleren [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeleren [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeleren [P12-1] [SF1411_A] [SF1411_B] [SF1411_D] [SF1411_E] Integration til KMD Social Pension som specificeret i P12_1_Snitfladebeskrivelse_v008 SF1411_X Integrationsbeskrivelserne for de relaterede integrationer vedr. social pension De fire beskrivelser om social pension er indbyrdes afhængige og skal læses i sammenhæng. KOMBIT A/S Halfdansgade København S CVR Side 2 af 30

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Sammenhæng til andre snitflader Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning af integration social pension Kontekst for integrationsparter Kontekst for Kommunernes Ydelsessystem Kontekst for Kommunal Pension Kontekst for KMD Social Pension Specifikation for integrationsparter Specifikation af endpoints for Kommunernes Ydelsessystem Specifikation af endpoints for Kommunal Pension og SP som afsendende beskedagent Specifikation af endpoints for KMD Social Pension Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 30

4 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med integrationen er at sende beskeder med ændringer til informationer om helbredsprocent for en given person: Beskederne kommer fra pensionssystemerne KMD Social Pension Kommunedel og det kommende Kommunal Pension. Beskederne vil i en transitionsperiode komme fra begge systemer. Beskederne leveres til fagsystemer, f.eks. Kommunernes Ydelsessystem (KY). I forbindelse med monopolbruddet sker der en løbende udskiftning af det nuværende pensionssystem KMD Social Pension. KMD Social Pension består af to dele: KMD Social Pension Kommunedel, som varetager systemunderstøttelsen af de kommunale opgaver, og KMD Social Pension UDK-del, som varetager systemunderstøttelsen af opgaver for UDK. KMD Social Pension erstattes fremadrettet med to nye pensionssystemer, UDK Pension og Kommunal Pension. Ændringer til øvrige informationer om social pension er beskrevet i [SF1411_D]. 1.2 Sammenhæng til andre snitflader Dette afsnit giver en introduktion til den samlede løsning for området social pension og sammenhængen mellem integrationerne. Det er en fælles tekst, som går igen i alle fire integrationsbeskrivelser, der omhandler social pension. Følgende integrationsbeskrivelser indgår i gruppen: SF1411_A Hent informationer om social pension [SF1411_A] SF1411_B Hent helbredsprocent [SF1411_B] SF1411_D Besked om informationer om social pension [SF1411_D] SF1411_E Besked om helbredsprocent [SF1411_E] Formålet med gruppen af snitflader er at udveksle informationer om samt ændringer i informationer om social pension (tillægsprocent, helbredsprocent, samliv, formue, Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder). Informationerne udveksles mellem fagsystemer (f.eks. Kommunernes Ydelsessystem herefter KY) og de tre pensionssystemer KMD Social Pension, UDK Pension og Kommunal Pension (andre systemer kan komme til). KOMBIT A/S Halfdansgade København S CVR Side 4 af 30

5 Serviceplatformen samt fag- og pensionssystemernes snitflader til støttesystemet Beskedfordeler (herefter: Beskedfordeler) beskrives i følgende integrationsbeskrivelser: SF1460_A Modtag besked [SF1460_A] SF1460_B Vedligeholde værdiliste i beskedabonnement [SF1460_B] SF1460_C Aflever besked [SF1460_C] SF1460_D Modtag besked via pull [SF1460_D] Målarkitektur Målarkitekturen for den kommende løsning består af pensions- og fagsystemerne UDK Pension, Kommunal Pension og KY, som skal udveksle informationer relateret til social pension. Det er et forretningsmæssigt mål, at snitfladerne mellem systemerne i målarkitekturen understøtter en løbende udfasning af KMD Social Pension. Endvidere er det et forretningsmæssigt mål, at målarkitekturen for integrationerne mellem de kommende systemer bliver løst koblede, således afhængigheder mellem fagsystemer mindskes og udskiftning af systemer bliver mere effektiv fremadrettet. For at sikre løs kobling mellem systemerne, vil målarkitekturen benytte Serviceplatformen som integrationsplatform ved online opslag og det fælleskommunale støttesystem Beskedfordeler som integrationsplatform ved orientering til KY og Kommunal Pension om ændringer i informationer om social pension. KOMBIT A/S Halfdansgade København S CVR Side 5 af 30

6 Målarkitekturen for de involverede systemer og deres endpoints for udstillede snitflader er vist på nedenstående figur: Beskedfordeler SF1411_D SF1411_E Opdater værdiliste SF1411_D Modtag besked om tillægsprocent SF1411_E Send besked om helbredsprocent SF1411_D Send besked med informationer om social pension SF1411_E Modtag besked om helbredsprocent SF1411_D Modtag besked om samliv og formue SF1411_D SF1411_E Opdater værdiliste Kommunal Pension UDK Pension KY SF1411_B Udstil helbredsprocent SF1411_A Hent tillægsprocent, samliv og formue SF1411_A Udstil informationer om social pension SF1411_B Hent helbredsprocent SF1411_A Hent samliv og formue Serviceplatformen Figuren viser Serviceplatformen, Beskedfordeler og de involverede fagsystemer med udstillede og anvendte snitflader. UDK Pension udstiller snitflader til Serviceplatformen med informationer om social pension, som indeholder tillægsprocent, samliv, formue, Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder (SF1411_A), og afsender beskeder med ændringer i samme oplysninger via Beskedfordeler (AF1411_D). Kommunal Pension bruger en snitflade udstillet på Serviceplatformen til opslag af tillægsprocent (SF1411_A) og modtager beskeder med ændringer i tillægsprocent via Beskedfordeler (SF1411_D). Kommunal Pension udstiller en snitflade til opslag på helbredsprocent via Serviceplatformen (SF1411_B) og afsender beskeder om ændringer i helbredsprocent via Beskedfordeler (SF1411_E). KY anvender snitflader udstillet på Serviceplatformen til opslag af samliv og formue (SF1411_A) og helbredsprocent (SF1411_B), og modtager beskeder om ændringer til samliv og formue (SF1411_D) og helbredsprocent (SF1411_E) via Beskedfordeler. Kommunal Pension og KY vedligeholder deres abonnementer (herunder værdilister). Autorisation og autentifikation mellem KY, UDK Pension, Kommunal Pension, Beskedfordeler og Serviceplatformen sker ved hjælp af det fælleskommunale støttesystem Adgangsstyring. KOMBIT A/S Halfdansgade København S CVR Side 6 af 30

7 Transitionsarkitektur For at kunne understøtte udfasningen af KMD Social Pension er en transitionsfase indført, hvor flere fag- og pensionssystemer samtidigt varetager opgaven med beregning og udveksling af informationer om tillægsprocent, helbredsprocent, samliv, formue, Pensionsbrøk, afslag på folkepension og oplysninger om udlandsophold over to måneder for kommunerne og UDK. Håndteringen af denne kompleksitet er Serviceplatformens ansvar, så UDK Pension, Kommunal Pension og KY, kan anvende målarkitekturen i videst mulige omfang uden at skulle forholde sig til transitionen. I transitionsarkitekturen har Serviceplatformen ansvar for at opslag fra fag- og pensionssystemer foretages imod det korrekte kildesystem samt korrekt transformation af data fra KMD Social Pension til beskeder, der sendes og modtages via Beskedfordeler. Transitionsarkitekturen indeholder KMD Social Pension i stedet for Kommunal Pension, og er vist med endpoints for udstillede snitflader på nedenstående figur: Udstil ændringer med informationer om social pension (SF1411_D) inkl. helbredsprocent (SF1411_E) Udstil informationer om social pension (SF1411_A) inkl. helbredsprocent (SF1411_B) Modtag ændringer med informationer om social pension (SF1411_D) fra UDK Pension og helbredsprocent (SF1411_E) fra Kommunal Pension (ses ikke på tegning). KMD Social Pension (Kommune og UDK del) Send besked med informationer om social pension (SF1411_D) og helbredsprocent (SF1411_E) fra KMD Socialpension Hent besked med informationer om social pension (SF1411_D) fra UDK Pension og helbredsprocent (SF1411_E) fra Kommunal Pension (ses ikke på tegning). Beskedfordeler UDK Pension Send beskeder med informationer om social pension (SF1411_D) Udstil informationer om social pension (SF1411_A) KY Hent Besked om helbredsprocent (SF1411_E) og samliv + formue (SF1411_D) Opdater værdiliste (SF1411_A og _B) Hent helbredsprocent (SF1411_B) og samliv + formue (AF1411_A) Serviceplatformen Figuren viser transitionsarkitekturen i forbindelse med udfasningen af KMD Social Pension, hvor det nye Kommunal Pension fagsystem ikke er introduceret endnu. Sammenlignet med målarkitekturen er det Serviceplatformen, der er ansvarlig for at sende beskeder via Beskedfordeler og hente beskeder fra Beskedfordeler på vegne af KMD Social Pension. Serviceplatformen dirigerer opslag fra KY og UDK Pension til KMD Social Pension, og afleverer ændringer i informationerne til KMD Social Pension. Kommunal Pension og KMD Social Pension Kommunedel vil sameksistere i en transitionsperiode, hvor Kommunal Pension vil modtage tillægsprocent fra UDK Pension eller KMD Social Pension. KOMBIT A/S Halfdansgade København S CVR Side 7 af 30

8 Integrationerne [SF1411_A], [SF1411_B], [SF1411_D] og [SF1411_E] skal således ses i sammenhæng med mest muligt genbrug af komponenter på tværs af integrationerne. KOMBIT A/S Halfdansgade København S CVR Side 8 af 30

9 1.3 Overordnet forretningsflow i integrationen Følgende forretningsflow indgår i integrationen: IF01 Afsend besked : Pensionssystemet Kommunal Pension sender oplysninger om ændringer i helbredsprocent som beskeder til Beskedfordeler. I transitionsfasen kan oplysningerne også komme fra pensionssystemet KMD Social Pension. Serviceplatformen modtager ændringen fra KMD Social Pension via et kø system og transformerer ændringen til beskeder, som udsendes via Beskedfordeler. IF02 Modtag besked : Fagsystemet modtager beskeder om ændringer i helbredsprocent fra Beskedfordeler. IF03 Opdater værdiliste indeholder et scenarie: Fagsystemet opdaterer værdiliste i abonnement på Beskedfordeler. Beskedfordeler returnerer forretningsmæssig kvittering. Integrationen er i transitionsfasen en orkestreringsintegration med transformation, hvor Serviceplatform agerer som beskedagent. Serviceplatformen indgår ikke i den endelige version af integrationen. Integrationens forretningsflow for IF01 og IF02 i den endelige integration er illustreret på nedenstående diagram: KOMBIT A/S Halfdansgade København S CVR Side 9 af 30

10 Kommunal Pension Beskedfordeler Fagsystem(n) Integrationsbeskrivelse IF01 Afsend besked IF02 Modtag besked Modtag Besked Abonnement Modtag besked Distribuer besked Generer ændring Ændring til helbredsprocent KOMBIT A/S Halfdansgade København S CVR Side 10 af 30

11 Beskedfordeler Fagsystem KMD Social Pension Kommunal Pension Serviceplatform Beskedfordeler Fagsystem(n) Integrationsbeskrivelse Integrationens forretningsflow for IF01 og IF02 i transitionsfasen er illustreret på nedenstående diagram: IF01 Afsend besked IF02 Modtag besked Modtag Besked Distribuer besked EP_FS1 Modtag besked Abonnement EP_PENS1 Generer Besked EP_KS1 Generer ændring EP_PENS1 Helbredsprocent ændret Generer ændring Helbredsprocent ændret Integrationens forretningsflow for IF03 er illustreret på nedenstående diagram: IF03 Opdater værdiliste Part ændret Kræver ændring Abonnement oprettet EP_FS2 Opdater værdiliste Opdater værdiliste Kvittering for ændret værdiliste KOMBIT A/S Halfdansgade København S CVR Side 11 af 30

12 1.4 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Flow IF01, IF02, IF03 For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og Kommunal Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og Kommunal Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og Kommunal Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og Kommunal Pension] For Serviceplatformen gælder oplysninger i den nuværende driftsaftale. Se [SPref]. [Afklaring/KDF indsæt servicemål for Beskedfordeler, KMD Social Pension og Kommunal Pension] Service Management Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] KOMBIT A/S Halfdansgade København S CVR Side 12 af 30

13 1.5 Teststrategi Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Testfaciliteter og testmiljø Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF undersøg testfaciliteter og testmiljø hos KMD] Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Test i forbindelse med produktionssætning [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF undersøg om der findes aftale om produktionssætning med KMD] 1.6 Forudsætninger for produktionssætning af integration social pension Forudsætninger for funktionalitet på Serviceplatformen Ingen Generelle forhold for tilslutning til integrationspart: Kommunal Pension og KY Integrationerne mellem Serviceplatformen, Beskedfordeler, UDK Pension, Kommunal Pension og KY er tokenbaserede. Løsningerne skal oprettes i den det fælleskommunale støttesystem Adgangsstyring. For at kunne modtage beskeder via Beskedfordeler skal Kommunal Pension og KY oprette de nødvendige abonnementer forud for idriftsættelse af integrationen Generelle forhold for tilslutning til integrationspart: KMD Social Pension Integrationerne mellem KMD Social Pension og Serviceplatformen er certifikatbaseret. Kommunerne skal have de nødvendige VOCES certifikater, før løsningen tages i brug. Alle certifikater skal gennemgå en KOMBIT A/S Halfdansgade København S CVR Side 13 af 30

14 godkendelsesprocedure i KMD. KMD meddeles leverandørens certifikat senest tre uger før, grænsefladerne kan tages i brug. [Afklaring/KDF det skal afklares, om KMD s systemer skifter til en tokenbaseret sikkerhedsmodel] KOMBIT A/S Halfdansgade København S CVR Side 14 af 30

15 2 Kontekst for integrationsparter 2.1 Kontekst for Kommunernes Ydelsessystem Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål med integrationen er, at KY modtager besked om ændrede oplysninger om helbredsprocent for en person. Oplysningerne kan således indgå i beregning af personens ydelser i Kommunernes Ydelsessystem Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca pr. måned, samt årlig genberegning med op til ca beskeder. Antallet afhænger af antallet af oprettede abonnementer Specifikke forhold for tilslutning af system Sikkerheden mellem KY og Beskedfordeler er tokenbaseret, så de nødvendige rettigheder skal oprettes i det fælleskommunale støttesystem Adgangsstyring før idriftsættelsen. For at kunne modtage beskeder via Beskedfordeler skal Kommunal Pension oprette de nødvendige abonnementer forud for idriftsættelse af integrationen. 2.2 Kontekst for Kommunal Pension Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål med integrationen er, at Kommunal Pension udsender besked om ændrede oplysninger om helbredsprocent for en person. Oplysningerne kan således indgå i beregning af personens ydelser i Kommunernes Ydelsessystem. KOMBIT A/S Halfdansgade København S CVR Side 15 af 30

16 2.2.2 Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca pr. måned, samt årlig genberegning med op til ca beskeder. Antallet for Kommunal Pension vil stige fra 0 til de angivne antal i løbet af transitionsfasen ifm. migreringen Specifikke forhold for tilslutning af system Sikkerheden mellem KY og Beskedfordeler er tokenbaseret, så de nødvendige rettigheder skal oprettes i det fælleskommunale støttesystem Adgangsstyring før idriftsættelsen. 2.3 Kontekst for KMD Social Pension Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. Det forvaltningsmæssige formål med integrationen er, at KMD Social Pension udstiller ændringer i oplysninger om helbredsprocent for en person. Oplysningerne kan herefter indgå i beregning af personens ydelser i Kommunernes Ydelsessystem Kapacitets- og servicekrav Integrationen har et forventet antal beskeder på ca pr. måned, samt årlig genberegning med op til ca beskeder. Antallet for KMD Social Pension vil falde i løbet af transitionsfasen ifm. migreringen til Kommunal Pension Specifikke forhold for tilslutning af system Sikkerheden mellem KMD Social Pension og Serviceplatformen er certifikatbaseret, så de nødvendige certifikater skal være klar og implementerede før idriftsættelsen af løsningen. KOMBIT A/S Halfdansgade København S CVR Side 16 af 30

17 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for Kommunernes Ydelsessystem Integrationen benyttes af fagsystemet til at modtage beskeder med en eller flere ændringer til en persons helbredsprocent fra Beskedfordeler. Fagsystemet benytter også integrationen til at vedligeholde et abonnement på Beskedfordeler. [Systematic Endpoints for denne integratoinspart benyttes ikke af Serviceplatformen. Implementering af dette er således ikke en del af opgaven for Systematic.] Overordnet forretningslogik Fagsystemet modtager beskeder om ændring i en given persons helbredsprocent fra Beskedfordeler: Fagsystemet modtager beskeder (push / pull) via EP_FS1 Fagsystemet opretter og vedligeholder et abonnement (værdiliste) på Beskedfordeler via EP_FS Oversigt over endpoints ID Navn EP_FS1 ModtagBesked EP_FS2 AdministrerVaerdiliste Beskrivelse af endpoint [EP_FS1] ModtagBesked Beskrivelsen af endpoint findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. Beskedfordeler udstiller beskeder fra Kommunal Pension og KMD Social Pension. Endpoint benyttes af fagsystemerne i forbindelse med ændringer i oplysninger om helbredsprocent Abonnementsvilkår Fagsystemerne / Serviceplatformen skal oprette abonnement på beskedtypen Social pension helbredsprocent hændelse. Fagsystemerne skal desuden oprette abonnement på Relateret Objekt: ObjektType = Person og ObjektID = CPR-nummer' samt vedligeholde værdiliste, som angive i afsnit [Afklaring/KDF afsnittet skal opdateres ift. generel beskrivelse for opsætning af abonnement] Dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [Afklaring/KDF oplysninger leveres af KMD] Outputdata [Afklaring/KDF oplysninger leveres af KMD] Dataspecifikationen for indholdet af selve beskedindholdet findes i følgende schema-filer: KOMBIT A/S Halfdansgade København S CVR Side 17 af 30

18 Miljø: Produktion og Test Inputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_B] Outputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_B] Se afsnit Fejl! Henvisningskilde ikke fundet. for en beskrivelse af indholdet i beskedkuvert og indhold Beskrivelse af endpoint [EP_FS2] AdministrerVaerdiliste Beskrivelsen af endpoint findes i Vedligehold værdiliste i beskedabonnement [SF1460_B]. Beskedfordeler udstiller administrationsinterface til vedligehold af værdilister i beskedabonnementer. Endpoint kaldes af fagsystemet i forbindelse med vedligehold af værdilister i beskedabonnement Værdiliste Fagsystemerne skal vedligeholde værdiliste for de personer, de ønsker at abonnere på. [Afklaring/KDF afsnittet skal opdateres ift. generel beskrivelse for håndtering af værdiliste] Service Management Beskrivelsen af Service Management findes i Modtag besked [SF1460_A], Modtag besked via pull [SF1460_D] og Vedligehold værdiliste i beskedabonnement [SF1460_B] 3.2 Specifikation af endpoints for Kommunal Pension og SP som afsendende beskedagent Integrationen benyttes af Kommunal Pension og i transitionsperioden af Serviceplatformen (på vegne af KMD Social Pension) til at sende en eller flere ændringer til en persons helbredsprocent til Beskedfordeler Overordnet forretningslogik Kommunal Pension og Serviceplatformen sender ændringen i en given persons helbredsprocent til en synkron service, som er udstillet af Beskedfordeler: Kommunal Pension / Serviceplatform kalder EP_PENS1 Beskedfordeler returnerer et synkront svar til afsender Oversigt over endpoints ID Navn EP_PENS1 AfsendBesked KOMBIT A/S Halfdansgade København S CVR Side 18 af 30

19 3.2.3 Beskrivelse af endpoint [EP_PENS1] AfsendBesked Beskrivelsen af endpoint findes i Aflever besked [SF1460_C]. Kommunal Pension / Serviceplatformen kalder Beskedfordeler med information om ændring af helbredsprocent. Endpoint kaldes ved ændring i informationer om helbredsprocent. I transitionsfasen vil Serviceplatformen kalde også endpointet ifm. modtagelse af ændringer til helbredsprocent fra KMD Social Pension (EP_KS1) Dataspecifikation En besked består af en kuvert og et beskedindhold Beskedkuverten dataspecifikation Dataspecifikationen for beskedkuverten findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [Afklaring/KDF oplysninger leveres af KMD] Outputdata [Afklaring/KDF oplysninger leveres af KMD] Beskedkuverten skal udfyldes, således at det er muligt at abonnere på ændringer. Værdier angivet med er faste værdier, der skal sættes ind i Beskedkuverten. Andre værdier skal afsendersystemet selv udfylde. [OBS! Struktur og indhold i beskedkuvert er ikke endeligt fastlagt. Afventer endelig leverance af specifikation for Beskedfordeler samt afklaring på bl.a. nedenstående. Nøgler generelt: Skal der defineres urn for dem eller bruges UUID som beskrevet nedenfor? TilladtModtager og ObjektAnsvarligMyndighed: Skal de angives med UUID eller urn:oio:cvr:xxxxxxx? Relateret Objekt: Skal der tilføjes en ObjektRolle? ObjektId: Er det en sag eller lignende? ObjektType: Hvilken objekttype er det? Er det f.eks. en sag? ObjektHandling: Hvad kaldes ændringen? Er den relateret til en handlingsfacet? OpgaveEmne: Er det rette kategori, eller skal det være Social Pension? ObjektEmne: Skal handlingsfacetten med? Skal den evt. angives i ObjektHandling?] Element Beskrivelse Værdifelt udfyldelse Filtreringsdata Beskedtype BeskedAnsvarligAktør Beskedtypen Social pension helbredsprocenthændelse Det it-system, der afsender beskeden [Afklaring/KDF indsæt UUID for beskedtypen Social pension helbredsprocenthændelse ] UUID for it-systemet KOMBIT A/S Halfdansgade København S CVR Side 19 af 30

20 TilladtModtager Borgerenes UUID for kommunen bopælskommune RelateretObjekt ObjektId CPR-nummer på borgeren urn:oio:cpr:xxxxxxxxxx x'er erstattes med CPR-nummer (uden ObjektType Objektregistrering ObjektRegistreringId UUID for det relaterede forretningsobjektet Person bindestreg) [Afklaring/KDF indsæt UUID for forretningsobjektet Person ] Hændelsen, der ligger til UUID for hændelsen grund for beskeden RegistreringsAktoer Det it-system, der har genereret hændelsen UUID for it-systemet eller for SP, hvis SP sender på vegne af KMD Social Pension Registreringstidspunkt Tidspunkt for hændelsens Tidspunktet [KDF/Afklaring indsæt format] udsendelse fra kilden ObjektAnsvarligMyndighed Borgerenes UUID for kommunen bopælskommune ObjektId Sagsnummeret UUID for sagens id ObjektType Forretningsobjektet UUID for Helbredsprocent Helbredsprocent ObjektHandling Handlingen Ændring i UUDI for Ændring i helbredsprocent helbredsprocent OpgaveEmne KLE-nummer for Helbredsprocent : urn:oio:kle:[afklaring/kdf indsæt KLEnummer her] Leveranceinformation Dannelsestidspunkt Sikkerhedsklassificering GyldighedFra Tidspunkt hvor beskeden opstod Klassificeringen Personfølsomt Tidspunk hvor hændelsen opstod Tidspunktet [KDF/Afklaring indsæt format] [Afklaring/KDF indsæt UUID for Personfølsomt ] Tidspunktet [KDF/Afklaring indsæt format] Beskedindhold dataspecifikation Dataspecifikationen for indholdet af selve beskeden findes i følgende schema-filer: Miljø: Produktion og Test Inputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_B] Outputdata [Udfyldes af Systematic senere indholdet svarer til XSD en for svaret i SF1411_B] Beskeddata består af informationer om social pension for en person. Svar Forklaring Link til digitaliser.dk KOMBIT A/S Halfdansgade København S CVR Side 20 af 30

21 Helbredsprocent En eller flere Perioder af: Start-dato Slut-dato Helbredsprocent, Værdisæt: % [Systematic udarbejder struktur med udgangspunk i e/ ] Service Management Beskrivelsen af Service Management findes i Aflever besked [SF1460_C]. 3.3 Specifikation af endpoints for KMD Social Pension Integrationen anvendes til at udstille information om ændringer til helbredsprocent for en given person. OBS! Denne snitflade er identisk med snitfladen mod KMD Social Pension i SF1411_D Overordnet forretningslogik KMD Social Pension udstiller ændringer i en given persons helbredsprocent via en MQ modtagerkø: Serviceplatform henter ændringer fra KMD Social Pension via EP_KS1 Serviceplatformen sletter ændringer på modtagerkøen KOMBIT A/S Halfdansgade København S CVR Side 21 af 30

22 3.3.2 Oversigt over endpoints ID Navn EP_KS1 UdstilAendringerKMD Beskrivelse af endpoint EP_KS1 UdstilAendringerKMD Transportspecifikation Integrationsmønster Der benyttes et asynkront integrationsmønster, hvor KMD Social Pension udstiller ændringer på en IBM Websphere MQ Serviceudstiller KMD Social Pension er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Servicen er implementeret som en IBM Websphere MQ Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø: Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP URI til Adgangsstyring URL til Administrationsmodul [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test URI til WSDL Endpoint navn Endpoint IP URI til Adgangsstyring URL til Administrationsmodul [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] [Afklaring/KDF oplysninger leveres af KMD] Teknisk retning for udveksling Serviceplatformen overvåger MQ fra KMD Social Pension og henter ændringer Dataretning for udveksling KMD Social Pension udleverer information om ændringer til helbredsprocent for en given person. KOMBIT A/S Halfdansgade København S CVR Side 22 af 30

23 Service invokation / Triggers Endpoint kaldes af Serviceplatformen i forbindelse Dataspecifikation Dataformat til MQ-køen følger beskrivelse af P12_1_Snitfladebeskrivelse_v008.pdf afsnit [P12-1]: Dataformat til MQ-køen er som følger: Karakterbaseret MQ-kommunikation, kommasepareret fil med semikolon separator. PERSONNUMMER, CHAR(10) TYPE, CHAR(12) START_DATO, CHAR(10) [ÅÅÅÅ-MM-DD] SLUT_DATO, CHAR(10) [ÅÅÅÅ-MM-DD] VÆRDI, CHAR(15) [Tal på tillægsprocent nul med komma og to faste decimaler Ingen fortegn=positiv værdi -Fortegn ='-' = negativ værdi] VAERDI_TXT, CHAR(12) [Kan indeholde både store og små bogstaver] Alle felter er trimmede, dvs. foranstillede blanke er fjernet. TYPE kan være FORMUE, SAMLIV, TILLÆG, TILSKUD. Der optræder altid flere registreringer for hvert (og samme) personnummer, idet ovennævnte typer (FORMUE, SAMLIV, TILLÆG og TILSKUD) altid samles i samme record i samme MQ-message. Da data for typerne (FORMUE, SAMLIV, TILLÆG og TILSKUD) endvidere er periodiseret, kan der forekomme flere perioder inden for samme type. I record en gentages Typenavnet for hver periode. VÆRDI for samlivstypen er irrelevant og derfor udfyldes med 0,00. For FORMUE-typen gælder derimod, at VÆRDI er udfyldt og i nogle også VÆRDI_TXT. Når der f.eks. i formuen står nul, skal systemet vide, at formuen er oplyst til nul. Dette angives ved VÆRDI = 0,00 og VÆRDI_TXT = OPLYST. For typerne TILLÆG og TILSKUD gælder, at kun VÆRDI anvendes, mens VÆRDI_TXT ikke udfyldes. Da data afsluttes med semikolon (;), og da VÆRDI_TXT ikke er udfyldt (feltet er trimmet til ingenting), men alligevel afsluttes med semikolon, optræder to semikolon efter hinanden (;;). Se P12_1_Snitfladebeskrivelse_v008 [P12-1] for yderligere forklaring af indholdet i MQ-messages Sikkerhed [Afklaring/KDF Sikkerhed på MQ skal afklares. Afventer svar fra KMD] KOMBIT A/S Halfdansgade København S CVR Side 23 af 30

24 Serviceplatformen er anvendersystem Leverancesikkerhed og fejlhåndtering Fejlhåndtering på MQ håndteres som beskrevet i [P12-1] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] [Afklaring/KDF indsæt servicemål for KMD MQ] Service Management Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationer?] Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF Integrationstest med KMD] Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. KOMBIT A/S Halfdansgade København S CVR Side 24 af 30

25 Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/KDF Produktionssætningstest med KMD] 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes af flere integrationsflow, som vil være beskrevet hver for sig i nærværende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen i transitionsfasen. I den endelige version udgår komponenterne KMD Social Pension og Serviceplatformen samt EP_KS1. Serviceplatformen Kommunernes Ydelsesssystem AMQP EP_FS1 WS EP_FS2 KMD Social pension EP_KS1 MQ IF01 AMQP EP_PENS1 Beskedfordeler EP_PENS1 AMQP Kommunal Pension KOMBIT A/S Halfdansgade København S CVR Side 25 af 30

26 4.1.1 Oversigt over integrationsflows ID Navn IF01 Afsend Besked Arbejdspakker Som beskrevet i afsnit 1.2, så skifter integrationsparterne i løbet af snitfladens levetid. Derfor skal estimatet af løsningen udarbejdes en arbejdspakke: Arbejdspakke SF1411_E1: Integration mellem Serviceplatform og KMD Social Pension samt Beskedfordeler. Denne del skal kunne fjernes igen, når transitionen er gennemført Integrationsflow IF01: Afsend besked Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_PENS1 AfsendBesked EP_KS1 UdstilAendringKMD Integrationstype Integrationen er en orkestreringsintegration med transformation, hvor Serviceplatform agerer som beskedagent Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KMD Social Pension Kommunal Pension Serviceplatformen Beskedfordeler hent ændringer fra kø Transformer Persisteer Besked Fjern ændringer fra kø Persister Besked KOMBIT A/S Halfdansgade København S CVR Side 26 af 30

27 Datatransformering I transitionsfasen skal data, der modtages fra KMD Social Pension via EP_KS1, tranformeres til en besked, der kan sendes via EP_PENS1. Det er kun de data, der indgår i snitfladen udstillet af KMD Social Pension, der skal sendes i beskeden. Serviceplatformen skal udfylde beskedkuverten, og den record, som modtages med formatet specificeret i EP_KS1 (afsnit Fejl! Henvisningskilde ikke fundet.), skal mappes over i en besked som specificeret i beskrivelsen af beskedindhold i EP_PENS1 (afsnit ). Det er kun ændringer, hvor TYPE har værdien TILSKUD, der skal behandles i denne integration (ændringer, hvor TYPE har værdien TILLÆG, FORMUE eller SAMLIV, behandles i [SF1411_D]). OBS! Der kan godt være forskellige typer af ændringer i samme record. Serviceplatformen skal udfylde manglende oplysninger, som angivet i [SP indsæt ] samt indsætte indholdet angivet i i beskedkuvert for snitflade EP_PENS1, som beskrevet i nedenstående tabel: [OBS! Struktur og indhold i beskedkuvert er ikke endeligt fastlagt. Afventer endelig leverance af specifikation for Beskedfordeler samt afklaring på bl.a. nedenstående. Nøgler generelt: Skal der defineres urn for dem eller bruges UUID som beskrevet nedenfor? TilladtModtager og ObjektAnsvarligMyndighed: Skal de angives med UUID eller urn:oio:cvr:xxxxxxx? Relateret Objekt: Skal der tilføjes en ObjektRolle? ObjektId: Er det en sag eller lignende? ObjektType: Hvilken objekttype er det? Er det f.eks. en sag? ObjektHandling: Hvad kaldes ændringen? Er den relateret til en handlingsfacet? OpgaveEmne: Er det rette kategori, eller skal det være Social Pension? ObjektEmne: Skal handlingsfacetten med? Skal den evt. angives i ObjektHandling?] Element Beskrivelse værdifelt SP udfyldelse af værdifelt Filtreringsdata Beskedtype BeskedAnsvarligAktør TilladtModtager RelateretObjekt ObjektId UUID for beskedtypen Social pension helbredsprocenthændelse UUID for det it-system, der afsender beskeden UUID for borgerenes bopælskommune CPR-nummer på borgeren: urn:oio:cpr:xxxxxxxxxx [Afklaring/KDF indsæt UUID for beskedtypen Social pension helbredsprocenthændelse ] [Afklaring/KDF indsæt UUID for aktøren Serviceplatformen ] [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje kommune id i record] urn:oio:cpr:[sp indsæt PERSONNUMMER fra MQ-record (uden bindestreg)] KOMBIT A/S Halfdansgade København S CVR Side 27 af 30

28 ObjektType Objektregistrering ObjektRegistreringId RegistreringsAktoer Registreringstidspunkt ObjektAnsvarligMyndighed UUID for det relaterede forretningsobjektet Person UUID for hændelsen, der ligger til grund for beskeden UUID for det it-system, der har genereret hændelsen Tidspunkt for hændelsens udsendelse fra kilden [KDF/Afklaring indsæt format] UUID for borgerenes bopælskommune [Afklaring/KDF indsæt UUID for forretningsobjektet Person ] [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record [Afklaring/KDF KMD skal tilføje hændelsesid i record] [Afklaring/KDF indsæt UUID for SP ] [SP indsæt modtagelsestidspunkt fra MQkø] [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje kommune id i record] ObjektId UUID / URN? [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje sagsid i record] ObjektType ObjektHandling OpgaveEmne Leveranceinformation Dannelsestidspunkt Sikkerhedsklassificering GyldighedFra UUID for forretningsobjektet [Afklaring/KDF indsæt UUID for Helbredsprocent??? Helbredsprocent??? ] UUID for handlingen [Afklaring/KDF indsæt UUID for Ændring Ændring i helbredsprocent i helbredsprocent??? ]??? KLE-nummer for Helbredsprocent : urn:oio:kle:nn.nn.nn + handlingsfacet Tidspunkt hvor beskeden opstod [KDF/Afklaring indsæt format] UUID for klassificeringen Personfølsomt Tidspunk hvor hændelsen opstod [KDF/Afklaring indsæt format] urn:oio:kle:[afklaring/kdf indsæt KLEnummer her] [SP indsæt tidspunkt for dannelse af beskeden på SP] [Afklaring/KDF indsæt UUID for Personfølsomt ] [SP indsæt [Afklaring/KDF indsæt felt] fra MQ-record] [Afklaring/KDF KMD skal tilføje tidspunkt for hændelsen i record] Mapningen fra indhold fra MQ-record i snitflade EP_KS1 til beskeddata i snitflade EP_PENS1 følger nedenstående tabel: Element Beskrivelse felt SP udfyldelse af felt KOMBIT A/S Halfdansgade København S CVR Side 28 af 30

29 XSD-struktur: Helbredsprocent Felt: start-dato Dato for periodens starttidspunkt [KDF/Afklaring indsæt format] Felt: slut-dato Dato for periodens sluttidspunkt [KDF/Afklaring indsæt format] Felt: Helbredsprocent, Den udregnede procentsats Værdisæt [SP indsæt START_DATO fra MQ-record] [SP indsæt SLUT_DATO fra MQ-record] [SP indsæt VÆRDI fra MQ-record] Datapersistering Serviceplatformen skal persistere data modtaget via EP_KS1 indtil de er blevet videresendt til Beskedfordeler via EP_PENS Databerigelse N/A Routing N/A Orkestrering Serviceplatformen skal orkestrere modtagelse af message fra MQ-køen, transformere message, udfylde beskedkuvert og indhold, persistere besked, sende besked til Beskedfordeler, og slette den persisterede besked og data på MQ-køen, når beskeden er bekræftet modtaget af Beskedfordeler Sikkerhed [Afklaring/KDF afklaring om sikkerhed er i gang. Der antages følgende: I transitionsfasen vil sikkerhedsopsætningen være som beskrevet i UC-SEC-09 [SIKKERHED]. EP_KS1 autentikeres og autoriseres via certifikater. Serviceplatformen skal således tilgå KMD Social Pension med et certifikat, som beskrevet i vedlagte bilag P12_1_Snitfladebeskrivelse_v008.pdf [P12-1].] EP_PENS1 benytter Beskedfordeler som beskrevet i [SF1460_C], og er således udstillet som en fælleskommunal service, hvor Serviceplatformen er anvendersystem i det fælleskommunale støttesystem Adgangsstyring Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen. KOMBIT A/S Halfdansgade København S CVR Side 29 af 30

30 Testdata og testfaciliter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration Ingen Supplerende information Ingen. KOMBIT A/S Halfdansgade København S CVR Side 30 af 30