Integration SF7002 Overfør Sortiment til abonnent Integrationsbeskrivelse - version 1.3.1

Transkript

1 Integration - version Kommunernes Data- og Infrastrukturfællesskab - KDI

2 Versionshistorik Dato Relevans Initialer Version Kommentarer KDI 1.0 Baseline KDI 1.1 Tilføjet HovedOplysninger samt KlasseUrnReference på klassen som KlasseReferrenceStrukturType KDI 1.2 Justering til Sortiment og Klassifikation informationsmodel og eksportformater. RegistreringVærdiIdentifikation er indført. Samlet KDI Ny baseline Antallet af detaljeringsregler der kan findes på en Registreringsværdi er begrænset til én. Der kan i tillæg være angivet én yderligere registreringsregel, som ikke indeholder detaljeringsværdier. Der er indført særskilte klasser for RegistreringVærdiRegel og RegistreringVærdiDetaljeringRegel - den sidste indeholdende liste med RegistreringVærdiDetaljering er. Registreringsværdier har fået egne identer. Det samme gælder detaljeringsværdier. KlassificeretElementReference er omdøbt til AnvendesAf- KlassificeretElement. SubstitueretKlassificeretElementReference er erstattet af det eksterne objekt KlassificeretElement DelSortiment har påført Type. Der skal mindst være et klassificeret element, der anvender et DelSortiment. Der skal mindst være et AnvendesAfItSystem i et Sortiment Afløser interim integrationsbeskrivelse. [Informationsmodel] RegistreringVærdiSupplement er nyt navn for RegistreringVærdi- DetaljeringRegel. Identifikation og titel samt reference til ØIRRegel er fjernet. Dette medfører, at der kan alene foretages frivillig detaljering af en Registreringsværdi. Substitutionsangivelse er fjernet fra Registreringsværdier. RegistreringVærdiRegel har ikke længere selvstændig ident og titel, men holder blot referencen til en Klasse der beskriver en regel. [Servicestrukturrapport] KlasseEjer tilføjet til KlasseReferenceStruktur Justering for STS-Klassifikation compliance: Definition af fælles vs. lokale Registreringsværdier. De fælles Registreringsværdier har samme ejer som Sortimentets ejer. Klassebeskrivelse er udvidet til 4096 tegn. BrugervendtNøgle er ændret fra 100 tegn til 50 tegn. KOMBIT A/S Halfdansgade København S CVR Side 2 af 28

3 Ændringer til [Informationsmodel] er afspejlet i servicens strukturer KDI Præciseringer, herunder indskærpelse af at integrationsparter i relation til denne integration er AbonnentItSystemInstans og Klassifikations Abonnementsadministration. Manglende afsnit vedr. forudsætning for Produktionssætning og Kontekst for integrationsparter er udarbejdet. KOMBIT A/S Halfdansgade København S CVR Side 3 af 28

4 Referencer Ref. Titel Kommentarer [GVF] [SFTP] [SFTPnoter] [SFTP AS] [Abonnementbestilling] Produktion: SortimentAbonnementBestilling - Produktion.xlsx [Hovedoplysninger] [Bilag] Integration Generelle vilkår og forudsætninger Findes her: Generelle vilkår og forudsætninger.pdf. Teknisk vejledning Serviceplatformen Findes her: Vejledning til Serviceplatformens SFTP Service Findes her: Vejledning til Serviceplatformens SFTP Service.pdf. SFTP - Anvendelsesnoter med relation til ØiR v.1.0 Findes her: Anvendelsesnoter med relation til ØiR v.1.0.pdf. Template for abonnenter af Sortimenter Findes her: [Bilag] NOT0746 Oprydningskonfiguration til SFTP Server - SF7002 AS.docx Bestillingsformular til Sortimenter Findes her: [Bilag] Exttest: SortimentAbonnementBestilling - Exttest.xlsx Transaktionsspor og Fejlbehandling ved servicekald Findes her: Transaktionsspor og Fejlbehandling ved servicekald.pdf. Bilagssamling til integrationsbeskrivelsen Findes her: under området Økonomi eller direkte med reference til SF7002, zip. Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes Den anbefales, at leverandører af fagsystemer og kildesystemer tager et kik her. Tekniskbeskrivelse af SFTP service på Serviceplatformen ØiR specifikke krav ifm. anvendelse af Serviceplatformens SFTP-service Forudfyldt template til brug for it-systemets overvågning af sin SFTP-dataleverance. Input til oprettelse hos Serviceplatformens Help Desk Interim blanket til bestiling af Abonnement Fælles datastruktur for services udstillet på Serviceplatformen. Indgår i servicens input og output payload Samler bilag, som knytter sig til integrationen. KOMBIT A/S Halfdansgade København S CVR Side 4 af 28

