Integration SF1320_A - CPR - Hændelser Integrationsbeskrivelse - version 2.0.2

Transkript

1 Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer PBO 0.1 Første version kopieret fra gammel skabelon PBO 0.2 Opdateret til fase PBO 0.3 Opdateret til fase EHE 0.5 Klargjort til SP EDM Forkert systemnavn i integrationsflow 4.1 rettet til CPR EDM Generelle ændringer omkring Beskedfordeler. Afsnit 1.5 Forudsætninger, afsnit ModtageBesked, afsnit 3.3 Serviceplatformen som Beskedagent og Beskrivelse af Beskedkuvert. Interne referencer opdateret EDM CPR udtræksformat betegnelse ændret fra GCTP til CPRRECTYP i afsnit EDM Opdateret Beskedfordeler-regler i referencer og afsnit og Regler er placeret i bilag [SF1320_A_EXT] sammen CPR hændelseskoder. Referencer Ref Titel Kommentarer [SPref] [BFref] [SIKKERHED] [STS-Sikkerhed] [SFTP] [VBF] Bilag 7B Ydelser og servicemål for Serviceplatformen [Afklaring/KDF indsæt reference dokumentation af servicemål for BF] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link USM0005 Vejledning til Serviceplatformens SFTP Service.pdf Se vilkår Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler version 2.0 på nedenstående link Endnu ikke udarbejdet Vejledning med xsd. [SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeler KOMBIT A/S Halfdansgade København S CVR Side 2 af 32

3 [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeler [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeler [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeler [WSDL-SP] [WSDL-EXT] [SF1320_EXT] Integrationsbeskrivelsen refererer til SF1320_A Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link Integrationsbeskrivelsen refererer til SF1320_A Bilag zip som indeholder WSDL/WADL/XSD af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link Bilag til integrationsbeskrivelsen, som benyttes til forståelse af CPR hændelser og mapning til Beskedfordeler. Ligger under mappen regler i [WSDL-EXT]. Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning Kontekst for integrationsparter Kontekst for KY Kontekst for KSD Kontekst for SAPA Kontekst for CPR Specifikation for integrationsparter Specifikation af endpoints for fagsystem KY, KSD, SAPA Specifikation af endpoints for CPR Specifikation af endpoints for Serviceplatformen som afsendende beskedagent Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 32

4 KOMBIT A/S Halfdansgade København S CVR Side 4 af 32

5 1 Overordnet beskrivelse 1.1 Integrationens formål Integrationen har til formål at tilvejebringe og videresende relevante personhændelser på CPR-området for fagsystemer, der benyttes af offentlige myndigheder via det fælleskommunale støttesystem Beskedfordeler (Beskedfordeler). Dette vil gøre fagsystemer i stand til at kunne reagere på personhændelser ift. de myndighedssager og arbejdsgange i forbindelse med forvaltningsvirksomhed som fagsystemet it-understøtter. Integrationen leverer kun hændelser fra CPR registret og således ikke personhændelser fra fx udlændingeområdet. 1.2 Overordnet forretningsflow i integrationen Det overordnede flow for integrationen er som følger. Serviceplatformen henter personhændelser fra CPR-registeret dagligt. Herefter analyseres data for at afgøre hvilke forretningsmæssige personhændelser, som har fundet sted. Til sidst afleveres data til Beskedfordeler med en besked per hændelse. Fagsystemer skal oprette et abonnement i Beskedfordeler med angivelse af filtre på kuvertens metadata, herunder relevante personhændelser, personnumre eller adresser. Fagsystemets adgang til typer af personhændelser fra Beskedfordeler skal opsættes i det fælleskommunale støttesystem Adgangsstyring. Fagsystemet vil således kun kunne modtage personhændelser fra Beskedfordeler på angivne beskedtyper og som er indeholdt i fagsystemets abonnement. Integrationen er en gennemstillingsintegration med content based routing og transformation, som integrerer til Beskedfordeler. KOMBIT A/S Halfdansgade København S CVR Side 5 af 32

6 Nedenfor er illustreret flowet i integrationen: Modtag personhændelse Serviceplatformen Fagsystem (n) CPR Beskedfordeler Modtag Besked Modtag Besked Hent data Udstil Persondata Distribuer besked til dueslag Dan forretningshændelser Udstil besked Opdater lokalt repository Send Besked Dan udtræk Periodisk CPR genererer hver nat et udtræk til Serviceplatformen på alle recordtyper, der er ændret i CPRregisteret siden sidste udtræk, og Serviceplatformen kan derfor modtage alle personhændelser for alle personer i CPR. Serviceplatformen henter udtrækket og udregner for hver personhændelse en eller flere forretningshændelser, som beskriver hvilken ændring, der har fundet sted. Derefter opdateres det lokale CPR-repository, og endelig sendes beskederne til Beskedfordeler. Beskedfordeler modtager beskederne og udregner hvilke abonnementer, som skal modtage beskeden og distribuerer herefter beskeder til de korrekte dueslag. Fagsystemerne kan selv opsætte og administrere deres dueslag. Fagsystemet modtager beskeden og behandler den efter egne forretningsregler jf. snitflade SF1460_A/SF1460_D. Denne snitflade omhandler kun Serviceplatformens modtagelse af personhændelser og afsendelse af forretningshændelser vedr. person (Part) Ændringer til den eksisterende snitflade for CPR Abonnement Serviceplatformen skal implementere flowet beskrevet i punkt 1.2 herunder: KOMBIT A/S Halfdansgade København S CVR Side 6 af 32

7 Serviceplatformen skal benytte det eksisterende ændringsudtræk fra CPR. Serviceplatformen skal udarbejde en komponent til at generere forretningshændelser for personhændelser jf. punkt Serviceplatformen skal benytte den eksisterende funktionalitet til at opdatere det lokale repository. Serviceplatformen skal udarbejde en integration til Beskedfordeler, herunder skal Serviceplatformen oprettes som et afsendersystem til Beskedfordeler i det fælleskommunale støttesystem Adgangsstyring. Systematic skal udarbejde et XSD over indholdet af Personbeskeder som afsendes. XSD skal godkendes af KOMBIT Service Management Incident Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Problem Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Change Management Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Liste over forretningshændelser Ud fra de modtagne personhændelser genereres forretningshændelser i Serviceplatformen som beskrevet i nedenstående tabel. Tabellen har følgende kolonner, som definerer de forretningshændelser, som sendes som beskeder til fagsystemerne: Hændelse ID, Serviceplatformens brugervendte ID på hændelsen. Hændelse Navn, Navnet på hændelsen. Hændelse ID Hændelse navn CPR-001 CPR-002 CPR-003 CPR-004 CPR-005 Ændring af registrering (sendes for alle ændringer) Fødsel Navngivning Navneændring Dødsfald KOMBIT A/S Halfdansgade København S CVR Side 7 af 32

8 Hændelse ID Hændelse navn CPR-006 CPR-007 CPR-008 CPR-009 CPR-010 CPR-011 CPR-012 CPR-013 CPR-014 CPR-015 CPR-016 CPR-017 CPR-018 CPR-019 CPR-020 CPR-021 CPR-022 CPR-023 CPR-024 CPR-025 CPR-026 CPR-027 CPR-028 CPR-029 Dødsfald - som forsvundet Dødsfald - som udvandret Dødsfald som nyfødt Dødsfald ægtefælle Forsvinding Genfinding Indvandring Udvandring Genindvandring Nynummerering Omnummerering nyt nummer Sletning af personnummer Tidligere dobbelt nummer Udgår grundet omnummerering Myndiggørelse Umyndiggørelse Folkekirketilknytning ændret Statsborgerskab ændret Faderskab far Fødsel mor Faderskab barn Adoption barn Vielse Separation startet KOMBIT A/S Halfdansgade København S CVR Side 8 af 32

9 Hændelse ID Hændelse navn CPR-030 CPR-031 CPR-032 CPR-033 CPR-034 CPR-035 CPR-036 CPR-037 CPR-038 CPR-039 CPR-040 CPR-041 Separation ophørt Skilsmisse Ændring vedrørende ægtefælle Ændring vedrørende slægtskab Flytning til kommunen Flytning fra kommunen Fraflytning inden for kommunen Tilflytning inden for kommunen Indkaldelse til militæret Hjemsendelse fra militæret Start afsoning Slut afsoning Regelsættet er beskrevet i [SF1320-EXT], og definerer hvorledes hændelser fra CPR omdannes til CPR-beskeder i Beskedfordeler. KOMBIT A/S Halfdansgade København S CVR Side 9 af 32

10 1.3 Servicebetingelser for den samlede integration Servicemål For Serviceplatformen gælder på punkterne tidsrum, svartid, tilgængelighed og servicevindue de generelle betingelser fra driftsaftale for Serviceplatformen. Se [SPref]. Parameter Tidsrum CPR Hændelser Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Beskedfordeler driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [BFref]. CPR driftsafvikles hele døgnet alle dage bortset fra, når der udføres ændringer/hvor der er servicevinduer Se vk50_offentlige_vilkaar.pdf [WSDL_EXT]. Svartid Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Svartid for Beskedfordeler er beskrevet i [BFref]. CPR driftsafvikles hele døgnet alle dage bortset fra, når der udføres ændringer/hvor der er servicevinduer Se vk50_offentlige_vilkaar.pdf [WSDL_EXT]. Tilgængelighed Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Tilgængelighed for Beskedfordeler er beskrevet i [BFref]. CPR driftsafvikles hele døgnet alle dage bortset fra, når der udføres ændringer/hvor der er servicevinduer Se vk50_offentlige_vilkaar.pdf [WSDL_EXT]. Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. KOMBIT A/S Halfdansgade København S CVR Side 10 af 32

11 Spidsbelastning for Beskedfordeler er beskrevet i [BFref]. CPR driftsafvikles hele døgnet alle dage bortset fra, når der udføres ændringer/hvor der er servicevinduer Se vk50_offentlige_vilkaar.pdf [WSDL_EXT]. Servicevinduer Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref]. Servicevinduer for Beskedfordeler er beskrevet i [BFref]. CPR driftsafvikles hele døgnet alle dage bortset fra, når der udføres ændringer/hvor der er servicevinduer Se vk50_offentlige_vilkaar.pdf [WSDL_EXT] Service Management Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til datafaellesskab@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere Incident Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] KOMBIT A/S Halfdansgade København S CVR Side 11 af 32

12 Problem Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] Change Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer der anvender forskellige integrationsplatforme, eller afgøres det pr. integration] Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] 1.4 Teststrategi Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 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 unit tests. 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 unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Test i forbindelse med produktionssætning I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der gennemføres følgende 3 prøver: Overtagelsesprøve Idriftsættelsesprøve Driftsprøve KOMBIT A/S Halfdansgade København S CVR Side 12 af 32

