Integration - version 1.3.0 Kommunernes Data- og Infrastrukturfællesskab - KDI
Versionshistorik Dato Relevans Initialer Version Kommentarer 23.11.2017 KDI 1.0 Baseline 08.12.2017 KDI 1.1 Tilføjet HovedOplysninger samt KlasseUrnReference på Klasse 26.04.2018 KDI 1.2 KlasseRegel tilføjet Samlet 17.07.2018 KDI 1.3.0 Ny baseline Afløser interim integrationsbeskrivelse. [informationsmodel] FacetPlan, FacetPlanElement, KlasseRelation og KlasseReleationType er fjernet aht. alignment til STS-Klassifikation. KlasseRegel har ikke egen ident og titel, men i stedet reference og titel på en klasse, der holder KlasseReglen. [Servicestruktur] Fejlrettelse: KlasseRegelListe er fjernet. Der kan højest være én regel på en klasse. KlasseRegels attributnavne KlasseRegelidentifikation og Klasse- RegelTitel er ændret til hhv. ØIRRegelIdentifikation og ØIRRegel- Titel. KlasseRelation og KlasseRelationType er fjernet for at aligne med STS-Klassifikation. FacetPlan og FacetPlanElemet er er fjernet for at aligne med STS Klassifikation. Tekstfelt Klassebeskrivelse har maxlength på 4.096 tegn. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 24
Referencer Ref. Titel Kommentarer [GVF] [SFTP] [SFTPnoter] [SFTP AS] [Abonnementbestilling] Produktion: KlassifikationAbonnementBestilling - Produktion.xlsx [Hovedoplysninger] [Bilag] Integration Generelle vilkår og forudsætninger Findes her: https://share-komm.kombit.dk/p133/referencedokumenter/, Generelle vilkår og forudsætninger.pdf. Teknisk vejledning Serviceplatformen Findes her: https://www.serviceplatformen.dk/administration/help/provider-tech-guide Vejledning til Serviceplatformens SFTP Service Findes her: https://share-komm.kombit.dk/p133/ibrugtagning%20og%20test/delte%20dokumenter/forms/vejledninger%20%20serviceplatformen.aspx, Vejledning til Serviceplatformens SFTP Service.pdf. SFTP - Anvendelsesnoter med relation til ØiR v.1.0 Findes her: https://share-komm.kombit.dk/p133/referencedokumenter/, Anvendelsesnoter med relation til ØiR v.1.0.pdf. Template for abonnenter af Klassifikationer Findes her: [Bilag] NOT0746 Oprydningskonfiguration til SFTP Server - SF7001 AS.docx Bestillingsformular til Klassifikationer Findes her: [Bilag] Exttest: KlassifikationAbonnementBestilling - Exttest.xlsx Transaktionsspor og Fejlbehandling ved servicekald Findes her: https://share-komm.kombit.dk/p133/referencedokumenter/, Transaktionsspor og Fejlbehandling ved servicekald.pdf. Bilagssamling til integrationsbeskrivelsen Findes her: https://share-komm.kombit.dk/p133 under området Økonomi eller direkte med reference til SF7001, 1.3.0.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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 24
Ref. Titel Kommentarer [Informationsmodel] Samlet informationsmodel for håndtering af dataudveksling med debitor, dvs. debitorsystemer. [Servicestrukturrapport] Indeholder reference til relevante schemaer. [KDI- Drift] https://www.kombit.dk/indhold/drift-og-forvaltning-af-kdisservices [KDI- Test] Klassifikation Informationsmodel Findes her: [Bilag] SF7001_V1 - Klassifikation - Informationsmodel - 1.3.0.pdf Overfør Klassifikation til Abonnent Servicestrukturrapport Findes her: [Bilag] SF7001 Overfør Klassifikation til Abonnent - Servicestrukturrapport 1.3.0.pdf Hjemmeside med informationer om drift og forvaltning af KDIs Services Hjemmeside med informationer om ibrugtagning og test af KDIs Services: https://www.kombit.dk/indhold/hj%c3%a6lp-til-test-ogibrugtagning-kdi Beskriver datastrukturen for servicen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 24
Indholdsfortegnelse 1 Overordnet beskrivelse... 6 1.1 Læsevejledning... 6 1.2 Integrationens formål... 6 1.3 Overordnet forretningsflow i integrationen... 6 1.4 Generelle Begreber... 7 1.5 Servicebetingelser for den samlede integration... 10 1.6 Teststrategi... 11 1.7 Håndtering af legacy registreringer... 12 2 Kontekst for Integrationsparter... 14 3 Specifikation for integrationsparter... 15 3.1 Specifikation af endpoints for Klassifikations Abonnementsadministration... 15 3.2 Specifikation af endpoints for SP [!@SP@!]... 18 3.3 Specifikation af Endpoints for Abonnent It Systemer... 19 4 Beskrivelse for integrationsplatforme... 22 4.1 Beskrivelse for Serviceplatformen [!@SP@!]... 22 4.2 Tilslutning til integrationspart: Serviceplatformen... 24 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 24
1 Overordnet beskrivelse 1.1 Læsevejledning Følgende afsnit er endnu ikke udarbejdet: Forudsætninger for produktionssætning Kontekst for integrationsparter 1.2 Integrationens formål Integrationen tilvejebringer eksport af Klassifikationer til abonnenter af disse. 1.3 Overordnet forretningsflow i integrationen Forudsætning for distribution af Klassifikationer er, at der i Klassifikations Abonnementsadministration er oprettet KlassifikationsAbonnementer. Hvert Abonnement gælder kombinationen af et AbonnentItSystem og en AbonnentJuridiskAnsvarligPart. Det er AbonnentJuridiskAnsvarligPart, der opretter Abonnementet. Indtil der er udviklet et nyt Abonnementsbestillingssystem vil oprettelse af Abonnement på en Klassifikation foregå via indsendelse af [Abonnementsbestilling] til KOMBIT mailto:kdi@kombit.dk. Abonnement på Klassifikation gælder leverancer der består af fællesdata eventuelt suppleret med de lokale data, hvor Ejer af Klasse er lig AbonnentJuridiskAnsvarligPart. Data distribueres fortløbende, når der er sket en ajourføring i Klassifikationssystemet. Det er kun de Klassifikationer, 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 Klassifikation 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 24
1.4 Generelle Begreber Abonnement Abonnent AbonnentItSystem En aftale om leverance af en Klassifikation og ændringer til denne 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 Klassifikationer 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å Klassifikationen. 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, Bogføringssystem, Debitorsystem, ERP-løsning, ERPsystem, 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. Alias: Kommune, UDK, KOMBIT Teknisk repræsentation: urn:oio:cvr-nr:xxxxxxxx KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 24
Begrebsreference: AbonnentJuridiskAnsvarligPart. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 24
1.4.1 Diagrammer for forretningsflow Klassifikation Distribution Flow Klassifikations Abonnentsadministration Overfør Klassifikation Opbevar filer (SFTP Service) Serviceplatform Fordel til SFTPbruger Opbevar filer (SFTP Service) Abonnent ItSystem Hent Klassifikation Figur 1 Klassifikation overførsel flow 1.4.2 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 24
Første registreringstidspunkt og senest redigeringstidspunkt er angivet for forretningsobjektet eller vil kunne udledes af et overordnet forretningsobjekt. 1.4.2.1 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. 1.4.3 Angivelse og håndtering af Personfølsomhed Der udveksles ikke personhenførbar information i integrationen. 1.5 Servicebetingelser for den samlede integration 1.5.1 Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Debitorregistreringsflow Værdi Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Kvitteringsflow Værdi Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. 1.5.2 Service Management Informationer om driftsmeddelelser, forespørgsler og kontaktinformationer, findes på siden for Drift og Forvaltning af KDIs Services her: [KDIDrift]. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 24
1.6 Teststrategi 1.6.1 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, SF7001, 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 Klassifikation integrationstest med hvert AbonnentItSystem. Når Klassifikation integrationtest er succesfuldt gennemført kan resterende test gennemføres, fx fagsystemernes og Kildesystemers integrationstest og end-to-end-test. Klassifikation 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. 1.6.2 Test i forbindelse med udvikling på Serviceplatformen Integrationen indeholder ikke udvikling på Serviceplatformen. Standard SFTP-servicen anvendes. Denne test gennemføres derfor ikke. 1.6.2.1 Testfaciliteter og testmiljø Nil 1.6.2.2 Testdata Nil. 1.6.3 Test i forbindelse med AbonnentItSystemers serviceanvendelse AbonnentItSystemer gives mulighed for at afprøve modtagelse af relevante Klassifikationer, samt opdateringer til disse. I tillæg kan dataudveksling med brug af referencedata i Klassifikationer afprøves. Det sidste sker ved brug af stubbe, der simulerer Kilde- og fagsystemer. Denne test kaldes Klassifikation integrationstest. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 24
1.6.3.1 Testfaciliteter og testmiljø Testen gennemføres fra Exttest og SVOT-miljøet under Serviceplatformen. Parasoft anvendes som det tekniske testværktøj til at generere eksempler på dataudveksling med brug af referencedata. 1.6.3.2 Testdata KDI vedligeholder repræsentative Klassifikationer som kan benyttes i afprøvningen. Tillige vedligeholdes eksempler på service-svar fra integrationer, der svarer med reference til de repræsentative Klassifikationers Klasser. Hermed kan AbonnentItSystemet afprøve evt. mapninger til lokale værdier. 1.6.4 Klassifikation - Tilslutningstest For de it-løsninger, som har decentral drift, tilbydes en implementeringstest. Testens formål er at verificere, at den løsning, som er testet i Klassifikation integrationstesten, er blevet succesfuldt installeret i det decentrale driftsmiljø. Der er tale om en simpel test. Testen forudsætter, at myndigheden har et testmiljø under den decentrale drift. 1.6.4.1 Testfaciliteter og testmiljø Testen gennemføres fra Exttest og SVOT-miljøet under Serviceplatformen. Parasoft anvendes som det tekniske testværktøj. 1.6.4.2 Testdata KDI leverer 2-3 testcases og testdata, samt Klassifikation til brug for test. 1.6.5 Produktionsverifikationstest Testen har til formål at verificere at abonnent-systemet kan modtage Klassifikation. Dette tilbydes for it-systemer der alene benytter Klassifikationen internt. 1.6.5.1 Testfaciliteter og testmiljø Testen gennemføres i Produktion. 1.6.5.2 Testdata Der anvendes de produktionsklassifikationer AbonnentItSystemet har tegnet Abonnement på. 1.7 Håndtering af legacy registreringer NIL. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 24
KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 24
2 Kontekst for Integrationsparter [Afventer] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 24
3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for Klassifikations Abonnementsadministration Integrationen benyttes til at sende Klassifikationer fra Klassifikations Abonnementsadministration til AbonnentItSystemer. 3.1.1 Overordnet forretningslogik Serviceplatformens SFTP-Service benyttes af Klassifikations Abonnementsadministration til at overføre Klassifikationer til AbonnentItSystem. Klasssifikation modtager ikke forretningskvitteringer på sine overførsler. Servicen indeholder een forretningsmæssig operation. 3.1.2 Overordnet forretningslogik Klassifikations Abonnementsadministration skal understøtte overførsel af filer via serviceplatformens SFTP Service på endpoint EP_FS1 3.1.3 Oversigt over endpoints ID Navn EP_FS1 KlassifikationLeveranceOverfoer 3.1.4 Beskrivelse af endpoint EP_FS1 KlassifikationLeveranceOverfoer 3.1.4.1 Transportspecifikation 3.1.4.1.1 Serviceudstiller Serviceplatformen udstiller SFTP-servicen. 3.1.4.1.2 Serviceanvender Klassifikations Abonnementsadministration systemet er serviceanvender af Serviceplatformens SFTP-service. 3.1.4.1.3 Teknisk endpoint Snitfladen er implementeret som SFTP, [SFTP]. Der anvendes Simpel Filtransport Dynamic Routing. 3.1.4.2 Dataspecifikation Data omfatter en datafil med Klassifikationens indhold, styringsfilen triggerfil samt den teknisk kvitteringsfil, receipt. 3.1.4.2.1 Datafil Datafilen indeholder Klassifikationens indhold. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 24
Strukturen er angivet i [Servicestrukturrapport]. Datastrukturen er etableret på basis af informationsmodellen Klassifikation, [Informationsmodel]. Datafilen refereres i triggerfilen. 3.1.4.2.2 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> SF7001_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> = SF7001_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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 24
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 3.1.4.2.3 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. 3.1.4.3 Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformens SFTP-server er SSH-baseret [SFTP]. 3.1.4.4 Leverancesikkerhed og fejlhåndtering Der udveksles tekniske kvitteringsfil fra SFTP-servicen til Klassifikation Distribtion. 3.1.4.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.4.5.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 17 af 24
3.2 Specifikation af endpoints for SP [!@SP@!] NIL KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 18 af 24
3.3 Specifikation af Endpoints for Abonnent It Systemer [!@KY@!][!@KSD@!][!@EogE@!][!@SPK@!][!@DS@!] Integrationen benyttes til at modtage og håndtere Klassifikationsleverancer fra Klassifikations Abonnementsadministration gennem Serviceplatformen (ØiR). 3.3.1 Specifik håndtering i det enkelte AbonnentItSystem Implementeringen af integrationen kan variere på enkelte områder mellem AbonnentItSystemerne. Afsnittet omhandler disse. Håndteringen under det enkelte debitorsystem fremgår af kapitel 2 Kontekst for Integrationsparter. 3.3.1.1 Håndtering af længde for tekstfelter Operationerne indeholder en række elementer, felter, af type streng, hvor der ikke er fastlagt og aftalt en endelig længde med leverandørerne. Det drejer sig typisk om felter, hvor der ikke findes en markedsstandard. Felterne er angivet i nedenstående tabel. For hvert element er angivet en teknisk længde, dvs. det maksimale antal tegn, som operationerne understøtter. I kapitel 2 Kontekst for Integrationsparter, afsnit [Kontekst for AbonnentItSystem] angiver hvert AbonnentItSystem den længde af tekstfeltet, som AbonnentItSystemet maksimalt kan understøtte ift. lagring i sin database (revisionsspor), visning i bruger dialoger samt medtage på udskrifter. Det er den ansvarlige for KlassifikationAnvenderItSystems ansvar inden for denne ramme at angive en forretningsmæssig meningsfuld tekst. En tekst, som kan suppleres yderligere med information, som kan være tilgængelig i nogle AbonnentItSystemer og ikke i andre. teknisk maksimal længde. Gennemgang de dataelementer som indgår i operationer og referencestrukturer. Dataelement KlasseBeskrivelse Datatype Tekst4096: String maxlength=4096 3.3.2 Overordnet forretningslogik Debitorsystemet skal understøtte modtagelse af filer via Serviceplatformens SFTP filer på endpoint EP_AS1 3.3.3 Oversigt over endpoints ID Navn EP_AS1 KlassifikationLeveranceOverfør KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 19 af 24
3.3.4 Beskrivelse af endpoint EP_AS1 - KlassifikationLeveranceOverfoer 3.3.4.1 Transportspecifikation 3.3.4.1.1 Serviceudstiller Serviceplatformen udstiller SFTP-servicen. 3.3.4.1.2 Serviceanvender AbonnentItSystemet er serviceanvender af Serviceplatformens SFTP-service. 3.3.4.1.3 Teknisk endpoint Snitfladen er implementeret som SFTP, [SFTP]. 3.3.4.2 Dataspecifikation Data omfatter en datafil med Klassifikations-indhold samt en styringsfil, metadatafil. 3.3.4.2.1 Datafil Datafilen indeholder indholdet af en Klassifikation. 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ænen Klassifikation, [Informationsmodel]. Datafilen findes ud fra metadatafilen. 3.3.4.2.2 Metadatafil Referencen til servicen i metadatafilen er: InfRef : SF7001_01 3.3.4.3 Sikkerhed Sikkerhed mellem AbonnentItSystemet og Serviceplatformens SFTP-server er SSH-baseret [SFTP]. 3.3.4.4 Leverancesikkerhed og fejlhåndtering AbonnentItSystemet kvitterer for den tekniske overdragelse af dataleverancen af Klassifikation ved at slette hhv. datafil og metadatafil fra sin In-mappe. 3.3.4.5 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 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 20 af 24
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]. AbonnentItSystemet skal umiddelbart herefter igangsætte validering af de modtagne debitorregistreringer. AbonnentItSystemet har [12 timer] hertil. 3.3.4.5.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 21 af 24
4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen [!@SP@!] 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. 4.1.1 Oversigt over integrationsflows ID Navn IF01 KlassifikationLeverance KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 22 af 24
4.1.2 Integrationsflow IF01: Klassifikations Abonnementsadministration Overfør 4.1.2.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokumentreference EP_FS1 KlassifikationLeveranceOverfør [Servicestrukturrapport] EP_AS1 KlassifikationLeveranceOverfør [Servicestrukturrapport] 4.1.2.2 Integrationstype SFTP Simpel Filtransport, Dynamic Routing, Implicit. InfRef : SF7001_01 4.1.2.3 Overvågning Der bestilles overvågning jf. standardskabelonerne: [SFTP AS] KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 23 af 24
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 Registrering af Serviceinformation Konfiguration STS Administrationsmodul SSE SSE Fase 1 TSP01 - Der skal registres information vedrørende servicen i STS Administration, så der kan oprettes serviceaftaler for kommunerne, bl.a. skal logiske og fysiske endpoint skal være relateret. Reference ift. bestilling af SFTP-overvågning. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 24 af 24