Vilkår vedrørende brug af Støttesystemet Beskedfordeler
1 Indledning og vejledning Nærværende vejledning beskriver, hvordan it-systemer afsender og/eller modtager beskeder fra Støttesystemet Beskedfordeler, samt den daglige administration og vedligehold, og indgåelse og vedligehold af aftaler om adgang. Vejledningen er opdelt i følgende afsnit: Punkt 2: Vilkår vedrørende afsendelse og modtagelse af beskeder fra Beskedfordeler Punkt 3: Vilkår vedrørende konfiguration af Systemet Der anvendes følgende betegnelser i dokument udover de generelle: Adminmodul: Her henvises til vilkårene for brug af Administrationsmodul for Adgangsstyring. Tilslutning af systemer, administration af roller og aftaler. Beskedkuvert: Beskedfordelers Beskedkuvert, jævnfør underbilag 1 til nærværende vejledning. Beskedfordeler: Støttesystemet Beskedfordeler Beskeder: De beskeder der modtages eller afsendes af Beskedfordeler Systemet: Det it-system der skal anvende Beskedfordeler Leverandøren: den leverandør, der er ansvarlig for leverancen af Systemet Side 2 af 11
2 Vilkår vedrørende brug af Beskedfordeler Nærværende afsnit beskrives vilkårene for Systemet, der ønsker at gøre brug af beskedfordeling, og om hvordan Beskedfordeler anvendes, herunder funktionelt og indbyrdes ansvarsfordeling, som beskrevet i afsnit 2.1, og konkrete vilkår til afsendelse og behandling af Beskeder, som beskrevet i afsnit 2.2. 2.1 Systemets brug af Beskedfordeler til distribution af beskeder Nedenstående definerer de regler der regulerer brugen af Beskedfordeler. Reglerne er defineret ud fra en grundlæggende model for beskedfordeling. Modellen specificerer, at beskeder først produceres i et it-system og afleveres til Beskedfordeler. Derefter distribuerer Beskederne, og er dermed klar til levering af beskeder, som herefter slettes. Distributionen af Beskeder i Beskedfordeler sker efter modtagelse af Beskeder fra Afsendersystemet. Levering af Beskeder til Modtagersystemer sker uafhængigt af distributionen af Beskeder. Det logiske forløb fra afsendelse af en Besked fra Afsendersystemet, til modtagelsen af Beskeden i Modtagersystemerne igennem Beskedfordeler, er illustreret med følgende sekvensdiagram: Afsendersystem Beskedfordeler Modtagersystem 1 Modtagersystem 2 Modtagersystem 3 Aflever besked Besked modtaget Afhent besked (ingen) Distribuer besked Aflever besked Besked behandlet Aflever besked Besked behandlet Afhent besked <Besked> Figur 1 Sekvens for afsendelse og modtagelse af Beskeder Som vist på Figur 1 initieres beskeddistributionen ved at et Afsendersystem afleverer en Besked til Beskedfordeler. Beskedfordeler svarer umiddelbart efter validering tilbage til Afsendersystemet at Beskeden er modtaget. Side 3 af 11
Efterfølgende igangsætter Beskedfordeler distributionen af Beskeden til alle abonnerende Modtagersystemer her er det Modtagersystem 1, 2 og 3, som vist på Figur 1. Resultatet af distributionen er, at Beskeden er placeret i Modtagersystemernes dueslag, således at de er klar til levering. Modtagersystem 1 og 2 er konfigureret til at Beskedfordeler afleverer Beskeder, når der er tilgængelige Beskeder i deres dueslag. På Figur 1 vises at Beskedfordeler på eget initiativ afleverer Beskeden. Når Modtagersystemet at Beskeden er modtaget, fjernes Beskeden fra deres respektive dueslag af Beskedfordeler. Modtagersystem 3 skal selv afhente Beskeder. På Figur 1 vises at Modtagersystem 3 først forespørger uden at der er Beskeder tilgængelige. Efter distribution vil den efterfølgende forespørgsel fra Modtagersystem 3 resultere i at en Besked returneres. Herefter fjerner Beskedfordeler Beskeden fra dueslaget. Nedenstående defineres, hvordan ansvaret for afsendelse, distribution og udlevering af Beskeder fordeles mellem Afsendersystem og Beskedfordeler, og Beskedfordeler og Modtagersystem. For Afsendersystemer: - Afsendersystemet registrerer en hændelse. Informationerne herom samles til en Besked. Afsendersystemet har ansvar for at Beskeden kan identificeres unikt af Afsendersystemet, samt at tilføje øvrig relevant information til Beskeden. - Afsendersystemet har ansvaret for eksplicit at aflevere Beskeden til Beskedfordeler via en forespørgsel. - Først når Beskedfordeler har kvitteret for modtagelse, må Afsendersystemet opfatte Beskeden som afsendt. Herefter har Beskedfordeler overtaget ansvaret for distribution af Beskeden. - Det er Afsendersystemets ansvar at opbevare Beskeden indtil denne er afsendt. Det er Afsendersystemets ansvar at håndtere alvorlige fejl ved afsendelsen, såsom at Afsendersystemet ikke er berettiget til at afsende den pågældende Besked, jf. manglende aftalegrundlag. For Modtagersystemer: Forinden behandling af Beskeder i Modtagersystemet, skal det overfor Beskedfordeler være angivet hvorvidt Modtagersystemet selv afhenter beskeder, eller om Beskedfordeler skal aflevere beskeder til modtagersystemet. Leverandøren af Systemet er ansvarlig for at angive dette, samt at Systemet følger det angivne. Abonnementer for modtagersystemet skal være etableret forinden beskeder kan modtages. 1) Hvis modtagersystemet skal afhente beskeder - Modtagersystemet har ansvaret for løbende at forespørge på nye beskeder. - Beskedfordeler udleverer beskeder, når disse bliver tilgængelige i dueslaget, og Beskedfordeler modtager en forespørgsel om udlevering af nye beskeder. Herefter fjernes beskeden fra dueslaget, og modtagersystemet har ansvaret for den fortsatte behandling og eventuelle opbevaring af beskeden. Side 4 af 11
- Det er modtagersystemets ansvar at håndtere, at en besked der er modtaget af modtagersystemet allerede kan være slettet, når modtagersystemet forsøger at slette den pågældende besked. Det er modtagersystemets ansvar at håndtere alvorlige fejl ved afhentning af beskeder. 2) Hvis Beskedfordeler skal aflevere beskeder til modtagersystemet - Modtagersystemet har ansvaret for at udstille en snitflade, Beskedfordeler kan anvende til aflevering af beskeder. - Beskedfordeler forsøger at aflevere beskeder, når disse bliver tilgængelige i dueslaget, og når en forbindelse til Modtagersystemet kan etableres. Beskedfordeler har ansvaret for at håndtere at der kan opstå fejl i kommunikationen med modtagersystemet, og forsøger at genlevere beskeden. Modtagersystemet har ansvaret for at håndtere at den samme besked kan afleveres flere gange. - Hvis en besked overføres til modtagersystemet på denne måde, og modtagersystemet indikerer at beskeden er modtaget, fjernes beskeden fra dueslaget, og beskeden vil ikke blive forsøgt genleveret. 2.2 Vilkår til Systemets brug af Støttesystemet Beskedfordeler Nærværende afsnit beskriver vilkår vedrørende Systemet og Leverandørs ansvar i forbindelse med brug af Beskedfordeler. Vilkår #1 Systemet skal aflevere beskeder til Beskedfordeler Beskrivelse: Systemet skal aflevere alle beskeder, der skal distribueres via Beskedfordeler, via Beskedfordelers afleveringsfunktion. Beskederne afleveres enkeltvis til Beskedfordeler. Beskederne skal overholde den maksimale størrelse for beskeder der understøttes af Beskedfordeler, og skal indeholde de informationer, der kræves af Beskedfordeler, jf. definitionen af Beskedkuverten. Beskedens øvrige indhold skal overholde aftalen med Kunden om konkret beskedindhold i de anvendte beskedtyper. Side 5 af 11
Vilkår #2 Korrekt brug af Beskedfordeler til afsendelse af beskeder Beskrivelse: Leverandøren er ansvarlig for at sikre, at Systemet afsender beskeder, der er i overensstemmelse med den eller de serviceaftaler, der er indgået med de myndigheder, på hvis vegne Systemet behandler data, jf. afsnit 3.3. Leverandøren skal sikre at alle aftalte beskeder afsendes. Mængden af beskeder, Systemet forsøger at afsende, og som ikke er indeholdt i serviceaftalen, skal begrænses mest muligt. Leverandøren er ansvarlig for at sikre, at Systemet håndtere og opbevare Beskeder, og bruger Beskedfordeler korrekt, i henhold til ansvarsfordelingen mellem Afsendersystem og Beskedfordeler, som angivet i afsnit 2.1. Vilkår #3 Korrekt konfiguration til afsendelse af beskeder Beskrivelse: Leverandøren er ansvarlig for at sikre, at Systemets konfiguration som afsendersystem er foretaget korrekt i Beskedfordeler. Vilkår #4 Systemet skal sikre behandling af beskeder i dueslaget Beskrivelse: Systemet er ansvarligt for at sikre at alle beskeder i Systemets dueslag i Beskedfordeler behandles. Systemet skal enten selv afhente beskeder fra Beskedfordeler eller lade Beskedfordeler aflevere beskeder. Hvis Systemet selv afhenter beskeder, skal Systemet på eget initiativ eksplicit forespørge om at få udleveret beskeder via Beskedfordelers afhentningsfunktion. Hvis Beskedfordeler skal aflevere beskeder til Systemet, skal Systemet modtage beskeder via en udstillet snitflade og efterfølgende behandle disse. Afleveringen af beskeder til Systemet sker på Beskedfordelers initiativ. Side 6 af 11
Vilkår #5 Systemet skal bruge Beskedfordeler korrekt til behandling af beskeder Beskrivelse: Hvis Systemet selv afhenter beskeder, er Leverandøren af Systemet ansvarlig for at sikre, at afhentning sker løbende, herunder for at sikre at der ikke sker overløb i dueslaget af beskeder der ikke er afhentet. Afhentningsfrekvens aftales med Kunden. Hvis Beskedfordeler skal levere beskeder til Systemet, er Leverandøren af Systemet ansvarlig for at sikre, at Systemet udstiller en snitflade, der er tilgængelig for Beskedfordeler, og som overfor Beskedfordeler indikerer at beskeder er modtaget, således at de kan fjernes fra dueslaget. Leverandøren er ansvarlig for at sikre, at Systemets konfiguration som modtagersystem er foretaget korrekt i Støttesystemet Beskedfordeler. Leverandøren er ansvarlig for at sikre, at Systemet håndterer beskeder, og bruger Beskedfordeler korrekt, i henhold til ansvarsfordelingen mellem Modtagersystem og Beskedfordeler, som angivet i afsnit 2.1. Vilkår #6 Systemets abonnementer på beskeder vedrørende specifikke forretningsobjekter i Beskedfordeler Beskrivelse: Hvis Systemet ønsker at modtage Beskeder omhandlende specifikt identificerede forretningsobjekter, skal Systemet angive og vedligeholde en liste af referencer på forretningsobjekter, om hvilke beskeder ønskes modtaget, for abonnementerne i Beskedfordeler. Systemet skal anvende Beskedfordelers særlige værdilistefunktion til dette. Mængden af referencer til forretningsobjekter, Systemet ønsker at abonnere på, skal begrænses til det nødvendige. Abonnementer aftales nærmere med Kunden. Side 7 af 11
3 Vilkår til daglig administration og vedligehold I dette afsnit beskrives de opgaver der er forbundet med at sørge for at de ønskede Beskeder modtages af Anvendersystemet og at sørge for at de rigtige Beskeder afsendes, ved at sikre korrekt konfiguration. Kunden skal overveje, hvorvidt denne selv ønsker at løfte nedenstående opgaver, og i givet fald ikke inkludere nedenstående vilkår og bestemmelser. Modtagelse af beskeder forudsætter tilstedeværelsen af en indikation af, hvilke beskeder der ønskes modtaget. Dette beskrives i afsnit 1.1.1. Afsendelse og modtagelse af beskeder forudsætter aktivering af Systemet i Beskedfordeleren. Dette beskrives i afsnit 3.1. Anvendelse af beskedtyper hvor Systemet udgør den autoritative kilde for definition af beskedens indhold forudsætter vedligehold af beskedtyper. Dette beskrives i afsnit 3.2. 1.1.1 Vilkår til oprettelse og vedligehold af abonnementer For at modtage de beskeder, der ønskes behandlet, skal der oprettes et abonnement, der overfor Beskedfordeleren definerer hvilke beskeder Systemet skal modtage. Dette skal ske indenfor de rammer, der er indgået aftaler om med kommunen (se afsnit 3.3). Et abonnement er altid knyttet til et dueslag, hvor beskederne placeres til senere levering. Systemet kan have flere dueslag. Der oprettes et abonnement for hvert dueslag. Hvert abonnement består af ét eller flere såkaldte abonnementsudtryk. Et abonnementsudtryk definerer hvilke kriterier, der skal være opfyldt, for at beskeden ønskes modtaget i det pågældende dueslag. De samlede parametre, der er tilgængelige i abonnementsudtryk, er ikke for indeværende endeligt fastlagt. Det forventes, at der som minimum vil kunne opstilles kriterier for følgende i abonnementsudtryk: Beskedtype ud fra o Sagstype (f.eks. ud fra KLE nummer) o Handling (f.eks. hvad er der sket? flytning, eller lignende) o Fortrolighed (f.eks. ikke-følsomme data, personfølsomme data) Afsendersystem (f.eks. CPR eller Kommunernes Ydelsessystem ) Kommunenummer fx i forhold til afsendende myndighed Identificerede forretningsobjekter (via en vedligeholdt liste af referencer til forretningsobjekterne) Det forventes, at Leverandøren påtager sig ansvaret for dette, i samarbejde med Kunden. Følgende vilkår danner udgangspunkt for vilkår til håndtering af abonnementer til Leverandøren af Systemet. Side 8 af 11
Vilkår #7 Oprettelse af abonnementer Beskrivelse: Leverandøren er ansvarlig for at oprette og vedligeholde de nødvendige abonnementer i Beskedfordeler for at sikre at alle ønskede beskeder placeres i Systemets dueslag. Leverandøren skal anvende brugergrænsefladen til Beskedfordeler til dette formål. Oprettelsen og vedligeholdelsen sker efter aftale med Kunden, og i god tid inden abonnementet skal træde i kraft. Hvis Systemet skal abonnere på beskeder omhandlende konkrete forretningsobjekter, skal Leverandøren sikre at Systemet løbende vedligeholder en liste af referencer til forretningsobjekterne jf. vilkår herom i afsnit 2.2. 3.1 Administration af Anvendersystem Brugergrænsefladen til Beskedfordeler understøtter at Beskedfordeleren konfigureres i forhold til Systemet. Udover den i afsnit 1.1.1 nævnte abonnementsopsætning, kan man her også aktivere eller inaktivere beskedfordelingen samt opsætte dueslag for modtagersystemer. Vilkår #8 Aktivering og inaktivering af beskedfordelingen Beskrivelse: Leverandøren er ansvarlig for i Beskedfordeler at aktivere og inaktivere beskedfordelingen efter behov fx i forbindelse med idriftsættelser eller i fejlsituationer. Hvis Systemet er et modtagersystem aktiveres/inaktiveres dette ved at aktivere/inaktivere Systemets dueslag. Hvis Systemet er et afsendersystem aktiveres/inaktiveres det ved at aktivere/inaktivere selve afsendersystemet. Leverandøren skal anvende brugergrænsefladen til Beskedfordeler til dette formål. Aktivering/inaktivering sker efter aftale med Kunden. Det er vigtigt at kapaciteten for dueslaget i Beskedfordeler ikke overskrides. Dette kan eksempelvis ske når modtagersystemet ikke forinden har modtaget beskederne fra dueslaget, enten fordi Systemet ikke afhenter beskeder, eller fordi Beskedfordeler ikke kan levere beskeder til modtagersystemet. I sådanne tilfælde kan eventuelle kapacitetsbegrænsninger i Beskedfordeler medføre at modtagersystemet ikke modtager alle beskeder det abonnerer på. Side 9 af 11
Vilkår #9 Oprydning i dueslag ved overløb Beskrivelse: Leverandøren er ansvarlig for i eventuelle overløbssituationer for dueslag at drage omsorg for bedst mulig at få genetableret en stabil og korrekt beskedmodtagelse. Med overløbssituation menes at nye beskeder er distribueret til et dueslag, hvor al kapaciteten allerede er brugt til opbevaring af ældre, ikke slettede beskeder. Leverandøren bør inddrage information om dueslagets kapacitet i håndteringen af en eventuel sådan overløbssituation. Håndteringen bør om nødvendigt også omfatte at slette hele eller dele af dueslagets indhold. Leverandøren skal anvende brugergrænsefladen til Beskedfordeler til håndtering af en sådan eventuel overløbssituation. Desuden skal Leverandøren foretage den bedst mulige håndtering af situationen i Systemet. Bemærk, at den centrale administrator af Beskedfordeler kan opsætte kapaciteten for et dueslag samt konsekvensregel ved eventuel overløb. Konsekvensalgoritmen kan enten være at ældste beskeder slettes eller at nyeste beskeder ikke indsættes. Leverandøren bør kontakte den centrale administrator, hvis der er behov for ændring af disse typer opsætninger for et dueslag. 3.2 Beskedtyper Vedligehold og administration af beskedtyper har to vinkler der er dels tale om at de beskedtyper, som anvendersystemet evt. selv har defineret skal vedligeholdes dels er der tale om at det skal håndteres at beskedtyper, der abonneres på og som dermed skal bruges af anvendersystemet, kan ændres. Begge disse situationer bør håndteres af leverandøren i samarbejde med Kunden. Håndtering af denne form for ændringer bør indgå den generelle release- og governancestrategi for Anvendersystemet. Vilkår #10 Vedligehold af definition og brug af beskedtyper Beskrivelse: Leverandøren er ansvarlig for i samarbejde med Kunden at udarbejde og vedligeholde beskrivelser og definitioner af beskedtyper for beskeder, Systemet kan afsende og modtage. Leverandøren er ansvarlig for at sikre at Systemet kan tilrettes til brug af nye udgaver af beskedtyper, når disse ændres. Side 10 af 11
3.3 Vilkår til aftaler For at Beskedfordeler kan anvendes af Systemet skal der være indgået aftaler herom. Aftaler om afsendelse og modtagelse af beskeder fastlægges via en serviceaftale, der etableres i som beskrevet i vilkårerne for adgangsstyring. Vilkår #11 Etablering af aftale om tilslutning af Systemet Beskrivelse: Leverandøren er ansvarlig for at anmode om tilslutning af Systemet til Beskedfordeler. Side 11 af 11