Integration SF Ydelsesindekset Integrationsbeskrivelse - version 2.3.1

Transkript

1 Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer dgj 0.1 Første version ehe Opdateret med wsdl-info ehe Opdateret med godkendt wsdl (version 2.0 leverance fra STS) MHO Opdateret med endpoints i produktion og test ehe Opdateret med Snitflacespecifikation og beskrivelse fra STS, som er udkommet i en version 2.3. Der er på den baggrund tilrettet reference til [WSDL-EXT] samt [WSDL-SP]. - Beskrevet at services i overgangsperiode kan tilgås med certifikat og Myndighedskontekst som alternativ til Rammearkitekturens token-løsning. - Henvist til terminalservice ved ønske om adgang til andre myndigheders data. - afsnit 1.1 udvidet til at indeholde henvisning til forretningsmæssig anvendelse af indekserne med præciserede anvisninger JJN Opdateret med forudsætninger og vilkår for tilslutning er tilføjet. - Kapitel Kapitel relevant for KY - Kapitel relevant for KSD - Kapitel relevant for SAPA - Kapitel relevant for Serviceplatformen Opdateret reference [WSDL-SP] med korrekt dato-stempel. Tilrettet casing for operationsnavne under endpoints, så det fremstår præcist (små bogstaver) som i wsdl-filen. Referencer Ref Titel Kommentarer [SPref] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: [STS-Sikkerhed] [WSDL-SP] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Integrationsbeskrivelsen refererer til SF1490 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link KOMBIT A/S Halfdansgade København S CVR Side 2 af 27

3 [WSDL-EXT] [TERM] [ANVISNING] Integrationsbeskrivelsen refererer til SF1490 Bilag zip som indeholder WSDL af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link Integrationsbeskrivelse for terminalservicen. Ligger samme sted som øvrige integrationsbeskrivelser: og heddder SF2860 Terminalservice. Anvisninger for anvendelse af indekserne: NB! I bilagsfilen er der releasenote, som beskriver ændringer i tilhørende dokumentaitone. Det er vigtigt at notere sig kommentar i releasenote om at det rød-markerede i dokumenterne er funktionalitet som endnu ikke er understøttet. KOMBIT A/S Halfdansgade København S CVR Side 3 af 27

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning af integration Supplerende information om tilslutning Kontekst for integrationsparter Kontekst for KY Kontekst for KSD Kontekst for SAPA Specifikation for integrationsparter Specifikation af endpoints for Anvendersystem Specifikation af endpoints for Ydelsesindekset Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 4 af 27

5 1 Overordnet beskrivelse 1.1 Integrationens formål Denne integration har til formål at give fagsystemerne mulighed for at vedligeholde kopier af deres ydelser i indekset, samt at kunne understøtte ydelsesoverblik i f.eks. SAPA og KMD Bevilling. Herudover benyttes ydelsesindekset til at udveksle ydelsesinformation mellem fagsystemer for at understøtte deres forretningsprocesser (f.eks. ydelsesberegninger og kontrol) Hvis der ønskes udveksling af ydelsesinformation mellem myndigheder, henvises til integration SF2860 Terminalservice [TERM]. Denne integrationsbeskrivelse beskriver den tekniske integration over Serviceplatformen til Ydelsesindekset. Yderligere detaljer om de bagvedliggende services i Støttesystemerne, Vilkår for anvendelse, begrebsmodel etc. findes i de tilhørende dokumenter i bilag [WSDL-EXT]. Herunder henvises også, fra vilkårene, til præciserede anvisninger til indekserne. De præciserede anvisninger har forretningsmæssigt perspektiv på anvendelsen, og ligger desuden i [ANVISNING].Overordnet forretningsflow i integrationen Ydelser opdeles i bevillinger der informerer om hvilke ydelser ydelsesmodtageren har fået bevilget, og effektueringer der informerer om ydelser der er leveret til modtageren (f.eks. en udbetaling af en økonomisk ydelse). Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. 1. IF-1 a. Anvendersystemet udfører operationen Import eller opdater for at vedligeholde bevillinger og/ eller effektueringer i indekset b. Anvendersystemet udfører operationen Fremsoeg for at læse bevillinger og/ eller effektueringer i indekset 2. IF-2 Anvendersystemet opdaterer tilstand med passiveret eller slettet på en bevilling 3. IF-3 Anvendersystemet opdaterer tilstand med passiveret eller slettet på en effektuering KOMBIT A/S Halfdansgade København S CVR Side 5 af 27