13 Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.5 Forudsætninger for produktionssætning Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. [Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] Funktionalitet på Serviceplatformen Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. De nødvendige beskedtyper og opsætninger skal være oprettet i Beskedfordeler, så systemet kan sende de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [VBF]. Leverandøren skal være oprettet som tilslutningspart på SF1460_C. Serviceplatformen skal have et opdateret lokalt replika for CPR for alle personer ved idriftsættelse Forudsætninger for tilslutning til integrationspart: CPR KOMBIT har indgået aftale med CPR på vegne af kommunerne. CPR beskriver tilslutningskravene i vk50_offentlige_vilkaar.pdf [WSDL_EXT] Forudsætninger for tilslutning til integrationspart: Fagsystemet De nødvendige abonnementer og opsætninger skal være oprettet i Beskedfordeler, så systemet kan modtage de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [STS-Sikkerhed]. Leverandøren skal være oprettet som tilslutningspart på SF1460_A/SF1460_D og SF1460_B. KOMBIT A/S Halfdansgade København S CVR Side 13 af 32

14 2 Kontekst for integrationsparter SF1320_A indeholder følgende integrationsparter: Kommunernes Ydelsessystem, der modtager information om personhændelser via Beskedfordeler. Kommunernes Sygedagpengesystem, der modtager information om personhændelser via Beskedfordeler. SAPA, der modtager information om personhændelser via Beskedfordeler. CPR som leverer ændringsudtræk for persondata, som anvendes af Serviceplatformen 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Som beskrevet i punkt 1.1 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 Kapacitets- og servicekrav KY har berørte personer om året (2012 tal). KOMBIT har estimeret at der vil være ca CPR ændringer til disse personer per år, ud fra tal fra Danmarks statistik om flytninger, fødsler, dødsfald, vielser og skilsmisser. Dvs. ca opdateringer om måneden Specifikke forhold for tilslutning af system Det skal bemærkes at beskedfordeleren modtager beskeder for samtlige kommuner. Derfor skal KY enten kun abonnere på beskeder for relevante kommuner, eller ignorere meddelelser for kommuner der ikke er aktive i KY. 2.2 Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål Som beskrevet i punkt 1.1. 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 KOMBIT A/S Halfdansgade København S CVR Side 14 af 32