5 Ref. Titel Kommentarer [Informationsmodel] [Servicestrukturrapport] [ØIR Klassifikation] Indeholder ØiR domæne klassifikationer og sortimenter, samt en række fælles referenceklassifikationer. [KDI- Drift] [KDI- Test] Sortiment Informationsmodel Findes her: [Bilag] SF7002_V1 - Sortiment - Informationsmodel pdf Overfør Sortiment til Abonnent Servicestrukturrapport Findes her: [Bilag] SF7002 Overfør Sortiment til Abonnent - Servicestrukturrapport pdf ØiR Klassifikationssystemet Findes her: i mappen STS Klassifikationer/Økonomi Hjemmeside med informationer om drift og forvaltning af KDIs Services Hjemmeside med informationer om ibrugtagning og test af KDIs Services: Samlet informationsmodel for håndtering af dataudveksling Beskriver datastrukturen for servicen. Indeholder reference til relevante schemaer. KOMBIT A/S Halfdansgade København S CVR Side 5 af 28

6 Indholdsfortegnelse 1 Overordnet beskrivelse Læsevejledning Integrationens formål Overordnet forretningsflow i integrationen Generelle Begreber Servicebetingelser for den samlede integration Teststrategi Håndtering af legacy registreringer Forudsætninger for produktionssætning Kontekst for integrationsparter Fælles kontekst for AbonnentItSystemer Kontekst for Klassifikations Abonnementsadministration Kontekst for KY, KSD [!@KY@!][!@KSD@!] Specifikation for integrationsparter Specifikation af endpoints for Klassifikations Abonnementsadministration Specifikation af endpoints for SP [!@SP@!] Specifikation af Endpoints for Abonnent It Systemer Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@SP@!] Tilslutning til integrationspart: Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 6 af 28

7 1 Overordnet beskrivelse 1.1 Læsevejledning Iab. 1.2 Integrationens formål Integrationen tilvejebringer eksport af Sortimenter til abonnenter af disse. Sortimenter indeholder Registreringsværdier med reference til klassifikation. Hvert Sortiment udtrykker definerede Registreringsværdier i kontekst af udvalgte it-systeminstansers brug ift. en integration, IntegrationReference. 1.3 Overordnet forretningsflow i integrationen Forudsætning for distribution af Sortimenter er, at der i Klassifikations Abonnementsadministration er oprettet SortimentsAbonnementer. Hvert Abonnement gælder kombinationen af et AbonnentIt- System og en AbonnentJuridiskAnsvarligPart. Det er AbonnentJuridiskAnsvarligPart, der opretter Abonnementet. Indtil der er udvikle et nyt Abonnementsbestillingssystem vil oprettelse af Abonnement på et Sortiment foregå via indsendelse af [Abonnementsbestilling] til KOMBIT mailto:kdi@kombit.dk. Der kan abonneres på det fulde Sortiment, hvis AbonnentItSystem er den it-systeminstans Sortimentet er anvendelseskontekst for, SortimentAnvenderItSystem, og såfremt AbonnentJuridiskAnsvarligPart er lig Ejer af Sortiment. I det fulde Sortiment indgår både fællesdata og lokale data. Hvis dette ikke er tilfældet, så vil Sortiment leverancer altid bestå af fællesdata eventuelt suppleret med de lokale data, hvor Ejer af RegistreringVærdi/RegistreringVærdiDetaljering er lig Abonnent- JuridiskAnsvarligPart. Data distribueres fortløbende, når der er sket en ajourføring i Klassifikationssystemet. Det er kun de Sortimenter, som er berørt af ajourføringen, som distribueres. Det er muligt at anmode om initiel forsendelse samt genfremsendelse. Kommunikationen foregår inden for samme jurisdisk ansvarlig part. Integrationen er begrebsmodelleret ud fra den overordnede og Sortiment domæne model. De anvendte forretningsmæssige begreber i integrationen fremgår af integrationens informationsmodel [Informationsmodel]. Integrationen benytter sig af en teknisk datastruktur kaldet hovedoplysninger. Dens begreber og anvendelse er angivet her [Hovedoplysninger]. Nedenfor er angivet enkelte begreber, som er nyttige for læsningen af integrationsbeskrivelsen. KOMBIT A/S Halfdansgade København S CVR Side 7 af 28

