1. No category

Underbilag 2L
Vilkår for integration til støttesystemet
Ydelsesindeks – Version 2.0
1. Indledning og vejledning
Støttesystemet Ydelsesindeks har til formål at opsamle data om bevilgede ydelser fra
en lang række it-systemer, og via services udstille disse data til brug for it-systemer, der
har behov for at udstille disse i egne it-systemer.
Nærværende vejledning beskriver, hvordan it-systemer afsender og/eller modtager data
fra Støttesystemet Ydelsesindeks.
Dokumentet er opdelt i følgende afsnit:
 Generelle vilkår til Anvendersystemer, se afsnit 2
 Vilkår, der muliggør at Afsendersystemer kan afsende data til Støttesystemet
Ydelsesindeks, se afsnit 3
 Vilkår, der muliggør at Modtagersystemer kan modtage data fra Støttesystemet
Ydelsesindeks, se afsnit 4
 Vilkår vedr. etablering, se afsnit 5
Se desuden bilag med Ydelsesindeksets begrebs- og informationsmodel
Der henvises i vilkårene til følgende dokumenter og definitioner:
BESKVILK:
Vilkår for integration til Støttesystemet Beskedfordeler.
SIKVILK:
Bilag - Sikkerhed (bilag til den samlede pakke med vilkår).
LOGNING
Bilag – Logning (bilag til den samlede pakke med vilkår).
Anvendersystem
Et it-system, der anvender et støttesystem og dets services.
Afsendersystem
Et it-system, der leverer data til et støttesystem.
2. Generelle vilkår til it-systemers anvendelse af Støttesystemet
Ydelsesindeks
Dette afsnit indeholder de generelle vilkår for anvendelse af Støttesystemet
Ydelsesindeks.
2.1 Logning
Anvendersystemet bør generelt udføre logning i henhold til [LOGNING] således de
lovmæssige krav til revisionslogning imødekommes.
I forhold til integrationen til Ydelsesindeks skal transaktionsID håndteres som det er
beskrevet i [LOGNING] afsnit 4.2, samt i udbudsvejledningen.
Side 2 af 9
2.2 Sikkerhed
Anvendersystemet skal understøtte modellen for adgangsstyring i den
fælleskommunale rammearkitektur som beskrevet [SIKVILK] i forbindelse med
Integrationen til Støttesystemet Ydelsesindeks.
For at anvende udstillede services skal Anvendersystemet derfor opfylde følgende
forslag til krav for et Anvendersystem i [SIKVILK].
Afsnit 2 ”Krav til Leverandørens anvendelse af rammearkitekturens
administrationsmodul”
Afsnit 3 ”Krav til adgangsstyring for anvendersystemer”
Afsnit 6 ”Ikke-funktionelle krav vedrørende adgangsstyring”
Det forudsættes af hensyn til håndtering af sikkerhed, at det kommunale Støttesystem
Adgangsstyring anvendes. Det anbefales, at Afsendersystemerne benytter de
kommunale Støttesystemer Organisation og Klassifikation af hensyn til korrekt
opsætning af værdier i dataafgrænsninger. Det er muligt at tilgå Ydelsesindekset med
vilkårlige KLE-nummer klasssifikationer og bevillingsaktører, hvis objekterne ejes af
egen myndighed. Omvendt vil det ikke være muligt at tilgå objekter på tværs af
myndigheder, med mindre myndighederne benytter samme klassifikation og
bevillingsaktører - eventuelt udvekslet specifikt mellem myndighederne.
Nedenstående tabel viser Dataafgrænsningerne, som er defineret til Ydelsesindekset.
Handling
Fremsøg data
Dataafgrænsning
Anvenderkontekst
(CVR)
Følsomhed
KLE-nummer
Periode
System
Beskrivelse
Anvendersystem fremsøger
data fra indeks.
Importer Ydelse
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
Anvendersystem indsætter
data for bevillinger og
Økonomiske Effektueringer
Opdater Ydelse
Fjern bevilling
Slet bevilling
Passiver bevilling
Anvendersystem retter
oplysninger om bevillinger
og Økonomiske
Effektueringer
Anvendersystem fjerner
fysisk en bevilling og de
tilhørende Økonomiske
Effektueringer
Anvendersystem sletter en
bevilling og de tilhørende
Økonomiske Effektueringer
Anvendersystem passiverer
Side 3 af 9
Fjern økonomisk effektuering
Slet økonomisk effektuering
Passiver økonomisk
effektuering
Masseindsæt
Masseopdater
Masseslet
Udtræk
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
System
KLE-nummer
Anvenderkontekst
(CVR)
Følsomhed
KLE-nummer
Periode
System
en bevilling
Anvendersystem fjerner
fysisk en økonomisk
effektuering,
Anvendersystem sletter en
økonomisk effektuering,
Anvendersystem passiverer
en økonomisk effektuering,
Anvendersystem indsætter
en stor mængde data,i
Ydelsesindeks.
Anvendersystem opdaterer
en stor mængde objekter i
Ydelsesindeks.
Anvendersystem sletter en
stor mængde data i
Ydelsesindeks.
Anvendersystem udtrækker
en stor mængde data fra
Ydelsesindeks.
Dataafgrænsning KLE-nummer indeholder én eller flere præcise 6-cifrede KLE-numre.
Dataafgrænsning Periode indeholder et datointerval for Bevilling, Bevilliget ydelse,
Effektueringsplan, Økonomisk Effektuering eller Ydelsesperiode eller en tidsenhed for
de samme 5 datoer.
Hvis kun FRA delen angives i et interval fortolkes dette som [FRA -> oo[
Hvis kun TIL delen angives i et interval fortolkes dette som [-oo -> TIL[
Hvis både FRA delen og TIL delen angives i et interval fortolkes dette som [FRA – TIL[
Intervaller er halvåbne, hvor fra altid er inklusiv og til er eksklusiv.
En tidsenhed kan angives som eksempelvis 3 måneder.
Anvenderkontekst (CVR) indeholder et eller flere CVR-numre som matches mod CVRnummer i aktørrelationen. Dette betyder, at det eksempelvis ikke er nødvendigt, at
Side 4 af 9
angive Anvenderkontekst i Fremsøg for at indskrænke resultatet til netop det eller de
CVR-numre.
2.3 Snitflader og udveksling af data
Anvendersystemet skal anvende støttesystemernes snitflade jf. deres specifikation,
som angivet her:
 Ydelsesindeks-Bevilling-Snitflade
 Ydelsesindeks-Oekonomisk Effektuering-Snitflade
 Ydelsesindeks-Bevilling og Oekonimisk Effektuering-Snitflade
Snitflader kan findes på: http://digitaliser.dk/ydelsesindeks/
Anvendersystemets udveksling af data med Støttesystemet Ydelsesindeks om
Bevillinger skal baseres på vedlagte begrebs- og informationsmodel samt
snitfladespecifikationerne. Anvendersystemet skal i sin kommunikation med
Støttesystem Ydelsesindeks anvende objekttyper, relationer og attributter, således som
de er defineret i vedlagte informationsmodel.
I forbindelse med en ny version af Støttesystemet Ydelsesindeks snitflader, så skal
leverandøren af Anvendersystemet varsles om snitfladeændringen med mindst 6
måneder før idriftssættelse og skal herefter inden for 3 måneder opdatere
Anvendersystemet, så det kan anvende de ændrede udstillede snitflader.
3. Vilkår for Afsendersystemer
Dette afsnit indeholder vilkår for Afsendersystemer der sender data til Støttesystemet
Ydelsesindeks.
3.1 Generelle vilkår for Afsendersystemer
Det er Afsendersystemets ansvar, at holde Ydelsesindeksets data jf.
informationsmodellerne ajourførte. Dette omfatter også de metadata om referencer til
eksterne objekter, som informationsmodellen nævner. Fx kan bevillingens aktørrelation
skifte, hvis en borger flytter – og dette skal afspejles i Ydelsesindekset, selvom aktør er
et blåt/eksternt objekt.
Vær opmærksom på, at obligatoriske objekttyper, relationer og attributter er IKKE
udtryk for en minimal ajourføring, men blot et udtryk for en generelt standard for hvilke
data, der som minimum er relevante for en Bevilling eller en Økonomisk Effektuering.
.
Hvis der findes objekter i Afsendersystemet med ikke-længere-gyldige værdier så som
kommunenummer fra før kommunalreformen eller udgåede værdier fra KLE-
Side 5 af 9
klassifikation, skal disse værdier afklares med myndigheden i forhold til
dataafgrænsning, før Støttesystemet Ydelsesindeks opdateres med disse data
3.2 Vilkår for opdatering af Støttesystemet Ydelsesindeks
Støttesystemet Ydelsesindeks skal opdateres af Afsendersystemer vha. følgende
mekanisme:

Anvendelse af en række opdateringsservices i Støttesystemet Ydelsesindeks,
som er implementeret på den fælleskommunale Serviceplatform.
Leverandøren af Afsendersystemet skal beskrive, hvordan Afsendersystemet håndterer
fejlsituationer, således at data i Støttesystemet Ydelsesindeks er konsistente, og
synkroniserede med Afsendersystemets data.
Leverandøren skal dokumentere håndtering af fejlsituationer og synkroniseringer i
deres systemdokumentation og testrapporter. Disse skal godkendes af myndigheden.
Specielt skal Afsendersystemet, ved at benytte Støttesystemet Ydelsesindeksets
funktionalitet beregnet hertil, sikre at opdateringer af indeksets metadata indsættes i
den tidsligt-logisk rigtige rækkefølge jf. de muligheder der er herfor i de beskrevne
snitflader. Afsendersystemet skal ved opdatering medsende Afsendersystemets
registreringstid, således at opdateringer, bliver tidsligt-logisk korrekt registrerede..
Afsendersystemet skal endvidere håndtere eventuelle fejlsituationer i denne
forbindelse.
Afsendersystemet skal opdatere Støttesystemet Ydelsesindeks via
opdateringsservices, som Ydelsesindeks udstiller jf. de beskrevne snitflader.
Hvis Afsendersystemet skal indsætte eller rette større datamængder i Støttesystemet
Ydelsesindeks, skal de services i Støttesystemet Ydelsesindeks, der specifikt
understøtter masseindsættelse af en større mængde objekter anvendes, jf. de
beskrevne snitflader.
Indtil Afsendersystemet har modtaget en positiv kvittering fra Ydelsesindekset om at
opdateringen har fundet sted er Afsendersystemet ansvarligt for at genforsøge
opdateringen.
Serviceplatformen udsendes automatisk beskeder i forbindelse med opdatering af
Ydelsesindeks. Dette gøres via Støttesystemet Beskedfordeler.
3.3 Vilkår for kvalitetssikring af opdatering af Støttesystemet
Ydelsesindeks
Det er afgørende for at sikre kvaliteten af data i Støttesystemet Ydelsesindeks, at der
løbende sker en kontrol af, om data heri fuldt afspejler indholdet i Afsendersystemet –
Side 6 af 9
dvs. om opdateringerne af Afsendersystemet er slået fuldt og korrekt igennem i
Støttesystemet Ydelsesindeks. Hvis dette ikke er tilfældet skal de nødvendige
opdateringer af Støttesystemet Ydelsesindeks iværksættes.
Dette medfører følgende vilkår, som Leverandøren af Systemet skal sikre overholdt:

Enhver funktionalitet, som Afsendersystemet stiller til rådighed for systemadministratorer mv. til oprydning og rettelse af fejl - herunder masserettelser - i
Systemet tabeller mv., skal gennem kald af Støttesystemet Ydelsesindeksets
services tillige sikre, at der sker en fuldt identisk oprydning af de data i
Støttesystemet Ydelsesindeks, der stammer fra Systemet.

Afsendersystemet skal nemt og hurtigt kunne udføre en kontrol, som
identificerer de objekter, der findes i Afsendersystemet, men som ikke findes i
Støttesystemet Ydelsesindeks - eller hvor ændringstidspunktet for ændringen
er senere i Afsendersystemet end i Ydelsesindekset - således at manglende
eller ikke-opdaterede data i indekset kan identificeres.

Afsendersystemet skal nemt og hurtigt kunne udføre en kontrol, som
identificerer de objekter, der findes i Støttesystemet Ydelsesindeks, og hvor
Støttesystemet Ydelsesindeks har registreret, at Afsendersystemet er
Afsendersystem, men hvor disse objekter ikke findes i Afsendersystemet. Dette
muliggør identifikation af data i indekset, der muligvis er kommet ud af
synkronisering med Afsendersystemet, og som bør slettes i indekset, fordi de
ikke længere findes som gyldige data i Afsendersystemet.

Leverandøren af Afsendersystemet skal redegøre for, hvordan
Afsendersystemet implementerer ovenstående vilkår for kvalitetskontrol, samt
hvilken funktionalitet Afsendersystemet indeholder, der kan gennemføre den
fornødne opdatering af Støttesystemet Ydelsesindeks på baggrund af
identificerede kvalitetsproblemer.

Leverandøren af Afsendersystemet skal have beskrevet en proces som sikrer
korrekt brug af snitfladen, herunder minimalt antal funktionskald (masse fremfor
enkelte kald) samt at holde øje med ændringer i snitfladen.
Myndigheden skal i kontrakten med leverandøren aftale eksplicit hvor ofte de ovenfor
nævnte kvalitetskontroller og deraf følgende nødvendige opdateringer mhp. at etablere
konsistens mellem Afsendersystemet og Støttesystemet Ydelsesindeks gennemføres.
Opdatering af Ydelsesindekset med større datamængder bør foretages udenfor normal
arbejdstid af hensyn til myndighedens brugere.
4. Vilkår for Modtagersystemer
Dette afsnit indeholder vilkår for Modtagersystemer der modtager data fra
Støttesystemet Ydelsesindeks.
Side 7 af 9
4.1 Generelle vilkår
Støttesystemet Ydelsesindeks kan indeholde "logiske dubletter" af dets objekter, hvis
det bliver opdateret af forskellige Afsendersystemer, der indeholder data om de samme
ydelser. Støttesystemet Ydelsesindeks vil imidlertid ikke kunne afgøre hvilken udgave
af objektet, der er "mest fyldestgørende" eller "mest retvisende". Modtagersystemet
skal derfor kunne håndtere at Støttesystemet Ydelsesindeks indeholder sådanne
dubletter.
4.2 Vilkår om at kunne søge og læse data fra Støttesystemet
Ydelsesindeks
Når et Modtagersystem har brug for at fremvise oplysninger om ydelser fra
Støttesystemet Ydelsesindeks, skal Modtagersystemet anvende de services,
Ydelsesindeks udstiller til opslag, jf. de beskrevne snitflader.
5. Vilkår vedr. etablering af Anvendersystemet til Støttesystemet
Ydelsesindeks
Etablering benyttes når et Anvendersystem tilsluttes til Ydelsesindeks.
5.1 Vilkår vedr. etablering af data til og/eller fra Anvendersystemer
Støttesystemet Ydelsesindeks har services, der understøtter indsættelse (load) af en
større datamængde i Støttesystemet Ydelsesindeks fra et
Afsendersystem.Ydelsesindekset har også services, der understøtter overførsel af en
større datamængde til et Modtagersystem.
Hvis Afsendersystemet ønsker at udføre et initielt load af data til Ydelsesindekset skal
Afsendersystemet, gennem anvendelse af Støttesystemet Ydelsesindeks services,
kunne udføre et fuldt load til Støttesystemet Ydelsesindeks med alle de objekter,
relationer og attributter i Afsendersystemet, som også indgår i informationsmodellen for
Støttesystemet Ydelsesindeks.
Hvis et Modtagersystem ønsker at lagre data, skal Modtagersystemet kunne udføre et
load af de objekter, relationer og attributter der findes i Støttesystemet Ydelsesindeks,
jf. Ydelsesindeksets informationsmodel, gennem anvendelse af Støttesystemet
Ydelsesindeks services.
Opdatering og udtræk af Ydelsesindekset med/af større datamængder bør foretages
udenfor normal arbejdstid af hensyn til myndighedens brugere.
Side 8 af 9
5.2 Vilkår vedr. testdata
Leverandøren af Anvendersystemet er ansvarlig for at sikre, at testdata til
Støttesystemet Ydelsesindeks etableres i forbindelse med test af Anvendersystemet,
og efterfølgende fjernes før idriftsættelse.
Side 9 af 9