6 IF-1 Import, Opdater, Fremsoeg IF-2 Passiver, Slet, Fjern IF-3 Passiver, Slet, Fjern Serviceplatformen Anvendersystem Bevillinger og effektueringer operationer Synkron gennemstilling Modtag Bevillinger og effektueringer Synkron gennemstilling Bevillinger operationer Synkron gennemstilling Modtag kvittering Synkron gennemstilling Effektueringer Operationer Synkron gennemstilling Modtag kvittering Synkron gennemstilling Ydelsesindeks Modtag opdatering/ forespørgsel Returner svar Modtag opdatering Returner svar Modtag opdatering Returner svar 1.2 Servicebetingelser for den samlede integration Servicemål Parameter Flow 1,2,3 Tidsrum Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] 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 [Afklaring/KDF: Svartid for eksternt system kendes ikke] 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]. KOMBIT A/S Halfdansgade København S CVR Side 6 af 27

7 [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] 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]. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] 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. 1.3 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 Testfaciliteter og testmiljø [KDF: Udfyldes når behov fra bestiller er fastlagt] Testdata [KDF: Udfyldes når behov fra bestiller er fastlagt] KOMBIT A/S Halfdansgade København S CVR Side 7 af 27

8 1.3.2 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 1.4 Forudsætninger for produktionssætning af integration For at kunne anvende snitfalde er det en række vilkår og forudsætninger, som skal være opfyldt af en integrationspart, der skal tilsluttes. Ved integrationspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætning, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfalden. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter der skal udføreres som forudsætning for tilslutning af en integrationspart er beskrevet for hver enkelt tilslutningspart i kapitel Køreplan for Implementering Nedenstående diagram viser køreplanen for udrulningen af et anvendersystem inden for KOMBIT rammearkitektur under monopolbrudsprojektet. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge af den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssig kan udføres i. Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse. Kildesystem: Alle aktiviteter i forhold til serviceplatformen er afsluttet, men der kan være yderligere aktiviteter i forbindelse med tilslutning af et anvendersystem eller en kommune i forhold til kildesystemet. Anvendersystem og kommune: Ved tilslutning af et anvendersystem og/eller en kommune, er der en række aktiviteter op til idriftsættelse, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter, som skal udføres. Er der aktiviteter, som medfører konfiguration på Serviceplatformen, vil dette ske i forbindelse med leverandørens oprettelse af serviceaftalen for kommunen. KOMBIT A/S Halfdansgade København S CVR Side 8 af 27

9 1.4.2 Særlige vilkår Der er ingen specielle vilkår for brug af nærværende service ud over de generelle vilkår, der er beskrevet under vilkår for hhv. leverandører og kommuner Supplerende information om tilslutning Intet. KOMBIT A/S Halfdansgade København S CVR Side 9 af 27

10 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål KY vedligeholder ydelser for egne ydelser og fremsøger ydelser fra andre systemer for at understøtte interne forretningsprocesser til beregning/ kontrol Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart Forventet antal kald pr. år: IF-1: 10 mio, IF-2: ca. 4 mio, IF-3: ca. 8 mio Specifikke forsætninger for tilslutning af denne integrationspart Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS101 Anmodning om serviceaftale for SF1490 Konfiguration Administrationsmodul Leverandør af anvendersystem Leverandør af afsendersystem Fase 2.2 TS102 Godkendelse af SF1490 serviceaftale Konfiguration Administrationsmodul Kommune Kommune Fase 2.2 TS103 Populering af indekset med fagsystemets ydelser Migrering STS ydelsesindeks Leverandør af anvendelsessystem Leverandør af anvendelsessystem Fase 2.3 TS101 - Leverandøren skal anmode om indgåelse af serviceaftale for UDK, på SF1490, i serviceplatformens administrationsmodul, og Kommunen skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. I forbindelse med tilslutning til SF1490 skal korrekte endpoints for snitfladen angives. Serviceaftalen dækker alle services, beskrevet i denne integrationsbeskrivelse. Ved oprettelse af service aftalen skal der tages stilling til hvilke roller, der skal anvendes og dataafgrænsning (KLE, personfølsomhed mf.) for disse. TS102 - Kommunen skal godkende serviceaftalen. TS103 - Som led i migreringen og/eller oprettelse af ydelser i anvendersystemet, skal det sikres at ydelsesindekset er opdateret med nødvendige information om disse ydelser. Dette er en del af implementeringen af anvendersystemet, og er kun medtaget for helhedens skyld. KOMBIT A/S Halfdansgade København S CVR Side 10 af 27