15 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 Kapacitets- og servicekrav Det er estimeret at der maksimalt vil være ændringer per måned. Hver ændring kan godt medføre udsendelse af flere beskeder Specifikke forhold for tilslutning af system For hver idriftsættelse af KSD (udrulning sker pr. kommune), vil der blive tegnet abonnement på alle parter i sager i den kommune hvor KSD tages i drift. 2.3 Kontekst for SAPA Lovhjemmel og forvaltningsmæssigt formål Som beskrevet i punkt 1.1. 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 Kapacitets- og servicekrav Alle kommuner som benytter SAPA vil udtrykkes som et geografisk abonnement, det forventes at SAPA rulles ud i bølger til kommunerne. SAPA forventes at modtage personhændelser på alle borgere i de kommuner som benytter SAPA. Det vil sige op til cirka 5000 ændringer om dagen. Dette svarer ca. til alle hændelser der genereres på Serviceplatformen Specifikke forhold for tilslutning af system Det skal bemærkes at beskedfordeleren modtager beskeder for samtlige kommuner. Derfor skal SAPA enten kun abonnere på beskeder for relevante kommuner, eller ignorere meddelelser for kommuner der ikke er aktive i SAPA. 2.4 Kontekst for CPR Lovhjemmel og forvaltningsmæssigt formål Som beskrevet i punkt 1.1. KOMBIT A/S Halfdansgade København S CVR Side 15 af 32

