Integration SF Ledelsesinformation - dataload Integrationsbeskrivelse - version 2.0.0

Transkript

1 Integration Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer TBD 0.1 Første version TBD Fase TBD Fase 2 inkl. SSE review EDM Opdateret med FLIS/LIS fordeling på Serviceplatform JJN 0.5 Tilføjelse af SFTP MHO Referencerettelser mm EHE Teknisk beskrivelse godkendt Referencer Ref Titel Kommentarer [SPref] [SIKKERHED] [STS- Sikkerhed] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: 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 [SFTP] <Indsæt dokumentation af SFTP> Endnu ikke udarbejdet KOMBIT A/S Halfdansgade København S CVR Side 2 af 24

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning af integration Kontekst for integrationsparter Kontekst for KY Kontekst for KSD Specifikation for integrationsparter Specifikation af endpoints for KY og KSD Specifikation af endpoints for FLIS/LIS Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 24

4 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med snitfladen er at kunne levere et dataudtræk til Serviceplatformen, så kommunerne kan udarbejde detaljeret ledelsesinformation på ydelsesområdet. Fagsystemet skal således stille data til rådighed for den kommunale eller fælleskommunale ledelsesopfølgning gennem kommunernes egne ledelsesinformationssystemer (LIS) eller gennem det fælleskommunale ledelsesinformationssystem (FLIS). Dataudtrækket skal derfor i udgangspunktet dels leveres til FLIS som flere kommuner pt. er tilsluttet og dels op til 98 separate kommuners LIS systemer. Det konkrete dataudtræk kan være afgrænset tidsmæssigt og vil bestå af udvalgte entiteter fra den pågældende datamodel. Dataudtrækket vil være specificeret ens, hvad enten det leveres til FLIS eller kommunernes egne ledelsesinformationssystemer (LIS). 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystemet sender dataudtræk bestående af udvalgte entiteter fra datamodellerne i en dataudtræksfil samt en trigger-fil (routing til modtagere) Serviceplatformen modtager dataudtrækket på SFTP serveren og persisterer data på modtagernes destinationsmapper. I trigger-filen kan det således være angivet, at dataudtrækket både skal leveres til FLIS samt kommunernes egne ledelsesinformationssystemer (LIS). FLIS og LIS henter persisteret data på Serviceplatformens SFTP server FLIS og LIS sletter persisteret data på Serviceplatformens SFTP server KOMBIT A/S Halfdansgade København S CVR Side 4 af 24

5 SF1630 Ledelsesinformation - Dataload Dataudtræk via SFTP Serviceplatform Fagsystem Send dataudtræk SFTP put Persistering SFTP get SFTP delete FLIS/LIS Periodisk Hent dataudtræk 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Ledelsesinformation Dataload Tidsrum Svartid Tilgængelighed Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 KOMBIT A/S Halfdansgade København S CVR Side 5 af 24

6 % i den øvrige tid [SPref]. Spidsbelastningsperiode Servicevinduer Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. 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] 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å integrationen?] Problem Management [Afklaring/Programmet rejst emne: Skal der være SPOC på integrationen?] Change Management [Afklaring/Programmet rejst emne: Skal der være SPOC på integrationen?] Lifecycle Management Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] KOMBIT A/S Halfdansgade København S CVR Side 6 af 24

7 1.4 Teststrategi Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Testfaciliteter og testmiljø Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 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 Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.5 Forudsætninger for produktionssætning af integration Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter. KOMBIT A/S Halfdansgade København S CVR Side 7 af 24

8 1.5.1 Forudsætninger for funktionalitet på Serviceplatformen Forudsætningen for at kunne integrere via SFTP løsningen på Serviceplatformen er at integrationspartnerne skal være oprettet som bruger på Serviceplatformen, og systemet skal være registreret med et certifikat. Simpel SFTP skal vælges for hver af systemerne og der skal angives SFTP bruger og public nøgle. For yderligere information vedrørende anvendelse, se Vejledning til Serviceplatformens SFTP Service, som er tilgængelig på serviceplatformens informationssider Generelle forhold for tilslutning til integrationspart: KY og KSD Fagsystemerne skal, for at kunne levere information til Kommunernes ledelsesinformationssystemer, dels registre systemet, men også de SFTP brugere, der skal anvendes i kommunikationen. Tilsvarende skal FLIS/LIS systemerne være oprettet som brugere på Serviceplatformens SFTPserver. Hver kommune kan have mere en et LIS. 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 it-systemer 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 Itsystemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP]. [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] Generelle forhold for tilslutning til integrationspart: FLIS/LIS Til brug for adgang til produktion benyttes Serviceplatformens SFTP-server (jf. Løsningsmodel 1). 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 it-systemer 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 Itsystemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP]. KOMBIT A/S Halfdansgade København S CVR Side 8 af 24