8 1.4 Generelle Begreber SortimentAnvenderItSystem Abonnement Abonnent AbonnentItSystem Den it-systeminstans, der er primær anvender af Sortimentets Registrering- Værdier. Den it-systeminstans Sortimentet er anvendelseskontekst for. En aftale om leverance af et Sortiment og ændringer til dette fra Klassifikations Abonnementsadministration. Kombinationen af ItSystemInstans og Juridisk Ansvarlig Part, et Abonnement er oprettet for. Den Juridisk Ansvarlige Part kan enten være databehandleren eller den datataansvarlige for databehandlingen i ItSystemInstansen. Den ItSystemInstans, der indgår i Abonnement. Vil i Leverancens Hovedoplysninger figurere som ModtagerItSystemInstans. AbonnentJuridiskAnsvarligPart Den Jurisdisk Ansvarlig Part, der indgår i Abonnement. Vil i Leverancens Hovedoplysninger figurere som ModtagerOrganisation AfsenderItSystemInstans Det system, som distribuerer Sortimenter til abonnenter. Der er tale om den enkelte fysiske instans af et it-system, heraf navnet. I STS Administration anvendes begrebet it-system. Indgår i HovedOplysning, AfsenderItSystemInstans. Alias: Klassifikations Abonnementsadministration Teknisk repræsentation: UUID AfsenderOrganisation Den myndighed, som har dataansvar for datavideregivelse eller dataforespørgsel fra AfsenderItSystemInstans. Defineret i STS Organisation, som myndighed. Indgår i HovedOplysning, AfsenderOrganisation. Alias: Kommune, UDK, KOMBIT Teknisk repræsentation: urn:oio:cvr-nr:xxxxxxxx ModtagerItSystemInstans ItSystemet som abonnerer på Sortimentet. Der er tale om den enkelte fysiske instans af et it-system, heraf navnet. I STS Administrationsmodul anvendes begrebet it-system. Indgår i HovedOplysning, ModtagerItSystemInstans. Alias: Fagsystem, Anvendersystem, Bogføringssystem, Debitorsystem, ERP-løsning, ERP-system, Kildesystem, Abonnent Teknisk repræsentation: UUID Begrebsreference: AbonnentItSystemInstans. ModtagerOrganisation Juridisk Ansvarlig Part, som Abonnement tegnet for. Har dataansvar for datamodtagelse i ModtagerItSystemInstans. Defineret i STS Organisation, som myndighed. Indgår i HovedOplysning, ModtagerOrganisation. KOMBIT A/S Halfdansgade København S CVR Side 8 af 28

9 Alias: Kommune, UDK, KOMBIT Teknisk repræsentation: urn:oio:cvr-nr:xxxxxxxx Begrebsreference: AbonnentJuridiskAnsvarligPart. KOMBIT A/S Halfdansgade København S CVR Side 9 af 28

10 1.4.1 Diagrammer for forretningsflow Sortiment Distribution Flow Klassifikations Abonnentsadministration Overfør Sortiment Opbevar filer (SFTP Service) Serviceplatform Fordel til SFTPbruger Opbevar filer (SFTP Service) Abonnent ItSystem Hent Sortiment Figur 1 Sortiment overførsel flow Valg af integrationsmønster Distribution sker med Serviceplatformens SFTP service. Abonnenten forretningskvitterer ikke for modtagelsen af en forsendelse. Datareplikering fra en klassifikationsløsning til flere anvenderløsninger. Registreringer omfatter historik, dvs. gyldighedsperiode, hvor det er forretningsmæssigt relevant. Der anvendes netto-princip for dataudveksling, dvs. det samlede forretningsobjekt fremsendes, som det ser ud på forsendelsestidspunktet. Der kommunikeres ikke bi-temporalitet. KOMBIT A/S Halfdansgade København S CVR Side 10 af 28