16 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 Kapacitets- og servicekrav CPR udstiller cirka 5000 ændringer om dagen Specifikke forhold for tilslutning af system Udtrækket leveres på CPR ftp platform og hentes via sftp af Serviceplatformen som beskrevet i KOMBIT A/S Halfdansgade København S CVR Side 16 af 32

17 3 Specifikation for integrationsparter SF1320_A indeholder følgende integrationsparter: Kommunernes Ydelsessystem, der modtager information om personhændelser via Beskedfordeler. Kommunernes Ydelsessystem beskrives i afsnit 3.1. Kommunernes Sygedagpengesystem, der modtager information om personhændelser via Beskedfordeler. Kommunernes Sygedagpengesystem beskrives i afsnit 3.1. SAPA, der modtager information om personhændelser via Beskedfordeler. SAPA beskrives i afsnit 3.1. CPR som leverer ændringsudtræk for persondata, som anvendes af Serviceplatformen. CPR beskrives i afsnit 3.2. Integrationen mellem Serviceplatformen og Beskedfordeler beskrives i afsnit 3.3. Sammenhængen mellem endpoints er illustreret i afsnit Specifikation af endpoints for fagsystem KY, KSD, SAPA Integrationen benyttes af fagsystemet til at modtage beskeder med ændringer i personoplysninger fra Beskedfordeler. Fagsystemet benytter også integrationen til at vedligeholde værdilister på Beskedfordeler Overordnet forretningslogik Fagsystemet modtager beskeder om ændringer i personoplysninger 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 EP_FS2 ModtagBesked (ændringer til personoplysninger) [SF1460_A/SF1460_D] AdministrerVaerdiliste [SF1460_B] Beskrivelse af endpoint EP_FS1 ModtagBesked Beskrivelsen af endpoint findes i Modtag besked [SF1460_A] og Modtag besked via pull [SF1460_D]. Fagsystemet vælger selv om der benyttes pull eller push. Beskedfordeler udstiller beskeder fra CPR. Endpoint benyttes af fagsystemerne i forbindelse med ændringer i personoplysninger Abonnementsvilkår Fagsystemet skal oprette abonnement på beskedtypen CPRopdatering. KOMBIT A/S Halfdansgade København S CVR Side 17 af 32