9 [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] KOMBIT A/S Halfdansgade København S CVR Side 9 af 24

10 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål [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.] 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 Volumen på det endelige dataudtræk er pt. ukendt og skal aftales, når det endelige omfang kendes i KY. Det kan dog oplyses, at det nuværende dataudtræk fra KMD sendes som CSV fil og fylder ca. 7,7 Gigabyte pr. måned. Det er på nuværende tidspunkt ikke specificeret, hvorvidt det endelig format vil være eksempelvis XML, JSON eller CSV. Den estimerede volumen ovenfor vil således være større, såfremt der vælges et andet format end CSV. Endvidere skal det påregnes, at dataudtrækket skal leveres til både FLIS og kommunernes egne ledelsesinformationssystemer, hvor sidstnævnte leveres i 98 kommunespecifikke dataudtræk. [Afklaring/SSE: KSD/Jan Dynnesen efterspørger, at SSE oplyser, hvilke grænseværdier der er gældende på Serviceplatformen i forbindelse med volumen på dataudtræk.] Specifikke forhold for tilslutning af system Ingen identificeret. 2.2 Kontekst for KSD Lovhjemmel og forvaltningsmæssigt formål [Udfyldes med oplysninger om hvilke(n) lovhjemmel der findes for systemets anvendelse af servicen] Det forvaltningsmæssige formål er at [ ] KOMBIT A/S Halfdansgade København S CVR Side 10 af 24

11 [Udfyldes med en kortfattet beskrivelse af de forvaltningsmæssige formål med anvendelse af servicen.] Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indehold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering Kapacitets- og servicekrav Volumen på det endelige dataudtræk er pt. ukendt og skal aftales, når det endelige omfang kendes i KSD (jf. afklaringsfase med leverandør). Det kan dog oplyses, at det nuværende dataudtræk fra KMD sendes som CSV fil, og det anslås på den baggrund, at dataudtrækket vil fylde 0,5 2 Gigabyte pr. måned. Det er på nuværende tidspunkt ikke specificeret, hvorvidt det endelig format vil være eksempelvis XML, JSON eller CSV. Den estimerede volumen ovenfor vil således være større, såfremt der vælges et andet format end CSV. Endvidere skal det påregnes, at dataudtrækket skal leveres til både FLIS og kommunernes egne ledelsesinformationssystemer, hvor sidstnævnte leveres i 98 kommunespecifikke dataudtræk. [Afklaring/SSE: KSD/Jan Dynnesen efterspørger, at SSE oplyser, hvilke grænseværdier der er gældende på Serviceplatformen i forbindelse med volumen på dataudtræk.] Specifikke forhold for tilslutning af system Ingen identificeret. KOMBIT A/S Halfdansgade København S CVR Side 11 af 24

12 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY og KSD Integrationen benyttes af fagsystemet til at levere et dataudtræk via Serviceplatformens SFTPserver (jf. Løsningsmodel 1). FLIS/LIS kan derefter tilgå dataudtrækket i en specifik FLIS/LIS folder, som er nærmere specificeret i den separate trigger-fil med metadata, der angiver modtager. De to fagsystemer kommunikerer forskelligt indhold af filen til FLIS/LIS, men da det er transparent for Serviceplatformen, benyttes fælles endpoint Overordnet forretningslogik Fagsystemet leverer dataudtræk samt separat trigger-fil med metadata via Serviceplatformens SFTP-server via den Simple SFTP løsning. Endpoint EP_FS1 repræsenterer PUT på Serviceplatformens SFTP-server (jf. Løsningsmodel 1), men det skal bemærkes, at der når triggerfilen er behandlet placeres en kvittering i den tilhørende udmappe med besked om succes eller fejl i overførelsen Oversigt over endpoints ID Navn EP_FS1 dataudtraek_put Beskrivelse af endpoint EP_FS1 - dataudtraek_put Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret med som PUT på Serviceplatformens SFTP-server (jf. Løsningsmodel 1). Der skal altid leveres to filer; en fil med data og en trigger-fil med routing information. KOMBIT A/S Halfdansgade København S CVR Side 12 af 24