11 Første registreringstidspunkt og senest redigeringstidspunkt er angivet for forretningsobjektet eller vil kunne udledes af et overordnet forretningsobjekt Ajourføring af forekomster Servicesstrukturmodellen angiver, hvilke attributter, som kan ajourføres, samt hvilket senest redigeringstidspunkt som en sådan redigering vil knytte sig til Princip for sletning Sortimenter kan ikke slettes DelSortimenter, Registreringsværdier mv. kan slettes, såfremt dataforekomsten har en gyldigfradato, som ligger mindst 48 timer efter aktuelt tidspunkt, dvs. sletningstidspunktet Angivelse og håndtering af Personfølsomhed Der udveksles ikke personhenførbar information i integrationen. 1.5 Servicebetingelser for den samlede integration Servicemål Parameter Flow 1 Flow 2 Tidsrum Svartid Tilgængelighed Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om. Der er ingen SLA for SFTP-servicen, men jobbet på SP, som henter filer fra et it-systems Out-folder, kører hvert 5. minut, hvorefter der dannes kvitteringsfil. Man kan forvente at modtage kvitteringsfil i it-systemets In-folder inden for 15 minutter. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om. Der er ingen SLA for SFTP-servicen, men jobbet på SP, som henter filer fra et it-systems Out-folder, kører hvert 5. minut, hvorefter der dannes kvitteringsfil. Man kan forvente at modtage kvitteringsfil i it-systemets In-folder inden for 15 minutter. Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid KOMBIT A/S Halfdansgade København S CVR Side 11 af 28

12 Spidsbelastningsperiode Servicevinduer Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage 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: Op til 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 tidsrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage 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: Op til 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 tidsrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer Service Management Informationer om driftsmeddelelser, forespørgsler og kontaktinformationer, findes på siden for Drift og Forvaltning af KDIs Services her: [KDIDrift]. 1.6 Teststrategi Overordnet Det generelle udgangspunkt for KOMBITs teststrategi er, at alle involverede parter, dvs. fagsystemerne, Kildesystemerne og Serviceplatformen 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]. Da nærværende integration, SF7002, er essentiel for udveksling af data mellem parter i en række af KOMBITs integrationer, er den generelle teststrategi modificeret på flg. punkter: Der er indført mulighed for en særlig Sortiment integrationstest med hvert AbonnentItSystem. Når Sortiment integrationtest er succesfuldt gennemført kan resterende test gennemføres, fx fagsystemernes og Kildesystemers integrationstest og end-to-end-test. KOMBIT A/S Halfdansgade København S CVR Side 12 af 28

13 Sortiment integrationstest er gennemført med leverandørernes centrale udviklings-/testmiljøer. Da en række it-løsningerne er i decentral drift tilbydes myndighederne her, at der gennemføres en Tilslutningstest. Denne test gennemføres ift. testinstanser under den decentrale drift. Tilslutningstesten skal bestilles af myndigheden. Ifm. Serviceplatformens tilslutning af servicen og opkobling til den enkelte abonent it-systeminstans aktiverer Serviceplatformen sin overvågning af it-systeminstansens SFTP-bruger. Der foretages ikke test af denne overvågning Test i forbindelse med udvikling på Serviceplatformen Integrationen indeholder ikke udvikling på Serviceplatformen. Standard SFTP-servicen anvendes. Denne test gennemføres derfor ikke Testfaciliteter og testmiljø Nil Testdata Nil Test i forbindelse med AbonnentItSystemers serviceanvendelse AbonnentItSystemer gives mulighed for at afprøve modtagelse af relevante Sortimenter, samt opdateringer til disse. Denne test kaldes Sortiment integrationstest. Afprøvning af dataudveksling med brug af referencedata i Sortimenter afprøves i de enkelte integrationer, som benytter Sortimenter som referencedata. Der henvises til n for den enkelte integration, IntegrationReference Testfaciliteter og testmiljø Sortiment integrationstesten gennemføres fra Exttest-miljøet under Serviceplatformen. I forbindelse med gennemførelse af Sortiment integrationstesten kan AbonnentItSystemet vælge at afprøve modtagelse af egne Sortimenter udarbejdet i Exttest miljøet. Derudover udarbejder KDI en række repræsentative Sortimenter som kan benyttes i afprøvningen Sortiment - Tilslutningstest For de it-løsninger, som har decentral drift, tilbydes en implementeringstest. Testen har til formål at verificere at abonnent-systemet kan modtage Sortiment. Dette tilbydes for it-systemer der alene benytter Sortimentet internt. KOMBIT A/S Halfdansgade København S CVR Side 13 af 28