18 Beskedernes objekt er Person identificeret med CPR-nummer. Beskeden kan indeholde 7 relaterede objekter i denne orden: 0) CPR hændelseskode (urn 3 karakterer) 1) Mor (CPR-nr) 2) Far (CPR-nr) 3) Ægtefælle eller tidl. Ægtefælle (CPR-nr) 4) Barn (CPR-nr) 5) Gammelt CPR eller dobbelt (CPR-nr) 6) Adresse (urn) Hvor det er muligt at udvælge det man ønsker i abonnementet. Adresse-urn er defineret som urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa;aaaa, hvilket er KOMKOD, VEJKOD, HUSNR, ETAGE,SIDEDOER og BNR fra CPR-udtræksformat record 3. Dette vil give en entydig adresse i urn en. Hvis man kun ønsker at få CPRopdateringer på de personer, som er tilknyttet fagsystemet, skal fagsystemet vedligeholde en værdiliste med personkreds, som navngives Personkreds. Værdilisten vedligeholdes som angive i afsnit Fejl! Henvisningskilde ikke fundet.. Tilsvarende kan fagsystemet tilknytte en adresseobservationsliste, hvor man vedligeholder en liste med adresse-urn er for de adresse som man ønsker at modtage CPRopdateringer på, kaldet Adresser. Eksempler på abonnementsudtryk: Giv alle beskeder, hvor personer er i værdilisten Personkreds : Forretningsobjektets type er Person, der har et UUID fa-edeb-40c bb7de17a7b. Personkreds er vedligeholdt i en liste med navnet Personkreds. Match udtrykket bliver da: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].Obj ekttype = fa-edeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].Obje ktid Giv alle beskeder, hvor relaterede personer er i værdilisten Personkreds : Forretningsobjektets type er Person, der har et UUID fa-edeb-40c bb7de17a7b. Personkreds er vedligeholdt i en liste med navnet Personkreds. Match udtrykket bliver da: KOMBIT A/S Halfdansgade København S CVR Side 18 af 32