13 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion SFTP platform: Host IP SFTP bruger: FLIS/LIS KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] mange - se kapitel Generelle forhold for tilslutning til integrationspart: KY og KSD [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL Følgende specificerer endpoint-oplysninger for testmiljø: Miljø: Test SFTP platform: Host IP SFTP bruger: FLIS/LIS KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] mange - se kapitel Generelle forhold for tilslutning til integrationspart: KY og KSD [Afklaring/KDF oplysninger leveres af KY] - KY_SFTPSIMPEL [Afklaring/KDF oplysninger leveres af KSD] - KSD_SFTPSIMPEL Teknisk retning for udveksling Fagsystemet kalder SFTP-service på Serviceplatformen for at overføre filerne Dataretning for udveksling Fagsystemet overfører dataudtræk til FLIS/LIS via SFTP-server på Serviceplatformen Service invokation / Triggers Kommunikation initieres af, at fagsystemet har nyt dataudtræk, der skal indberettes til FLIS/LIS Dataspecifikation Specifikation af dataelementer i det endelige dataudtræk er pt. ukendt og skal aftales i afklaringsfasen med fagsystemets leverandør. Indholdet af routing-filen er defineret af Serviceplatformens SFTP Løsningsmodel 1. Datafilen fra KY indeholder følgende: [KY udfylder senere] Datafilen fra KSD indeholder følgende: KOMBIT A/S Halfdansgade København S CVR Side 13 af 24

14 [KSD udfylder senere] Ved overførelse af dataudtræk via SFTP skal der udformes en triggerfil, som skal ledsage en dataudtræksfil. Triggerfilen kan navngives frit, dog skal den have extension.trigger Der er ikke noget krav til at filnavnet skal være unikt, men i tilfælde af at en triggerfil med samme navn allerede eksistere i den folder, der ønskes at flyttes til, vil flytningen fejle indtil den blokkerede fil er blevet behandlet. Triggerfilen er XML baseret og skal indeholde information om forsendelsen, som vist nedenfor: Element Kardinalitet Forklaring Eksempel på værdi (Anvendt/ mulig) FileContentDescriptorType 1/1 Complex element N/A - (Any) 1/(0..*) Angiver typen af filen, og kan være: - LIS Angiver snitfladens referencenummer <FilType>LIS</FilType> <SF>1630</SF> Routinginformation 1/1 Complex element N/A - FileName 1/1 Der er ingen krav til navngivning af datafile, men det er dog hensigtsmæssig at den i en hvis grad er unik af hensyn til sporbarhed. Dog må den ikke have extension.trigger. KYDATA csv - SizeInBytes 1/1 Størrelsen af datafil i bytes Sender 1/1 SFTP bruger f.eks. KY, SAPA, KSD. [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] KY_SFTPSIMPEL eller KSD_SFTPSIMPEL KOMBIT A/S Halfdansgade København S CVR Side 14 af 24

15 - SendersFileId 0..*/0..* Der er valgfrit for afsendelsessystem om der medgives ID-er der kan identificere filen. TBD Dette er en string, som ikke er defineret med en begrænsning. [Afklaring/SP: Antal og længde af streng er ikke identificeret] - Recipients 1/(1..*) SFTP brugere f.eks. Serviceplatform De enkelte FLIS/LIS systemer skal have deres egen SFTP bruger. IKAST- BRAN- DE_LIS01_SIMPEL [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] Fagsystemerne skal hente Recipients fra Organisations IT-systemer, hvor alle kommunens LIS systemer inkl. FLIS skal være defineret Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIK- KERHED] Leverancesikkerhed og fejlhåndtering Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er afsendersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: Der placeres en datafil uden at der efterfølgende placeres en triggerfil. KOMBIT A/S Halfdansgade København S CVR Side 15 af 24

16 Der placeres en datafil og en triggerfil med fejl f.eks. forkert xml format eller modtagersystem findes ikke. Afsendersystem modtager en teknisk fejl fra SFTP, og skal selv slette datafilen. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage 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 Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. 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] Service Management Incident Management [Afklaring/Programmet rejst emne: Skal der være SPOC på integrationer] KOMBIT A/S Halfdansgade København S CVR Side 16 af 24

17 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 FLIS/LIS Integrationen benyttes af kommunernes FLIS/LIS, som kan tilgå dataudtrækket i en specifik FLIS/LIS folder, som er nærmere specificeret i den separate trigger-fil med metadata, der angiver modtager Overordnet forretningslogik KY og KSD leverer dataudtræk samt separat trigger-fil med metadata via Serviceplatformens SFTP-server (jf. Løsningsmodel 1), som FLIS/LIS efterfølgende henter og sletter. Endpoint EP_FLIS1 repræsenterer Serviceplatformens SFTP-server (jf. Løsningsmodel 1). Operttionerne GET og DELETE anvendes af FLIS/LIS Oversigt over endpoints ID Navn EP_FLIS1 dataudtraek_get_delete KOMBIT A/S Halfdansgade København S CVR Side 17 af 24