11 2.2 Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål KSD vedligeholder ydelser for egne ydelser og fremsøger ydelser fra andre systemer for at understøtte interne forretningsprocesser til beregning/ kontrol Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart Forventet antal kald pr. år: IF-1: 2 mio, IF-2: ca. 1 mio, IF-3: ca. 1 mio Specifikke forsætninger for tilslutning af denne integrationspart Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS201 Anmodning om serviceaftale for SF1490 Konfiguration Administrationsmodul Leverandør af anvendersystem Leverandør af afsendersystem Fase 2.2 TS202 Godkendelse af SF1490 serviceaftale Konfiguration Administrationsmodul Kommune Kommune Fase 2.2 TS203 Populering af indekset med fagsystemets ydelser Migrering STS ydelsesindeks Leverandør af anvendelsessystem Leverandør af anvendelsessystem Fase 2.3 TS201 - Leverandøren skal anmode om indgåelse af serviceaftale for UDK, på SF1490, i serviceplatformens administrationsmodul, og Kommunen skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. I forbindelse med tilslutning til SF1490 skal korrekte endpoints for snitfladen angives. Serviceaftalen dækker alle services, beskrevet i denne integrationsbeskrivelse. Ved oprettelse af service aftalen skal der tages stilling til hvilke roller, der skal anvendes og dataafgrænsning (KLE, personfølsomhed mf.) for disse. TS202 - Kommunen skal godkende serviceaftalen. TS203 - Som led i migreringen og/eller oprettelse af ydelser i anvendersystemet, skal det sikres at ydelsesindekset er opdateret med nødvendige information om disse ydelser. Dette er en del af implementeringen af anvendersystemet, og er kun medtaget for helhedens skyld. KOMBIT A/S Halfdansgade København S CVR Side 11 af 27

12 2.3 Kontekst for SAPA Lovhjemmel og forvaltningsmæssigt formål SAPA skal kun benytte operationen Fremsoeg. [Lovhjemmel er pt. ukendt] Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart Integrationen dækker både leverancer til KMD Bevilling og til SAPA. Tallet i denne er bruttotal for de to systemer til sammen. Forventet antal kald pr. år: IF-1: mio Specifikke forsætninger for tilslutning af denne integrationspart Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS301 Anmodning om serviceaftale for SF1490 Konfiguration Administrationsmodul Leverandør af anvendersystem Leverandør af afsendersystem Fase 2.2 TS302 Godkendelse af SF1490 serviceaftale Konfiguration Administrationsmodul Kommune Kommune Fase 2.2 TS303 Populering af indekset med fagsystemets ydelser Migrering STS ydelsesindeks Leverandør af anvendelsessystem Leverandør af anvendelsessystem Fase 2.3 TS301 - Leverandøren skal anmode om indgåelse af serviceaftale for UDK, på SF1490, i serviceplatformens administrationsmodul, og Kommunen skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. I forbindelse med tilslutning til SF1490 skal korrekte endpoints for snitfladen angives. Serviceaftalen dækker alle services, beskrevet i denne integrationsbeskrivelse. Ved oprettelse af service aftalen skal der tages stilling til hvilke roller, der skal anvendes og dataafgrænsning (KLE, personfølsomhed mf.) for disse. TS302 - Kommunen skal godkende serviceaftalen. TS303 - Som led i migreringen og/eller oprettelse af ydelser i anvendersystemet, skal det sikres at ydelsesindekset er opdateret med nødvendige information om disse ydelser. Dette er en del af implementeringen af anvendersystemet, og er kun medtaget for helhedens skyld. KOMBIT A/S Halfdansgade København S CVR Side 12 af 27