19 (((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[1].Objek ttype = fa-edeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[1].ObjektI d OR ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[2].Objekt Type = fa-edeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[2].ObjektI d ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[3].Objekt Type = fa-edeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[3].ObjektI d ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[4].Objekt Type = fa-edeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[4].ObjektI d ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[5].Objekt Type = fa-edeb-40c bb7de17a7b ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[5].ObjektI d Giv alle beskeder, hvor relaterede adresser er i værdilisten Adresser : Forretningsobjektets type er Adresse, der har et UUID <Indsæt UUID for Adresse >. Adresselisten er vedligeholdt i en liste med navnet Adresser. Match udtrykket bliver da: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[6].Objekt Type = <Indsæt UUID for Adresse > ) AND (Haendelsesbesked.Beskedkuvert.Filtreringsdata.RelateretObjekt[6].ObjektI d Giv alle beskeder, hvor beskedhandling er Fødsel : Forretningsobjektets handling er Fødsel, der har et UUID <Indsæt UUID for Fødsel >. Match udtrykket bliver da: ((Haendelsesbesked.Beskedkuvert.Filtreringsdata.ObjektRegistrering[0].Obj ekthandling = <Indsæt UUID for Fødsel > )) Dataspecifikation For beskedtyper og beskedindhold se beskrivelse i afsnit KOMBIT A/S Halfdansgade København S CVR Side 19 af 32

20 3.1.4 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 fagsystemerne i forbindelse med vedligehold af værdilister i beskedabonnement. Kapitel 3.x.y.z Værdiliste Fagsystemerne skal vedligeholde værdilister for de personkredse og adresselister, det ønsker at abonnere på. Værdilisterne skal oprettes med følgende navn: Personkreds Personkreds Adresseliste Adresser 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 CPR Serviceplatformen modtager dagligt en liste af personændringer fra CPR Overordnet forretningslogik Hvert døgn udstiller CPR ændringer i personoplysninger, udtrækket udstiller alle ændringer og returnerer alle rækker. Serviceplatformen modtager således en fuld kopi af personens nuværende oplysninger fra CPR ved hver ændring. Serviceplatformen henter ændringerne fra CPR ftp service (EP_CPR1) og Serviceplatformen opdaterer det lokale cpr replika og udsender beskeder om ændringer i det fælleskommunale støttesystem Beskedfordeler Oversigt over endpoints ID Navn EP_CPR1 Modtag ændrede persondata fra CPR. EP_CPR1 svarer til den eksisterende integration mellem Serviceplatformen og CPR. KOMBIT A/S Halfdansgade København S CVR Side 20 af 32

21 3.2.3 Beskrivelse af endpoint EP_CPR Transportspecifikation Integrationsmønster Integration til CPR fra Serviceplatformen via filoverførsel Serviceudstiller CPR er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse CPR Snitfladen er implementeret som en filoverførsel. CPR giver mulighed for sikkerhedsopsætning via SFTP eller FTPS: I denne integration anvendes SFTP. Se flere detaljer på: Teknisk endpoint Miljø: Produktion URI til WSDL [Besvares senere af Systematic] Endpoint navn Endpoint IP Miljø: Præproduktion URI til WSDL [Besvares senere af Systematic] Endpoint navn Endpoint IP Teknisk retning for udveksling Serviceplatformen henter ændringsudtræk hos CPR Dataretning for udveksling CPR udstiller ændringer til Serviceplatformen Service invokation / Triggers Kommunikation initieres af at Serviceplatformen en gang i døgnet. KOMBIT A/S Halfdansgade København S CVR Side 21 af 32

22 Dataspecifikation Dataformatet er baseret på U12170-p, der modtages alle recordtyper. Udtrækket er identisk med den eksisterende integration til CPR abonnement. Se Sikkerhed Sikkerhed er baseret på SFTP Leverancesikkerhed og fejlhåndtering Serviceplatformen skal hente alle ændringer til personnumre, samt håndtere fejl som er angivet i recordtype 910 i udtrækket Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] Tilgængelighed [Udfyldes med krav til oppetid inden for aftalt driftstid fx 99,5 pct.] Spidsbelastningsperiode Servicevinduer [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Service Management Incident Management [Indhold afventer generel afklaring af governancestrukturer.] Problem Management [Indhold afventer generel afklaring af governancestrukturer.] Change Management [Indhold afventer generel afklaring af governancestrukturer.] KOMBIT A/S Halfdansgade København S CVR Side 22 af 32

23 3.2.5 Testplan Integrationstest [Indhold afventer generel afklaring af test] Produktionssætningstest [Indhold afventer generel afklaring af test] 3.3 Specifikation af endpoints for Serviceplatformen som afsendende beskedagent Integrationen benyttes af Serviceplatformen til at sende CPRopdateringsbeskeder til Beskedfordeler Overordnet forretningslogik Serviceplatformen beregner og sender CPRopdateringsbeskeder til Beskedfordeler: Serviceplatformen kalder EP_SP1 Beskedfordeler returnerer et synkront svar til afsender Oversigt over endpoints ID Navn EP_SP1 AfsendBesked Beskrivelse af endpoint EP_SP1 AfsendBesked Beskrivelsen af endpoint findes i Aflever besked [SF1460_C]. Serviceplatformen sender CPRopdateringsbeskeder. Endpoint kaldes ved ændring i CPR 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 Se [SF1460_C] Outputdata Se [SF1460_C] Beskedkuverten udfyldes som beskrevet i afsnit KOMBIT A/S Halfdansgade København S CVR Side 23 af 32

24 Beskedindhold dataspecifikation Dataspecifikationen for indholdet af selve beskeden findes i følgende schema-filer: Miljø: Produktion og Test Inputdata Se [SF1520] Outputdata Service Management Beskrivelsen af Service Management findes i Aflever besked [SF1460_C]. KOMBIT A/S Halfdansgade København S CVR Side 24 af 32

25 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparterne. Snitfladerne er defineret således i forhold til forretningsflowet. 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. Serviceplatformen CPR EP_CPR1 IF01 SF1460_C EP_SP1 Beskedfordeler SF1460_A/D EP_FS1 SF1460_B EP_FS2 Fagsystem(n) Oversigt over integrationsflows ID Navn IF01 Hent og Distribuer CPR Hændelser Integrationsflow [IF01]: Hent CPR Hændelser Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_CPR1 Snitflade til at afhente personhændelser. Afsnit KOMBIT A/S Halfdansgade København S CVR Side 25 af 32

26 EP_SP1 Snitflade til aflevere beskeder om personhændelser. Afsnit Fejl! Henvisningskilde ikke fundet Integrationstype Integrationen er en beskedagentintegration med transformation. Forretningsbeskeder udsendes via det fælleskommunale støttesystem Beskedfordeler [SF1460_C] Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem(n) Beskedfordeler Serviceplatformen CPR Hent CPR Udtræk EP_CPR1 Gentag indtil alt sendt Datatransformering Data skal transformeres fra CPR s CPRRECTYP format til xsd format i beskeder som afsendes via det fælleskommunale støttesystem Beskedfordeler. 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. [De fleste Id er er baseret på UUID dog med undtagelse af: KLE - urn:oio:kle:nn.nn.nn CPR - urn:oio.cpr:nnnnnnnnnn CVR - urn:oio:cvr:nnnnnnnn PNR urn:oio:pnr:nnnnnnnnnn Fuldtnavn - urn:oio:fuldtnavn:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Adresse - urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa;aaaa KOMBIT A/S Halfdansgade København S CVR Side 26 af 32

27 da disse ikke repræsenteret af et UUID og derfor skal benytte urn.] [Afklaring/KDF: Endelig definition af urn] Element Beskrivelse Værdifelt udfyldelse Filtreringsdata Beskedtype CPRopdatering [Afklaring/KDF: UUID for beskedtypen CPRopdatering ] BeskedAnsvarligAktør Det it-system, der afsender beskeden, er CPR [Afklaring/KDF: UUID for it-systemet CPR] TilladtModtager Borgerenes bopælskommune Se mapning i [SF1320_A-EXT] RelateretObjekt[0] Mor ObjektId CPR-nummer på Mor urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg) Se mapning i [SF1320_A-EXT] ObjektType Forretningsobjektet Person [Afklaring/KDF: UUID for forretningsobjektet Person ] ObjektRolle RelateretObjekt[1] Far ObjektId CPR-nummer på Far urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg) Se mapning i [SF1320_A-EXT] ObjektType Forretningsobjektet Person [Afklaring/KDF: UUID for forretningsobjektet Person ] ObjektRolle RelateretObjekt[2] Ægtefælle (evt. tidligere) KOMBIT A/S Halfdansgade København S CVR Side 27 af 32

28 ObjektId CPR-nummer på ægtefælle urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg) Se mapning i [SF1320_A-EXT] ObjektType Forretningsobjektet Person [Afklaring/KDF: UUID for forretningsobjektet Person ] ObjektRolle RelateretObjekt[3] Barn ObjektId CPR-nummer på barn urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg) Se mapning i [SF1320_A-EXT] ObjektType Forretningsobjektet Person [Afklaring/KDF: UUID for forretningsobjektet Person ] ObjektRolle RelateretObjekt[4] ObjektId Gammelt/Dobbelt CPR Gammelt CPR-nummer på borgeren urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg) Se mapning i [SF1320_A-EXT] ObjektType Forretningsobjektet Person [Afklaring/KDF: UUID for forretningsobjektet Person ] ObjektRolle RelateretObjekt[5] Adresse ObjektId Adresse [Afklaring/KDF: urn:oio:adresse:nnnn;nnnn,aaaa;aa;aaaa; aaaa ] Se mapning i [SF1320_A-EXT] KOMBIT A/S Halfdansgade København S CVR Side 28 af 32