14 Testfaciliteter og testmiljø Testen gennemføres i Exttest-miljø Testdata Der anvendes de test-sortimenter AbonnentItSystemet har tegnet Abonnement på Produktionsverifikationstest Testen har til formål at verificere at abonnent-systemet kan modtage Sortiment. Dette tilbydes for it-systemer der alene benytter Sortimentet internt Testfaciliteter og testmiljø Testen gennemføres i Produktion Testdata Der anvendes de produktionssortimenter AbonnentItSystemet har tegnet Abonnement på. 1.7 Håndtering af legacy registreringer NIL. 1.8 Forudsætninger for produktionssætning For at kunne anvende snitfladen er der en række vilkår og forudsætninger, som skal være opfyldt af en tilslutningspart, der skal tilsluttes. Ved tilslutningspart skal forstås AbonnentItSystem, Klassifikations Abonnementsadministration. Disse vilkår og forudsætninger er opdelt i 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 snitfladen. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter, der skal udføres som forudsætning for tilslutning af en tilslutningspart, er beskrevet for hver enkelt tilslutningspart i kapitel Køreplan for Implementering Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse Kildesystem og myndighed: Når myndigheden ibrugtager et Kildesystem, der forudsætter anvendelse Sortiment til bestemmelse af værdilister skal Kildesystemets abonnementer på myndighedens Sortimenter etableres. Der skal etableres abonnementer på myndighedens Sortimenter for de ItSystemInstanser, som Kildesystemet behøver at kende for at foretage dataudveksling via de integrationer Kildesystemet udstiller. Disse sortimenter fremgår af Integrationbeskrivelsen for den enkelte integration. Kildesystemet er i denne sammenhæng AbonnentItSystem. KOMBIT A/S Halfdansgade København S CVR Side 14 af 28