18 3.2.3 Beskrivelse af endpoint EP_FLIS1 - dataudtraek_get_delete Transportspecifikation Serviceudstiller Serviceplatformen er serviceudstiller Serviceanvender FLIS/LIS er serviceanvender Teknologisk understøttelse Snitfladen er implementeret med Serviceplatformens SFTP-server (jf. Løsningsmodel 1) Teknisk endpoint Afhentning og sletning af dataudtræk foretages via det tekniske endpoint, EP_FLIS1. Miljø: Produktion Endpoint navn [Udfyldes af Systematic senere] Endpoint IP [Udfyldes af Systematic senere] Teknisk retning for udveksling FLIS/LIS kalder SFTP-server på Serviceplatformen for at hente/slette filer Dataretning for udveksling FLIS/LIS henter dataudtræk på SFTP-server på Serviceplatformen Service invokation / Triggers Kommunikation initieres af en timer hos FLIS/LIS, der initierer et månedligt opslag. Hvis triggerfilen mangler, vil FLIS/LIS gentage kaldet med jævne mellemrum Dataspecifikation Specifikation af dataelementer i det endelige dataudtræk og trigger-filen er beskrevet i afsnit Miljø: Produktion KOMBIT A/S Halfdansgade København S CVR Side 18 af 24

19 Inputdata [Udfyldes af Systematic senere] Outputdata [Udfyldes af Systematic senere] Miljø: Test Inputdata [Udfyldes af Systematic senere] ent_itype.xsd Outputdata [Udfyldes af Systematic senere] Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIK- KERHED] Leverancesikkerhed og fejlhåndtering Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er modtagersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: Der findes en datafil uden triggerfil. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi Tidsrum Svartid Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svar- KOMBIT A/S Halfdansgade København S CVR Side 19 af 24

20 tid/håndteringstider ikke] Tilgængelighed Spidsbelastningsperiode Servicevinduer Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. 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] 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] KOMBIT A/S Halfdansgade København S CVR Side 20 af 24

21 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] KOMBIT A/S Halfdansgade København S CVR Side 21 af 24

22 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 0. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. KY, KSD EP_FS1 Serviceplatformen IF01 Dataudtræk via SFTP EP_FLIS1 FLIS/LIS Dataretning Filoverførslen er baseret på SFTP standard use case 1, som er beskrevet i [SFTP] Oversigt over integrationsflows ID Navn IF01 Dataudtræk via SFTP Integrationsflow IF01: Dataudtræk via SFTP Anvendte service endpoints Endpoint ID Navn på endpoint Dokumentreference EP_FS1 Dataudtræk_PUT Afsnit EP_FLIS1 Dataudtræk_GET_DELETE Afsnit KOMBIT A/S Halfdansgade København S CVR Side 22 af 24

23 Integrationstype Integrationen er en filtransport, hvor KY og KSD uploader et dataudtræk med tilhørende trigger-fil til Serviceplatformens SFTP-server, hvorfra FLIS/LIS efterfølgende henter og sletter filerne Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KY, KSD Serviceplatform FLIS/LIS Afsend data fil Teknisk kvittering Afsend routing fil EP_FS1(PUT datafil) EP_FS1(PUT triggerfil) EP_FS1(kvittering) Læs routing fil Teknisk kvittering Læs data fil Slet routing fil Teknisk kvittering Slet data fil EP_FLIS1(GET triggerfil) EP_FLIS1(GET datafil) EP_FLIS1(DELETE triggerfil) EP_FLIS1(DELETE datafil) Et dataudtræk kan være fordelt til flere FLIS/LIS modtagere, som hver for sig henter og sletter filerne fra SFTP serveren. Diagrammet overfor viser flowet for en enkelt udveksling. Hvert system vil have egne SFTP bruger, afsendelses- og modtagelsesmappe Datatransformering Ingen krav Datapersistering Der er pt. ingen yderligere krav i forhold til Løsningsmodel Databerigelse Ingen krav. KOMBIT A/S Halfdansgade København S CVR Side 23 af 24

24 Routing Jf. Serviceplatformens SFTP-server, beskrevet i [SFTP] use case 1, vil Serviceplatformen ud fra Recipients i trigger-filen, flytte/kopiere dataudtrækket samt trigger-fil fra den modtagne indbakke på STP-serveren til modtagernes tilsvarende udbakke. I udgangspunktet sender fagsystemet kun ét dataudtræk der således routes til flere foldere på SFTP-serveren. Det skal på den baggrund være muligt både at sende dataudtræk til FLIS samt separat til de kommuner, der anvender andre systemer i forbindelse med ledelsesinformation (jf. LIS) Orkestrering Ingen krav Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIK- KERHED] Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration Ingen krav Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade København S CVR Side 24 af 24