29 ObjektType Forretningsobjektet Adresse [Afklaring/KDF: Indsæt UUID for forretningsobjektet Adresse ] ObjektRolle Objektregistrering ObjektRegistreringId RegistreringsAktoer Registreringstidspunkt ObjektAnsvarligMyndighed Identifikation af hændelsen, der ligger til grund for beskeden. Det it-system, der har genereret hændelsen, er SP Tidspunkt for hændelsens udsendelse fra kilden Borgerenes bopælskommune (CVR) [Afklaring/KDF: urn:kombit:cpr-transid:nnnnnn-nnnnnn for CPR udtræk id record 000 OPGAVENR-PRODDTO] [Afklaring/KDF: UUID for SP] SP s tid i DateTime format urn:oio:cvr:nnnnnnnn (hvor nnnnnnnn er et 8-cifret CVR nummer). Se mapning i [SF1320_A-EXT] ObjektId Borgerens CPR-nummer urn:oio:cpr:nnnnnnnnnn (hvor nnnnnnnnnn erstattes med 10-cifret CPRnummer uden bindestreg) Se mapning i [SF1320_A-EXT] ObjektType Forretningsobjektet Person [Afklaring/KDF: UUID for Person ] ObjektHandling Handlingen CPRopdatering [Afklaring/KDF: UUID for CPR-001 CPR-041 ] OpgaveEmne Leveranceinformation Se mapning i [SF1320_A-EXT] Dannelsestidspunkt Tidspunkt hvor beskeden opstod SP s tid i DateTime format Sikkerhedsklassificering Klassificeringen f.eks. Personfølsomt [Afklaring/KDF: UUID for Personfølsomt ] GyldighedFra Tidspunkt hvor hændelsen skal gælde fra SP s tid i DateTime format KOMBIT A/S Halfdansgade København S CVR Side 29 af 32

