Integration SF Klassifikation services Integrationsbeskrivelse - version 2.8.3

Transkript

1 Integration - version Kommunernes Data & Infrastruktur - KDI

2 Versionshistorik Relevans Dato Initialer Version Kommentarer EHE Wsdl indarbejdet EHE Opdateret referencer til godkendt version 2.0 af klassifikation. Herunder wsdl-filer ehe Opdateret med Snitflacespecifikation og beskrivelse fra STS, som er udkommet i en version 2.2. Der er på den baggrund tilrettet reference til [WSDL-EXT] samt [WSDL-SP]. Sidst er beskrevet, at Services i overgangsperiode kan tilgås med certifikat og Myndighedskontekst som alternativ til Rammearkitekturens tokenløsning JJN Opdateret med forudsætninger og vilkår for tilslutning er tilføjet. - Kapitel Kapitel relevant for SAPA - Kapitel relevant for KY - Kapitel relevant for KSD - 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 ehe Opdateret reference til bilag [WSDL-EXT] jf. ny release på STS. Der er ingen snitfladeændringer (dvs. ingen ændringer til servicen der er udstillet på Serviceplatformen [WSDL-SP]. For detaljer om leverancens indhold af det bagvendliggende Støttesystem, henvises til den releasenote der ligger i [WSDL-EXT] EHE Opdateret reference til bilag (nyt bilag). Se releasenote i bilag for detaljer om opdatering XEHL Opdateret reference til Teknisk Spec fil. Denne opdatering vedr. Udstilling med Liberty Basic SOAP Binding. Bemærk at versionen af servicen er gået fra 2.0 til 3.0 på serviceplatformen XMSC Opdateret reference til bilag [WSDL-EXT] jf. Ny release på STS Klassifikation. Ny snitfladeversion er Opdateret reference til bilag [WSDL-SP]. Serviceoperationen Klassifikationssystem.eksport udgår. For yderligere detaljer om leverancens indhold af det bagvendliggende Støttesystem, henvises til den releasenote der ligger i [WSDLEXT] XEHL Versionsnummer er løftet til af vedligeholdelsesmæssige hensyn, og følger nu versionsnummer for Klassifikation-leverancen. Leverancen indeholder følgende: Opdateret reference til bilagsfil [WSDL-EXT] på baggrund af release 2.0 af Klassifikation, som altså indeholder version 2.7 af Klassifikation. For informationer om opdateringer henvises til filen Klassifikation 2.7 KOMBIT A/S Halfdansgade København S CVR Side 2 af 22

3 Release notes.pdf i [WSDL-EXT] Referencen [WSDL-SP] til kontrakten mod Serviceplatformen, er uændret i forhold til version af integrationsbeskrivelsen. Derudover mindre redaktionelle rettelser, bl.a.: Fjernet referencen [SPREF], fjernet referencen [SIKKERHED]. Opdateret afsnit om Servicemanagement med ny kontakt . Opdateret afsnit om test i forbindelse med udvikling. Samlet endpointoplysninger for anvendere i tabel først i afsnit XEHL Opdateret reference til bilagsfil [WSDL-EXT] på baggrund af release 2.1 af Klassifikation, som altså indeholder version 2.8 af Klassifikation. For informationer om opdateringer henvises til filen Klassifikation version 2.8 Release notes.pdf i [WSDL-EXT]. Opdateret reference til bilagsfilerne [WSDL-EXT] samt [WSDL-SP]. Førstnævnte er opdateret pga. leverance af ny version af snitfladerne fra STS, og sidstnævnte er den tilsvarende udstilling på Serviceplatformen. Mindre redaktionelle ændringer til afsnit og afsnit CWM Opdateret reference til bilagsfil [WSDL-EXT] på baggrund af release STS af STS Klassifikation MBJ Opdateret reference til bilagsfil [WSDL-EXT] på baggrund af release ny snitfladeversion. Referencer Ref Titel Kommentarer [STSSikkerhed] [WSDL- SP] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link n refererer til SF1510 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se linkhttps://sharekomm.kombit.dk/p133/r/forms/grp%20snitflad engler%20release.aspx [WSDL- EXT] n refererer til SF1510 Bilag zip som indeholder WSDL af eksterne interfaces, som er placeret i samme mappe som integrationsbeskrivelsen, se link engler%20release.aspx NB! I bilagsfilen er der releasenote, som beskriver ændringer i tilhørende dokumentation. KOMBIT A/S Halfdansgade København S CVR Side 3 af 22

4 [GVF] Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Filen Generelle vilkår og forudsætninger.pdf, som ligger her: [KDIDrift] Hjemmeside med informationer om drift og forvaltning af KDIs Services [KDITest] Hjemmeside med informationer om ibrugtagning og test af KDIs Services: 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 SAPA Kontekst KY Kontekst for KSD Specifikation for Integrationsparter Specifikation af endpoints for Anvendersystem Specifikation af endpoints for Klassifikation Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen Noter vedr. beslutning, detaljer og andet Overordnet beskrivelse 1.1 Integrationens formål Støttesystemet Klassifikation anvendes til at udsøge relevante klassifikationer. Støttesystemet agerer således autoritativ kilde for klassifikationer. Fagsystemerne har behov for at kunne vedligeholde egne Klassifikationssystemer i støttesystemet Klassifikation. Dette vil eksempelvis være kommunale varianter af kontoplanen, KLE eller lignende. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen KOMBIT A/S Halfdansgade København S CVR Side 4 af 22

5 Fagsystemet kalder servicen på serviceplatformen. Serviceplatformen udstiller en række services til læsning og skrivning af i klassifikation og gennemstiller kaldet fra fagsystemet til Klassifikation. Klassifikation udstiller service til læsning og skrivning i klassifikation. Klassifikation svarer i synkront retursvar. Serviceplatformen sender synkront retursvar til fagsystemet. Fagsystemet modtager synkront retursvar. 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Forespørgsel på klassifikationsdata Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. [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. [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] KOMBIT A/S Halfdansgade København S CVR Side 5 af 22

6 Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage. [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. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] Service Management Informationer om driftsmeddelelser, forespørgsler og kontaktinformationer, findes på siden for Drift og Forvaltning af KDIs Services her: [KDIDrift] 1.4 Teststrategi Den planlagte test af services til installation på Serviceplatformen omfatter pt., at der udfører automatiserede tests af services og unittests. Der er tale om en robust test af sikkerhed, routing og anden kernefunktionalitet i integrationen, samt mere en simpel test af, om de enkelte operationer kan benyttes, stikprøvekontrol. Testen omfatter ikke samtlige dataelementer i operationerne. Leverandøren af Serviceplatformen er ansvarlig for denne test. Det generelle udgangspunkt for KOMBITs teststrategi er, at alle involverede parter har gennemført en robust systemtest af egen løsning, før der gennemføres test parterne imellem. Generelle informationer om ibrugtagning og test, samt kontaktinformationer for specifikke ønsker, kan findes via [KDITest]. 1.5 Forudsætninger for produktionssætning 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. KOMBIT A/S Halfdansgade København S CVR Side 6 af 22

7 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 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. 2 Kontekst for Integrationsparter 2.1 Kontekst SAPA Lovhjemmel og forvaltningsmæssigt formål Der er tale om kommunens egen data, så lovhjemmel er ikke relevant. 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 er at indeholde alle kommunalt relaterede klassifikationer som fx KLE, FORM, STORM og kan rumme og forvalte alle former for taksonomier i øvrigt. KOMBIT A/S Halfdansgade København S CVR Side 7 af 22

8 Sags- og partsoverblikket i SAPA skal anvende Støttesystemet Klassifikation bl.a. ved filtrering af Sager ud fra sagstyper (KLE-numre) og ved opmærkning af nye Journalnotater oprettet via Systemet. Desuden skal Klassifikation i Advismodulet anvendes til opslag på sagstyper. Når der fx i Advisgruppen skal angives af hvilken type den modtagende Sag skal være, så foregår det ved at udvælge et spænd af KLE-numre og evt. tilhørende handlingsfacet. Endvidere skal Klassifikation rumme alle beskedtyper Kapacitets- og servicekrav Forventet volumen er estimeret til opslag pr. år. [Afklaring/SAPA: Er dette tal korrekt?] Specifikke forhold for tilslutning af anvendersystem: SAPA 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 Kompone nt Ansvarlig Udførende Fase og afhængigh ed Komment ar KOMBIT A/S Halfdansgade København S CVR Side 8 af 22

9 TS10 1 TS10 2 Oprettelse af specifikke klassifikation er or anvendersyst em Oprettelse af specifikke klassifikation er for kommune f Konfigurati on Konfigurati on Administra tionsmodul Administrationsmodul Leverandør af anvendersyst em Leverandør af afsendersyst em Fase 2.1 Kommune Kommune Fase 2.1 Samme som TS202 og TS302 af 26 TS103 TS104 Anmodning om serviceaftale for SF1510 Godkendelse af SF1510 serviceaftale Konfiguration Administrationsmodul Konfiguration Administrationsmodul Leverandør af Leverandør af anvendersystem afsendersystem Fase 2.2 Kommune Kommune Fase 2.2 TS101 - Har leverandøren specifikke klassifikationer, som anvendersystemet gør brug af, skal disse oprettes i STS klassifikation før ibrugtagningen af anvendersystemet. TS102 - Har Kommunen specifikke klassifikationer, som kommune ønsker at anvende for det givne anvendersystemet eller på tværs af systemer i kommunen, skal disse oprettes i STS klassifikation for ibrugtagning af systemer, som skal anvende disse. TS103 - Leverandøren skal anmode om indgåelse af serviceaftale for UDK, på SF1510, 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 SF1510 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. TS104 - Kommunen skal godkende serviceaftalen. 2.2 Kontekst KY Lovhjemmel og forvaltningsmæssigt formål Det anførte hjemmelsgrundlaget er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelige og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor KOMBIT A/S Halfdansgade København S CVR Side 9

10 understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering. [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det forvaltningsmæssige formål er at [ ] [Udfyldes med en kortfattet beskrivelse af de forvaltningsmæssige formål med anvendelse af ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommen TS201 Oprettelse af specifikke klassifikationer for anvendersystem TS202 Oprettelse af specifikke klassifikationer for kommune TS203 Anmodning om serviceaftale for SF1510 TS204 Godkendelse af SF1510 serviceaftale servicen.] Konfiguration Admini- strationsmodul Konfiguration Admini- strationsmodul Konfiguration Admini- strationsmodul Konfiguration Admini- strationsmodul Leverandør af Leverandør af anvendersystem afsendersystem Fase 2.1 TS102 og Kommune Kommune Fase 2.1 Samme so TS302 Leverandør af Leverandør af anvendersystem afsendersystem Fase 2.2 Kommune Kommune Fase Kapacitets- og servicekrav Forventet volumen er estimeret til opslag pr. måned Specifikke forhold for tilslutning af anvendersystem: KY Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. TS201 - Har leverandøren specifikke klassifikationer, som anvendersystemet gør brug af, skal disse oprettes i STS klassifikation før ibrugtagningen af anvendersystemet. TS202 - Har Kommunen specifikke klassifikationer, som kommune ønsker at anvende for det givne anvendersystemet eller på tværs af systemer i kommunen, skal disse oprettes i STS klassifikation for ibrugtagning af systemer, som skal anvende disse. KOMBIT A/S Halfdansgade København S CVR Side 10 af 22

11 TS203 - Leverandøren skal anmode om indgåelse af serviceaftale for UDK, på SF1510, 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 SF1510 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. TS204 - Kommunen skal godkende serviceaftalen. 2.3 Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål Det anførte hjemmelsgrundlaget er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelige 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. [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det forvaltningsmæssige formål er at [ ] [Udfyldes med en kortfattet beskrivelse af de forvaltningsmæssige formål med anvendelse af servicen.] Kapacitets- og servicekrav Forventet volumen er estimeret til max. 100 opslag pr. måned. [Afklaring/KSD: Er dette tal korrekt?] KOMBIT A/S Halfdansgade København S CVR Side 11 af 22

12 2.3.3 Specifikke forhold for tilslutning af anvendersystem: KSD Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at en kommune gennem et anvendersystem kan benytte snitfladen. TS301 - Har leverandøren specifikke klassifikationer, som anvendersystemet gør brug af, skal disse oprettes i STS klassifikation før ibrugtagningen af anvendersystemet. TS302 - Har Kommunen specifikke klassifikationer, som kommune ønsker at anvende for det givne anvendersystemet eller på tværs af systemer i kommunen, skal disse oprettes i STS klassifikation for ibrugtagning af systemer, som skal anvende disse. TS303 - Leverandøren skal anmode om indgåelse af serviceaftale for UDK, på SF1510, 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 SF1510 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. TS304 - Kommunen skal godkende serviceaftalen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommen TS301 Oprettelse af specifikke klassifikationer for anvendersystem TS302 Oprettelse af specifikke klassifikationer for kommune TS303 Anmodning om serviceaftale for SF1510 TS304 Godkendelse af SF1510 serviceaftale Konfiguration Administrationsmodul Konfiguration Admini- strationsmodul Konfiguration Admini- strationsmodul Konfiguration Administrationsmodul Leverandør af Leverandør af anvendersystem afsendersystem Fase 2.1 TS102 og Kommune Kommune Fase 2.1 Samme so TS202 Leverandør af Leverandør af anvendersystem afsendersystem Fase 2.2 Kommune Kommune Fase 2.2 KOMBIT A/S Halfdansgade København S CVR Side 12 af 22

13 3 Specifikation for Integrationsparter 3.1 Specifikation af endpoints for Anvendersystem Integrationen benyttes til at hente og vedligeholde data vedrørende klassifikation data i Støttesystemet Klassifikation Overordnet forretningslogik Fagsystemet kalder serviceplatformen, som udstiller 4 synkrone services med hver der inden for forskellige domæneområder giver forskellige muligheder for at behandle data. Fagsystemet kalder EP_FS# på serviceplatformen Serviceplatformen returnerer et synkront svar til fagsystemet Oversigt over endpoints Serviceplatformen udstiller endpoints gennem 4 services. For 3 af disse services gælder det, at de hver har 8 operationer, der kan deles op i to kategorier; dem som ændrer i objekter (importer, opret, passiver, ret og slet) og dem som ikke ændrer i objekter (list, laes og soeg). Fagprojekterne vil anvende operationerne list, laes og soeg, Den undtagne service (KlassifikationSystem) udstiller tre operationer: import, eksport og fremsoegobjekthierarki ID Navn Reference til wsdl* Servicenavn på Serviceplatformen** Version på Serviceplatformen*** EP_F S1 Facet [WSDL-SP]/Facet/wsdl/token/FacetService.wsdl Servicenavn: FacetService Facet 4.0 Operationsnavne: Der er otte operationer, fordelt to grupper; dem der ændrer i objekter (importer, opret, passiver, ret og slet) og dem der ikke ændrer i objekter (list, laes og soeg) EP_F S2 Klasse [WSDL-SP]/Klasse/wsdl/token/KlasseService.wsdl Servicenavn: KlasseService Klasse 4.0 Operationsnavne: Der er otte operationer, fordelt to grupper; dem der ændrer i objekter (importer, opret, passiver, ret og slet) og dem der ikke ændrer i objekter (list, laes og soeg) EP_F Klassifikation [WSDL-SP]/Facet/wsdl/token/ Facet Service.wsdl Klassifikation 4.0 KOMBIT A/S Halfdansgade København S CVR Side 13 af 22

14 S3 Servicenavn: KlassifikationService Operationsnavne: Der er otte operationer, fordelt to grupper; dem der ændrer i objekter (importer, opret, passiver, ret og slet) og dem der ikke ændrer i objekter (list, laes og soeg) EP_F S4 Klassifikation- System [WSDL- SP]/KlassifikationSystem/wsdl/token/Klassifikation Klassifikation- System 4.0 SystemService.wsdl Servicenavn: KlassifikationSystemService Operationsnavne: Servicen udstiller tre operationer: import, eksport og fremsoegobjekthierarki Beskrivelse af endpoint EP_FS1 - Facet Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice Teknisk endpoint Endpointoplysninger er angivet i tabelen i afsnit Teknisk retning for udveksling Fagsystemet kalder serviceplatformen Dataretning for udveksling Alt efter hvilken operation der kaldes ændrer retningen for data sig: Ved Importer, Opret, Passiver, Ret og Slet sender Fagsystemet data til Serviceplatformen. Ved List, Laes og Soeg henter Fagsystemet data Service invokation / Triggers Forespørgsler på enkeltelementer vil forekomme som led i sagsprocessser. Forespørgsler på hele klassifikationssystemer vi forekomme, når eller hvis der er behov for opdatering af lokale kopier af klassifikationssystemer Dataspecifikation KOMBIT A/S Halfdansgade København S CVR Side 14 af 22

15 Se [WSDL-EXT] hvor filen Facet-Snitflade.pdf beskriver snitfladen Sikkerhed Sikkerheden mellem fagsystemet og serviceplatformen er tokenbaseret, jf. Rammearkitekturens tokenbaserede sikkerhedsmodel. Derudover kan der i en overgangsperiode tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Fagsystemet skal være i stand til at håndtere at der i korte perioder ikke er adgang til forespørgselsservicen og skal kunne genfremsætte forespørgslen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Beskrivelse af endpoint EP_FS2 - Klasse Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice Teknisk endpoint Endpointoplysninger er angivet i tabelen i afsnit Teknisk retning for udveksling Fagsystemet kalder serviceplatformen Dataretning for udveksling Alt efter hvilken operation der kaldes ændrer retningen for data sig: KOMBIT A/S Halfdansgade København S CVR Side 15 af 22

16 Ved Importer, Opret, Passiver, Ret og Slet sender Fagsystemet data til Serviceplatformen. Ved List, Laes og Soeg henter Fagsystemet data Service invokation / Triggers Forespørgsler på enkeltelementer vil forekomme som led i sagsprocessser. Forespørgsler på hele klassifikationssystemer vi forekomme, når eller hvis der er behov for opdatering af lokale kopier af klassifikationssystemer Dataspecifikation Se [WSDL-EXT] hvor filen Klasse-Snitflade.pdf beskriver snitfladen Sikkerhed Sikkerheden mellem fagsystemet og serviceplatformen er tokenbaseret, jf. Rammearkitekturens tokenbaserede sikkerhedsmodel. Derudover kan der i en overgangsperiode tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Fagsystemet skal være i stand til at håndtere at der i korte perioder ikke er adgang til forespørgselsservicen og skal kunne genfremsætte forespørgslen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Beskrivelse af endpoint EP_FS3 - Klassifikation Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice Teknisk endpoint KOMBIT A/S Halfdansgade København S CVR Side 16 af 22

17 Endpointoplysninger er angivet i tabelen i afsnit Teknisk retning for udveksling Fagsystemet kalder serviceplatformen Dataretning for udveksling Alt efter hvilken operation der kaldes ændrer retningen for data sig: Ved Importer, Opret, Passiver, Ret og Slet sender Fagsystemet data til Serviceplatformen. Ved List, Laes og Soeg henter Fagsystemet data fra Service invokation / Triggers Forespørgsler på enkeltelementer vil forekomme som led i sagsprocessser. Forespørgsler på hele klassifikationssystemer vi forekomme, når eller hvis der er behov for opdatering af lokale kopier af klassifikationssystemer Dataspecifikation Se [WSDL-EXT] hvor filen Klassifikation-Snitflade.pdf beskriver snitfladen Sikkerhed Sikkerheden mellem fagsystemet og serviceplatformen er tokenbaseret, jf. Rammearkitekturens tokenbaserede sikkerhedsmodel. Derudover kan der i en overgangsperiode tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Fagsystemet skal være i stand til at håndtere at der i korte perioder ikke er adgang til forespørgselsservicen og skal kunne genfremsætte forespørgslen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Beskrivelse af endpoint EP_FS4 - KlassifikationSystem Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller KOMBIT A/S Halfdansgade København S CVR Side 17 af 22

18 Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice Teknisk endpoint Endpointoplysninger er angivet i tabelen i afsnit Teknisk retning for udveksling Fagsystemet kalder serviceplatformen Dataretning for udveksling Alt efter hvilken operation der kaldes ændrer retningen for data sig: Ved Import sender Fagsystemet data til Serviceplatformen. Ved eksport og fremsoegobjekthierarki henter Fagsystemet data Service invokation / Triggers Forespørgsler på enkeltelementer vil forekomme som led i sagsprocessser. Forespørgsler på hele klassifikationssystemer vi forekomme, når eller hvis der er behov for opdatering af lokale kopier af klassifikationssystemer Dataspecifikation Se [WSDL-EXT] hvor filen KlassifikationSystem-Snitflade.pdf beskriver snitfladen Sikkerhed Sikkerheden mellem fagsystemet og serviceplatformen er tokenbaseret, jf. Rammearkitekturens tokenbaserede sikkerhedsmodel. Derudover kan der i en overgangsperiode tilgås med certifikat og myndighedskontekst på SP (kræver godkendelse) Leverancesikkerhed og fejlhåndtering Fagsystemet skal være i stand til at håndtere at der i korte perioder ikke er adgang til forespørgselsservicen og skal kunne genfremsætte forespørgslen Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Tilgængelighed KOMBIT A/S Halfdansgade København S CVR Side 18 af 22

19 Spidsbelastningsperiode Servicevinduer 3.2 Specifikation af endpoints for Klassifikation Da der er tale om direkte gennemstilling svarer disse endpoints præcist til de tilsvarende der udstilles på Serviceplatformen. For detaljer henvises til afsnit 3.1 ift. Serviceplatformens udstilling, mens [WSDL-EXT] indeholder dokumentation om udstillingen fra Klassifikation Overordnet forretningslogik Serviceplatformen udstiller endpoints gennem 4 services. For 3 af disse services gælder det, at de hver har 8 operationer, der kan deles op i to kategorier; dem som ændrer i objekter (importer, opret, passiver, ret og slet) og dem som ikke ændrer i objekter (list, laes og soeg). Fagprojekterne vil anvende operationerne list, laes og soeg, Den undtagne service (KlassifikationSystem) udstiller tre operationer: import, eksport og fremsoegobjekthierarki Serviceplatformen kalder EP_FS# hos Klassifikation. Klassifikation udfører operationen. Klassifikation returnerer retur der fortæller kaldet var succesfuldt Oversigt over endpoints ID Navn EP_STS1 EP_STS2 EP_STS3 EP_STS4 Facet Klasse Klassifikation KlassifikationSystem 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 Fejl! Henvisningskilde ikke fundet.. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 19 af 22

20 4.1.1 Oversigt over integrationsflows ID Navn IF01 Behandl forespørgsel Integrationsflow IF01: Behandl forespørgsel Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 Facet Afsnit 3.1 EP_FS2 Klasse Afsnit 3.1 EP_FS3 Klassifikation Afsnit 3.1 EP_FS4 KlassifikationSystem Afsnit 3.1 EP_STS1 Facet Afsnit 3.2 EP_STS2 Klasse Afsnit 3.2 EP_STS3 Klassifikation Afsnit 3.2 EP_STS4 KlassifikationSystem Afsnit Integrationstype Integrationen er en gennemstillingsintegration, hvor fagsystemet forespørger Klassifikation hvorefter Klassifikation returnerer synkront svar Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 20 af 22

21 SAPA / KSD / KY Serviceplatform STS ( Klassifikation ) Synkront kald for forespøgsel til STS SP viderestiller kald til STS STS returnerer resultat SP returnerer svaret til FS EP _ FS * EP _ STS * Datatransformering N/A Datapersistering N/A Databerigelse N/A Routing N/A Orkestrering N/A Sikkerhed Sikkerheden mellem Fagsystem og Serviceplatformen er tokenbaseret jf. Rammearkitekturens sikkerhedsmodel. I en overgangsperiode skal services også udstilles med certifikat og Myndighedskontekst Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliteter Ingen ekstrakrav Konfiguration Ingen kendt 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. KOMBIT A/S Halfdansgade København S CVR Side 21 af 22

22 ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TSP01 Registrering af Klassifikation og udstillede services i STS Organisation Konfiguration STS Organisa- tion KOMBIT/ KDI KOMBIT/ KDI Fase 1 TSP02 Registrering af Serviceinformation for Klassifikation i Serviceplatformen Konfiguration Serviceplatformen KOMBIT/ KDI KOMBIT/ KDI Fase 1 TSP03 Registrering af serviceinformation for Klassifikations i Admini- Konfiguration Administrationsmodul KOMBIT/ KDI KOMBIT/ KDI Fase 1 strationsmodul TSP01 - Klassifikation skal oprettes STS Organisation, hvis dette ikke allerede er sket, herunder de services, som udstilles af Klassifikation, og som er beskrevet i denne Snitflade. TSP02 - Der skal registres information vedrørende Klassifikation i Serviceplatformen, så der kan oprettes serviceaftaler for tilslutningspartner (kommuner), bl.a. skal logiske og fysiske endpoint skal være relateret. TSP03 - Klassifikation skal oprettes i STS Administrationsmodul, herunder de services, operation, som udstilles. Yderligere skal de services, som Serviceplatformen udstiller på baggrund af Klassifikation registres. 5 Noter vedr. beslutning, detaljer og andet Noter vedr. beslutninger, etc. Dette afsnit medsendes hverken til kilde, bestiller, Systematic eller andre. Det er rent KDF-internt. KOMBIT A/S Halfdansgade København S CVR Side 22 af 22