13 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for Anvendersystem Integrationen benyttes til at vedligeholde en kopi af anvendersystemets bevillinger og tilhørende effektueringer i ydelsesindekset. Herudover udstilles en operation til fremsøgning af bevillinger og effektueringer Overordnet forretningslogik Der udstilles tre services: - YdelsesIndeks der kan Importere, Opdatere, eller Fremsøge en eller flere bevillinger og/ eller effektueringer - BevillingIndeks der kan ændre status på en bevilling til Passiveret/ Slettet eller fysisk slette en bevilling med tilhørende effektueringer - OekonomiskEffektueringIndeks der kan ændre status på en effektuering til Passiveret/ Slettet eller fysisk slette en effektuering Der er to anvendelsesscenarier: 1. Opdatering Dette anvendes af fagsystemer til at vedligeholde kopier af bevillings- og effektueringobjekter i indekset. Der benyttes Import til at tilføje nye bevillinger og eller effektueringer, Opdater til at ændre indholdet af eksisterende bevillinger og eller effektueringer. Der kaldes en særlig service til at passivere eller logisk slette et bevillingsobjekt. Det samme gælder for effektueringer. Endelig kan bevillinger og effektueringer fjernes (dvs. fysisk slettes). 2. Fremsøg Dette anvendes typisk af systemer der har behov for overblik over bevillinger og effektueringer. Operationen kan levere information omkring bevillinger og effektueringer på diverse kriterier Oversigt over endpoints ID Navn EP_AS1 Service: YdelsesIndeksService udstiller følgende operationer: Operation: importer tilføjer nye bevillinger og/ eller effektueringer til indekset. Operation: opdater ændrer bevillings- og/eller effektueringobjekter i indekset Operation: fremsoeg Søger/ læser bevillinger og/ eller effektueringer i henhold til søgefiltre EP_AS2 Service: BevillingIndeksService udstiller følgende operationer: Operation: passiver Ændrer tilstand for et bevillingsobjekt til Passiveret KOMBIT A/S Halfdansgade København S CVR Side 13 af 27

14 Operation: slet Ændrer tilstand for et bevillingsobjekt til Slettet (dvs. logisk slettet) Operation: fjern Sletter fysisk bevillingsobjekter fra indekset EP_AS3 Service: OekonomiskEffektueringIndeksService udstiller følgende operationer: Operation: passiver Ændrer tilstand for en effektueringobjekt til Passiveret Operation: slet Ændrer tilstand for en effektueringobjekt til Slettet (dvs. logisk slettet) Operation: fjern Sletter fysisk effektueringobjekter fra indekset Beskrivelse af endpoint EP_AS1 - YdelseIndeks Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Anvendersystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en synkron SOAP webservice Teknisk endpoint Følgende specificerer endpoint-oplysninger. Reference til wsdl [WSDL-SP]/YdelsesIndeks/YdelseIndeksService.wsdl Operationer inkluderet er som angivet i afsnit Servicenavn på Serviceplatformen Version på Serviceplatformen Servicen ligger under navnet YdelsesIndeks Gældende version ift. denne integrationsbeskrivelse er Teknisk retning for udveksling Anvendersystemet kalder en synkron service udstillet på Serviceplatformen Dataretning for udveksling For operationer importer og opdater overføres information til Serviceplatformen. For operationen fremsoeg returnerer Serviceplatformen data KOMBIT A/S Halfdansgade København S CVR Side 14 af 27

15 Service invokation / Triggers Anvendersystemet kalder servicen når der er en ændring til en eller flere bevillinger og/ eller et eller flere effektueringer, eller der er behov for at fremsøge bevillinger og/ eller effektueringer Dataspecifikation Se [WSDL-EXT] hvor filen YdelseIndeks-Snitflade.pdf beskriver snitfladen Sikkerhed Der anvendes rammearkitekturens tokenbaserede sikkerhedsmodel, ligesom der i en overgangsperiode kan tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Leverance er At least once. Hvis en opdatering genfremsendes vil den enten fejle eller overskrive den tidligere fremsendte 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 Beskrivelse af endpoint EP_AS2 - BevillingIndeks Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Anvendersystemet er serviceanvender. KOMBIT A/S Halfdansgade København S CVR Side 15 af 27

16 Teknologisk understøttelse Snitfladen er implementeret som en synkron SOAP webservice Teknisk endpoint Følgende specificerer endpoint-oplysninger. Reference til wsdl [WSDL-SP]/BevillingIndeks/BevillingIndeksService.wsdl Operationer inkluderet er som angivet i afsnit Servicenavn på Serviceplatformen Version på Serviceplatformen Servicen ligger under navnet BevillingIndeks Gældende version ift. denne integrationsbeskrivelse er Teknisk retning for udveksling Anvendersystemet kalder en synkron service udstillet på Serviceplatformen Dataretning for udveksling Objektstatusændring overføres til Ydelsesindekset Service invokation / Triggers Anvendersystemet kalder servicen når et Bevillingsobjekt skifter status til passiveret eller slettet, eller skal fjernes (fysisk slettes) Dataspecifikation Se [WSDL-EXT] hvor filen BevillingIndeks-Snitflade.pdf beskriver snitfladen Sikkerhed Der anvendes rammearkitekturens tokenbaserede sikkerhedsmodel, ligesom der i en overgangsperiode kan tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Leverance er At least once. Hvis en opdatering genfremsendes vil den enten fejle eller overskrive den tidligere fremsendte Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi KOMBIT A/S Halfdansgade København S CVR Side 16 af 27