30 De relaterede objekter udfyldes forskelligt ud fra handlingstypen. Se mapning i [SF1320_A-EXT]. I [SF1320_A-EXT] beskrives reglerne for, hvorledes CPR hændelser skal omformes til beskeder til Beskedfordeler, samt hvorledes Beskedkuverten udfyldes for hver hændelse. Beskedindholdet s XSD skal være tilsvarende XSD fra SF1520 med tilføjelse af en liste af CPR hændelseskoder. Systematic skal eventuelt udarbejde et forslag til XSD for beskedindholdet i beskeddata for persondata, som modtages i forbindelse med en ændring modtaget fra CPR. Beskedkuverten i hver besked skal indeholde Hændelseskoden fra cpr udtrækket, såfremt et ændringsudtræk fra CPR indeholder flere hændelseskoder, så skal der udløses en besked for alle hændelseskoder, ud fra forretningsreglerne. CPR-001er en generel CPR-ændring og skal kun udløses én gang per CPR-nummer, og kan benyttes til at opdatere et lokalt replika af CPR. Beskedindhold er altid det nye dataindhold i SP s CPR replika Datapersistering Det lokale replika skal opdateres med ændringer modtaget fra CPR. Beskeder skal opbevares indtil de er modtaget af Støttesystemet Beskedfordeler Databerigelse Data beriges ikke, men transformeres jf. afsnit Routing Ændringer i CPR vil medføre en eller flere beskeder jf. transformeringen i afsnit Orkestrering N/A Sikkerhed Der er sikkerhedsopsætning i EP_CPR1, EP_SPB1, EP_FS1 og EP_FS2. EP_CPR1 er en integration, hvor serviceplatformen henter ændringer hos CPR. Systematic skal anvende SFTP for at afhente det ændringer. Sikkerhedsopsætningen hos CPR er dokumenteret i guides-og-tjeklister/ftp-(cpr-udtraek)/ EP_SPB1 er en integration til det fælleskommunale støttesystem Beskedfordeler. Serviceplatformens service skal oprettes som et anvendersystem og være autoriseret til at sende personbeskeder. Integrationsmønsteret skal følge UC-SEC-04 og benytte Tokens til autentificering og autorisering mellem Serviceplatform og Beskedfordeler. KOMBIT A/S Halfdansgade København S CVR Side 30 af 32

31 Logning Det skal logges at beskeder er modtaget af det fælleskommunale Støttesystem Beskedfordeler Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration Det skal være muligt for en systemadministrator at administrere hvilke forretningshændelser som beskrevet i afsnit som er aktive/inaktive. Det skal være muligt at tilføje og fjerne forretningshændelser Supplerende information Ingen KOMBIT A/S Halfdansgade København S CVR Side 31 af 32

32 KOMBIT A/S Halfdansgade København S CVR Side 32 af 32