15 Anvendersystem og myndighed: Når myndigheden ibrugtager et Anvendersystem, der benytter anvendelse af Sortiment, skal Anvendersystemets abonnement på Sortimentet etableres. Anvendersystemet er i denne sammenhæng AbonnentItSystem Særlige vilkår [Til brug for servicekataloget på serviceplatformen er der behov for kort at beskrive vilkår der er specifikke for den pågældende integration. Det vil typisk være indgåelse af aftale mellem anvendersystem og kildesystem. Aftale inde for rammearkitekturen skal ikke beskrives. Er der ingen specifikke vilkår for integrationen anvendes nedenstående tekst. Vilkår for servicen 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 Ingen KOMBIT A/S Halfdansgade København S CVR Side 15 af 28

16 2 Kontekst for integrationsparter Nedenstående afsnit angiver implementeringsopgaver for henholdsvis AbonnentItSystemInstans og Klassifikations Abonnementsadministration. Implementeringsopgaverne er opdelt efter hvem der har ansvaret for at opgaven bliver udført. Det er Fagprojekt for SortimentAnvenderItSystem der tager initiativ til opsætning af integrationen. 2.1 Fælles kontekst for AbonnentItSystemer Implementeringsopgaver Faserne følger afsnit 1.8. ID Aktivitet Opgavekategori Ansvarlig Komponent Udførende Fase og afhængighed Kommentar TS101 AbonnentItSystem skal være oprettet i Administrationsmodul ift. anvendelse af SFTP- Servicen Konfiguration STS Administrationsmodul Leverandør af AbonnentItSystem Leverandør af AbonnentItSystem TS102 Bestil abonnement på sortiment til AbonnentItSystem Konfiguration Klassifikations Abonnementsadministration Leverandør af AbonnentItSystem Leverandør af AbonnentItSystem TS103 Bestil overvågning af AbonnentItSystem SFTP-bruger ift. sortimentsmodtagelse Konfiguration Serviceplatformen Leverandør af AbonnentItSystem Leverandør af AbonnentItSystem Benyt [SFTP AS] TS101 - AbonnentItSystem skal være oprettet i STS Administrationsmodul. Der skal være angivet anvendelse af Simpel Filtransport, Dynamic Routing. SFTP-bruger skal være oprettet inklusiv SSH-nøgle. TS102 - Bestil abonnement på sortiment til AbonnentItSystem. Bestillingsblanketter findes i bilagsfilerne til integrationen [Bilag]. TS103 - Der skal bestilles overvågning af AbonnentItSystem SFTP-bruger ift. sortimentsfiler. Det sker med brug af skabelonen [SFTP-AS]. Det sker som en bestilling til Serviceplatformens Help Desk. KOMBIT A/S Halfdansgade København S CVR Side 16 af 28

17 KOMBIT A/S Halfdansgade København S CVR Side 17 af 28

18 2.2 Kontekst for Klassifikations Abonnementsadministration Implementeringsopgaver ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS200 Klassifikations Abonnementsadministration skal være oprettet i STS Administrationsmodul ift. anvendelse af SFTP-Servicen Konfiguration STS Administrationsmodul Leverandør af Klassifikations Abonnementsadministration Leverandør af Klassifikations Abonnementsadministration Fase 1 (er gennemført) TS201 Bestil SFTProuting af sortimentet til AbonnentItSystem Konfiguration Klassifikations Abonnementsadministration Fagprojektet/Central administrator Fagprojektet/Central administrator TS101 Sker som en del af effektueringen af TS106 TS202 Anmodning om Serviceaftaler for dataansvarlig myndighed ift. Abonnementet Konfiguration STS Administrationsmodul Klassifikations Abonnementsadministration Central Administrator eller Lokal administrator Klassifikations Abonnementsadministration Central Administrator eller Lokal administrator TS203 Dataansvarlig myndighed ift. Abonnementet skal godkende serviceaftale for integrationen Konfiguration STS Administrationsmodul Dataansvarlig myndighed ift. Abonnement skal godkende serviceaftale for integrationen Dataansvarlig myndighed ift. Abonnement skal godkende serviceaftale for integrationen KOMBIT A/S Halfdansgade København S CVR Side 18 af 28

19 TS200 - Klassifikations Abonnementsadministration skal være oprettet i STS Administrationsmodul. Der skal være angivet anvendelse af Simpel Filtransport, Dynamic Routing. SFTP-bruger skal være oprettet inklusiv SSH-nøgle. TS201 - Bestil routing af sortimentet fra Klassifikations Abonnementsadministration til AbonnentIt- System. InfRef: SF7002_01, Explicit routing. Det sker som en bestilling til Serviceplatformens Help Desk. TS202 - I STS Administration skal der oprettes en anmodning om indgåelse af serviceaftale for abonnerende myndigheds brug af integrationen, SF7002_V1 IF01. Anmodningen skal indeholde angivelse af dataansvarlige myndighed for AbonnentItSystem TS203 - Dataansvarlig myndighed ift. Abonnement skal godkende serviceaftale for integrationen 2.3 Kontekst for KY, KSD [!@KY@!][!@KSD@!] Nil. KOMBIT A/S Halfdansgade København S CVR Side 19 af 28

20 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for Klassifikations Abonnementsadministration Integrationen benyttes til at sende Sortimenter fra Klassifikations Abonnementsadministration til AbonnentItSystemer Overordnet forretningslogik Serviceplatformens SFTP-Service benyttes af Klassifikations Abonnementsadministration til at overføre Sortimenter til AbonnentItSystem. Klasssifikation modtager ikke forretningskvitteringer på sine overførsler. Servicen indeholder een forretningsmæssig operation Overordnet forretningslogik Klassifikations Abonnementsadministration skal understøtte overførsel af filer via serviceplatformens SFTP Service på endpoint EP_FS Oversigt over endpoints ID Navn EP_FS1 SortimentLeveranceOverfoer Beskrivelse af endpoint EP_FS1 SortimentLeveranceOverfoer Transportspecifikation Serviceudstiller Serviceplatformen udstiller SFTP-servicen Serviceanvender Klassifikations Abonnementsadministration systemet er serviceanvender af Serviceplatformens SFTP-service Teknisk endpoint Snitfladen er implementeret som SFTP, [SFTP]. Der anvendes Simpel Filtransport Dynamic Routing Dataspecifikation Data omfatter en datafil med Sortimentets indhold, styringsfilen triggerfil samt den teknisk kvitteringsfil, receipt Datafil Datafilen indeholder Sortimentets indhold. KOMBIT A/S Halfdansgade København S CVR Side 20 af 28

21 Strukturen er angivet i [Servicestrukturrapport]. Datastrukturen er etableret på basis af informationsmodellen Sortiment, [Informationsmodel]. Datafilen refereres i triggerfilen Triggerfil Triggerfilen skal oprettes ud fra anvisninger i [SFTP-noter], der supplerer den generelle vejledning i [SFTP] Der anvendes Explicit-routing. <SFTPDynamicRoutingInfo> strukturen skal vælges i FileContentDescriptor, jf. xsd er, som kan hentes via link i [SFTP]. Feltnavn Niveau Kardinalitet Format Værdisæt / note 1 FileContentDescriptor 7 SFTPDynamicRoutingInfo 1 <InfRef> SF7002_01 </InfRef> 2 <SenderIt-system> [UUID (Klassifikation ID)] </SenderIt-system> 3 <SenderAuthority> [urn:oio:cvr-nr:nnnnnnnn] </SenderAuthority> 4 <TransaktionsId> [UUID] </ TransaktionsId> 5 <TransaktionsTid> [DateTime] </TransaktionsTid> 6 <RecipientIt-system> [UUID (AbonnentItSystem ID)] </RecipientIt-system> 7 <RecipientAuthority> [urn:oio:cvr-nr:nnnnnnnn] </RecipientAuthority> = SF7002_01 UUID for Klassifikations Abonnementsadministration, ItSystemInstans. = AfsenderItSystemInstans Cvr-nummer for dataansvarlig for AbonnentItSystem. = AfsenderOrganisation TransaktionsID, generet af fagsystemet ifm. dannelsen af triggerfilen. Tidsstempel for triggerfilens dannelse. UUID for AbonnentItSystem, It- SystemInstans. = AfsenderItSystemInstans Cvr-nummer for dataansvarlig for AbonnentItSystem. = ModtagerOrganisation 1 FileDescriptor 1 Complex element - FileName 1 String Navn på den korresponderende datafil. Se [SFTP-noter] - SizeInBytes 1 Integer Størrelse af datafil KOMBIT A/S Halfdansgade København S CVR Side 21 af 28

22 Feltnavn Niveau Kardinalitet Format Værdisæt / note - Sender 1 String(250) SFTP-Bruger gældende for Klassifikations Abonnementsadministration. - SendersFileId 1 String(250) Korrelationsident, se [SFTP-noter] - Recipients 1 String(250) ROUTING_V1_0_0 Tabel 1 - EP_FS1 - Triggerfil Teknisk kvitteringsfil Klassifikations Abonnementsadministration henter i sin In-mappe på SFTP-servicen en teknisk transportkvittering. Den findes unikt via SendersFileId. Klassifikations Abonnementsadministration skal efter afhentning slette den tekniske kvitteringsfil på SFTP-servicen Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformens SFTP-server er SSH-baseret [SFTP] Leverancesikkerhed og fejlhåndtering Der udveksles tekniske kvitteringsfil fra SFTP-servicen til Klassifikation Distribtion 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 [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af den maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid inden for aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] KOMBIT A/S Halfdansgade København S CVR Side 22 af 28

23 3.2 Specifikation af endpoints for SP NIL KOMBIT A/S Halfdansgade København S CVR Side 23 af 28

24 3.3 Specifikation af Endpoints for Abonnent It Systemer Integrationen benyttes til at modtage og håndtere Sortimentsleverancer fra Klassifikations Abonnementsadministration gennem Serviceplatformen (ØiR) Specifik håndtering i det enkelte AbonnentItSystem NIL Overordnet forretningslogik AbonnentItSystemet skal understøtte modtagelse af filer via Serviceplatformens SFTP filer på endpoint EP_AS Oversigt over endpoints ID Navn EP_AS1 SortimentLeveranceOverfør Beskrivelse af endpoint EP_AS1 - SortimentLeveranceOverfoer Transportspecifikation Serviceudstiller Serviceplatformen udstiller SFTP-servicen Serviceanvender AbonnentItSystemet er serviceanvender af Serviceplatformens SFTP-service Teknisk endpoint Snitfladen er implementeret som SFTP, [SFTP] Dataspecifikation Data omfatter en datafil med Sortiments-indhold samt en styringsfil, metadatafil Datafil Datafilen indeholder indholdet af et Sortiment. Strukturen er angivet i [Servicestrukturrapport]. Her findes også de valideringsregler, som AbonnentItSystemet skal gennemføre. Datastrukturen er etableret på basis af informationsmodellen for dataudveksling under domænet Sortiment, [Informationsmodel]. Datafilen findes ud fra metadatafilen. KOMBIT A/S Halfdansgade København S CVR Side 24 af 28

25 Metadatafil Referencen til servicen i metadatafilen er: InfRef : SF7002_ Sikkerhed Sikkerhed mellem AbonnentItSystemet og Serviceplatformens SFTP-server er SSH-baseret [SFTP] Leverancesikkerhed og fejlhåndtering AbonnentItSystemet kvitterer for den tekniske overdragelse af dataleverancen af Sortiment ved at slette hhv. datafil og metadatafil fra sin In-mappe Servicemål AbonnentItSystemet skal løbende hente datafiler fra SFTP-service. Som minimum skal der afhentes [1 gang i døgnet]. AbonnentItSystemets In-mappen på SFTP-servicen vil blive monitoreret af Serviceplatformen. Der vil blive rejst et incident over for AbonnentItSystemet, såfremt datafiler ikke afhentes inden for det aftalte tidsrum. Det forudsætter, at AbonnentItSystemet opsætter overvågning af In-mappe og Outmappe for sin SFTP-bruger. Overvågning gælder de datafiler og styringsfiler, som indgår i integrationen. Vejledning findes her [SFTP]. Der er udarbejdet skabeloner herfor [SFTP AS] Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af den maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid inden for aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] KOMBIT A/S Halfdansgade København S CVR Side 25 af 28