17 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Beskrivelse af endpoint EP_AS3 - OekonomiskEffektueringIndeks Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Anvendersystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en synkron SOAP webservice Teknisk endpoint Følgende specificerer endpoint-oplysninger. Reference til wsdl [WSDL-SP]/ OekonomiskEffektueringIndeks/OekonomiskEffektueringIndeksService.wsdl Operationer inkluderet er som angivet i afsnit Servicenavn på Serviceplatformen Version på Serviceplatformen Servicen ligger under navnet OekonomiskEffektueringIndeks Gældende version ift. denne integrationsbeskrivelse er Teknisk retning for udveksling Anvendersystemet kalder en synkron service udstillet på Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 17 af 27

18 Dataretning for udveksling Objektstatusændring overføres til Ydelsesindekset Service invokation / Triggers Anvendersystemet kalder servicen når et OekonomiskEffektueringobjekt skifter status til passiveret eller slettet, eller det skal fjernes helt (fysisk slettes) Dataspecifikation Se [WSDL-EXT] hvor filen BevillingIndeks-Snitflade.pdf beskriver snitfladen Sikkerhed Der anvendes rammearkitekturens tokenbaserede sikkerhedsmodel, ligesom der i en overgangsperiode kan tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Leverance er At least once. Hvis en opdatering genfremsendes vil den enten fejle eller overskrive den tidligere fremsendte 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 KOMBIT A/S Halfdansgade København S CVR Side 18 af 27

19 3.1.6 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] 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. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.2 Specifikation af endpoints for Ydelsesindekset Da der er tale om direkte gennemstilling svarer disse endpoints præcist til de tilsvarende der udstilles på Serviceplatformen. For detaljer henvises til afsnit Overordnet forretningslogik Der udstilles tre services: - YdelseIndeks der kan Importere, Opdatere, Fjerne, eller Fremsøge en eller flere bevillinger og/ eller effektueringer - BevillingIndeks der kan ændre status på en bevilling til Passiveret eller Slettet - OekonomiskEffektueringIndeks der kan ændre status på en effektuering til Passiveret eller Slettet Der er to anvendelsesscenarier: KOMBIT A/S Halfdansgade København S CVR Side 19 af 27

20 3. Opdatering Dette anvendes af fagsystemer til at vedligeholde kopier af bevillings- og effektueringobjekter i indekset. Der benyttes Import til at tilføje nye bevillinger og eller effektueringer, Opdater til at ændre indholdet af eksisterende bevillinger og eller effektueringer. Der kaldes en særlig service til at passivere eller logisk slette et bevillingsobjekt. Det samme gælder for effektueringer. Endelig kan bevillinger og effektueringer fjernes (dvs. fysisk slettes). 4. Fremsøg Dette anvendes typisk af systemer der har behov for overblik over bevillinger og effektueringer. Operationen kan levere information omkring bevillinger og effektueringer på diverse kriterier Oversigt over endpoints ID Navn EP_SD1 EP_SD2 EP_SD3 YdelseIndeks Operation: importer tilføjer nye bevillinger og/ eller effektueringer til indekset. Operation: opdater ændrer bevillings- og/eller effektueringobjekter i indekset Operation: fremsoeg Søger/ læser bevillinger og/ eller effektueringer i henhold til søgefiltre BevillingIndeks Operation: passiver Ændrer tilstand for et bevillingsobjekt til Passiveret Operation: slet Ændrer tilstand for et bevillingsobjekt til Slettet (dvs. logisk slettet objekt) Operation: fjern Sletter fysisk bevillingsobjekter fra indekset OekonomiskEffektueringIndeks Operation: passiver Ændrer tilstand for en effektueringobjekt til Passiveret Operation: slet Ændrer tilstand for en effektueringobjekt til Slettet (dvs. logisk slettet objekt) Operation: fjern Sletter fysisk effektueringobjekter fra indekset KOMBIT A/S Halfdansgade København S CVR Side 20 af 27