26 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. Integrationen understøttes af to sammenhængende integrationsflow, anmodning med tilhørende asynkront svar. Integrationen er specificeret efter KDIs contract first. Den fulde specifikation med reference til nødvendige underbilag er give her [Servicestrukturrapport]. Specifikationen indeholder de endpoints, som er beskrevet for integrationsparterne, jf. ovenstående afsnit 2. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. Serviceplatformen Klassifikations Abonnementsadministration EP_FS1 IF01 EP_AS1 Abonnent ItSystem Integrationen understøttes i sit fulde omfang af Serviceplatformens SFTP-Service Oversigt over integrationsflows ID Navn IF01 SortimentLeverance KOMBIT A/S Halfdansgade København S CVR Side 26 af 28

27 4.1.2 Integrationsflow IF01: Klassifikations Abonnementsadministration Overfør Anvendte service endpoints Endpoint ID Navn på endpoint Dokumentreference EP_FS1 SortimentLeveranceOverfør [Servicestrukturrapport] EP_AS1 SortimentLeveranceOverfør [Servicestrukturrapport] Integrationstype SFTP Simpel Filtransport, Dynamic Routing, Implicit. InfRef : SF7002_ Overvågning Der bestilles overvågning jf. standardskabelonerne: [SFTP AS] KOMBIT A/S Halfdansgade København S CVR Side 27 af 28

28 4.2 Tilslutning til integrationspart: Serviceplatformen Dette kapitel lister 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 Konfiguration Registrering af Serviceinformation SFTP-overvågning SSE SSE Fase 1 TSP01 - Reference ift. bestilling af SFTP-overvågning. KOMBIT A/S Halfdansgade København S CVR Side 28 af 28