21 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. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. Anvendersystem EP_AS1 EP_AS2 EP_AS3 Serviceplatformen IF01 YdelseIndeks IF02 BevillingIndeks IF03 OekonomiskEffektueringIndeks EP_SD1 EP_SD2 EP_SD3 Ydelsesindeks Oversigt over integrationsflows ID Navn IF01 IF02 IF03 YdelseIndeks BevillingIndeks OekonomiskEffektueringIndeks Integrationsflow IF01: YdelseIndeks Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_AS1 YdelseIndeks EP_SD1 YdelseIndeks KOMBIT A/S Halfdansgade København S CVR Side 21 af 27

22 Integrationstype Gennemstillingsintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Anvendersystem Serviceplatform Ydelsesindeks Synkront kald af Ydelse SP viderestiller kald til YD Idx YD Idx returnerer resultat SP returnerer data til Anvender EP_AS1 EP_SD Datatransformering Datapersistering Databerigelse Routing Orkestrering [ Sikkerhed UC-04: Standard Token til Token Derudover skal servicen udstilles med Myndighedskontekst og certifikat i en overgangsperiode. Primært til KMD Sag udfasning. KOMBIT A/S Halfdansgade København S CVR Side 22 af 27

23 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration Supplerende information Integrationsflow IF02: BevillingIndeks Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_AS2 BevillingIndeks EP_SD2 BevillingIndeks Integrationstype Gennemstillingsintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Anvendersystem Serviceplatform BevillingIndeks Synkront kald af Ydelse SP viderestiller kald til Bev.Idx Bev.Idx returnerer resultat SP returnerer data til Anvender EP_AS2 EP_SD Datatransformering KOMBIT A/S Halfdansgade København S CVR Side 23 af 27

24 Datapersistering Databerigelse Routing Orkestrering [ Sikkerhed UC-04: Standard Token til Token Derudover skal servicen udstilles med Myndighedskontekst og certifikat i en overgangsperiode. Primært til KMD Sag udfasning Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration Supplerende information Integrationsflow IF03: OekonomiskEffektueringIndeks Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_AS3 OekonomiskEffektueringIndeks EP_SD3 OekonomiskEffektueringIndeks KOMBIT A/S Halfdansgade København S CVR Side 24 af 27

25 Integrationstype Gennemstillingsintegration Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Anvendersystem Serviceplatform Oekon.Eff.Indeks Synkront kald af Ydelse SP viderestiller kald til Oeff.Idx Oeff.Idx returnerer resultat SP returnerer data til Anvender EP_AS3 EP_SD Datatransformering Datapersistering Databerigelse Routing Orkestrering [ Sikkerhed UC-04: Standard Token til Token Derudover skal servicen udstilles med Myndighedskontekst og certifikat i en overgangsperiode. Primært til KMD Sag udfasning. KOMBIT A/S Halfdansgade København S CVR Side 25 af 27

26 Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliteter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration Supplerende information Tilslutning til integrationspart: Serviceplatformen Dette kapitel liste de forudsætninger, som skal være opfyldt for at Serviceplatformen kan udstille den pågældende snitflade. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TSP01 Registrering af ydelsesindeks og udstillede services i STS Organisation Konfiguration STS Organisation KOMBIT/ KDI KOMBIT/ KDI Fase 1 TSP02 Registrering af Serviceinformation for ydelsesindeks i Serviceplatformen Konfiguration Serviceplatformen KOMBIT/ KDI KOMBIT/ KDI Fase 1 TSP03 Registrering af serviceinformation for ydelsesindeks i Administrationsmodul Konfiguration Administrationsmodul KOMBIT/ KDI KOMBIT/ KDI Fase 1 KOMBIT A/S Halfdansgade København S CVR Side 26 af 27

27 TSP01 - Ydelsesindeks indeks skal oprettes STS Organisation, hvis dette ikke allerede er sket, herunder de services, som udstilles af Ydelsesindeks, og som er beskrevet i denne Snitflade. TSP02 - Der skal registres information vedrørende Ydelsesindeks i Serviceplatformen, så der kan oprettes serviceaftaler for tilslutningspartner (kommuner), bl.a. skal logiske og fysiske endpoint skal være relateret. TSP03 - Ydelsesindeks skal oprettes i STS Administrationsmodul, herunder de services, operation, som udstilles. Yderligere skal de services, som Serviceplatformen udstiller på baggrund af Ydelsesindeks registres. KOMBIT A/S Halfdansgade København S CVR Side 27 af 27