Gå til hovedindhold
SF1510
Klassifikation
Klassifikation

Formål

Med integrationen kan anvendere til enhver tid hente opdaterede fælleskommunale klassifikationssystemer, fx KLE og kontoplanen. Integrationen leverer også klassifikationsbegrebernes UUID'er, som skal anvendes ifm. dataudveksling i den fælleskommunale infrastruktur. Videre kan kommunen via integrationen ind- og udlæse kommunens egne klassifikationssystemer og eventuelle egne udvidelser af fælleskommunale klassifikationssystemer.

Vilkår og betingelser

Du finder et link til de Generelle vilkår nedenfor i den blå sidefod.

En serviceaftale på integrationen Klassifikation giver adgang til de fire bagvedliggende webservices.
SF1510_3.0
Klassifikation
Status gyldig fra
21/05/2021
Version
3.0
I drift

Beskrivelse

Integrationen består af fem services:

- FacetService
- KlasseService
- KlassifikationListeHent
- KlassifikationService
- KlassifikationSystemService

Informationsmodellen for klassifikationsdomænet indeholder tre forretningsobjekter:

- Klassifikation er klassifikationshierarkiets rodelement.
- Facet er en dimension i en klassifikation og klassifikationshierarkiets mellemste niveau.
- Klasse er et begreb i en klassifikation. Klasser er arrangeret hierarkisk og er klassifikationshierarkiets nederste niveau.

FacetService, KlasseService og KlassifikationService er enkeltobjektservicer, der anvendes til at hente, skabe eller redigere individuelle objekter af den angivne type. De tre enkeltobjektservicer indeholder mange detaljer om hvert objekt. Enkeltobjektservicer skal typisk kaldes i kombinationer for at dække et forretningsbehov.

KlassifikationListeHent og KlassifikationSystemService er flerobjektservicer, der anvendes til at hente hele eller dele af et klassifikationshierarki. KlassifikationSystemService kan også anvendes til at skabe eller redigere flere objekter i et klassifikationshierarki. De to flerobjektservicer kan indeholde større datamængder. Flerobjektservicer skal typisk kaldes én gang for at dække et forretningsbehov.

I de tre enkeltobjektservicer samt i KlassifikationSystemService er data struktureret i henhold til OIO-standarden for klassifikationer. I KlassifikationListeHent er datastrukturen simplere end i de fire OIO-servicer, og KlassifikationListeHent returnerer kun de oftest anvendte egenskaber på hvert objekt.

I Fælleskommunalt Administrationsmodul kan der oprettes to serviceaftaler:

- Klassifikation, der dækker de fire OIO-servicer (FacetService, KlasseService, KlassifikationService og KlassifikationSystemService).
- KlassifikationListeHent, der dækker servicen KlassifikationListeHent.

Services

Webservice / Fælleskommunalt Klassifikationssystem
FacetService
Version
6.0
I drift

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Facet".
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Opret, Importer, Passiver, Ret og Slet benyttes:

- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/facet_6

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/facet_6

Webservice / Fælleskommunalt Klassifikationssystem
KlasseService
Version
6.0
I drift

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Klasse".
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Opret, Importer, Passiver, Ret og Slet benyttes:

- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/klasse_6

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/klasse_6

Webservice / Fælleskommunalt Klassifikationssystem
KlassifikationListeHent
Version
1.0
I drift

Formål

Servicen benyttes til at hente hele eller dele af klassifikationshierarkier. Servicen har én operation af samme navn som servicen.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationen KlassifikationListeHent benyttes:

- KlassifikationListeHent tager et eller flere søgekriterier vedr. facet, klasse eller klassifikation som input og returnerer de dele af et klassifikationshierarki, der matcher kriterierne. Historiske objekter kan tilvælges.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Webservice / Fælleskommunalt Klassifikationssystem
KlassifikationService
Version
6.0
I drift

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen ”Klassifikation”.
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Opret, Importer, Passiver, Ret og Slet benyttes:

- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/klassifikation_6

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/klassifikation_6

Webservice / Fælleskommunalt Klassifikationssystem
KlassifikationSystemService
Version
6.0
I drift

Formål

Servicen benyttes til at arbejde med hele eller dele af klassifikationshierarkier.
Servicen udstiller to operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationen FremsoegObjekthierarki benyttes:

- FremsoegObjekthierarki tager et eller flere søgekriterier vedr. facet, klasse eller klassifikation som input og returnerer de dele af et klassifikationshierarki, der matcher kriterierne. Historiske objekter og objekters ændringer kan tilvælges.

Med servicesystemrollen ”Rediger” kan operationen Import benyttes:

- Import tager objekter af typen facet, klasse og klassifikation og deres egenskaber inkl. objekt-UUID’er som input, skaber objekterne med livscyklus ”Importeret” og returnerer en status per objekt-UUID.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/klassifikationsystem_6

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/klassifikationsystem_6

Supportydelser

Bestilling af Timepulje

Supportydelsen giver rekvirenten mulighed for at bestille en timepulje til brug for hjælp til at løse en specifik opgave, eller som deltager i en workshop med rekvirenten. 

Ydelsen giver f.eks. mulighed for (men er ikke begrænset til): 
• At bestille en workshop med en tekniker
• At bestille et review af en drejebog, m.m. 
• At bestille hjælp i forbindelse med test

Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 1.500 kr.
Antal enheder: 3-30

Bestil

Føderation og lokal IdP

Opret integration til et anvendersystem til systemet i driftsmiljøet. 
Dette omfatter:

Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 12.196 kr.
Antal enheder: 1

Bestil

Undersøgelse af langsomme forespørgsler

Supportydelsen giver anvendere mulighed for at bestille en analyse af langsomme forespørgsler. Disse forespørgsler skal være rettet mod et af følgende Støttesystemer:

  • Organisation
  • Klassifikation
  • Sags- og dokumentindeks
  • Ydelsesindeks
     
Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 11.125 kr.
Antal enheder: 1

Bestil

Udtræk af Klassifikationssystemer

Supportydelsen giver ikke-kommunale aktører og/eller kommuner, som endnu ikke har/kan få adgang til brugergrænsefladen i Klassifikation, mulighed for at bestille et udtræk af fællesoffentlige klassifikationssystemer oprettet af KOMBIT i Fælleskommunalt Klassifikationssystem.  

Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 6.000 kr.
Antal enheder: 1

Bestil

Sådan testes integrationen

Er det første gang du skal have adgang til en integration der anvender webservice, er der hjælp at hente i vejledningen ’Kom godt i gang –webservice’. Vejledningen har fokus på teknik og indeholder et praktisk eksempel på de trin du skal igennem, for at få adgang til en webservice på infrastrukturen.

Du kan finde flere gode vejledninger, blandt andet om hvordan du benytter certifikater på infrastrukturen, her.

Læs mere

Anvend integrationen i produktion

Du kan læse mere om Fælleskommunalt Klassifikationssystem på denne side.

Beskrivelse

Integrationen består af fire bagvedliggende webservices, der udstilles på Serviceplatformen: FacetService, KlasseService, KlassifikationService og KlassfikationSystemService.

For FacetService, KlasseService, KlassifikationService gælder, at de hver indeholder otte operationer, der kan deles op i to kategorier:
- De operationer, som ændrer i objekter (Importer, Opret, Passiver, Ret og Slet)
- De operationer, som ikke ændrer i objekter (List, Læs og Søg)

For servicen KlassifikationSystemService gælder, at den har tre operationer: Import, Eksport og Fremsøgobjekthierarki.

For at få adgang til de fire webservices, skal der indgås én serviceaftale, der dækker alle fire.

Detaljer om de fire services i integrationen, vilkår for anvendelse, input- og outputparametre, begrebsmodel, anvisninger etc. findes i de tilhørende dokumenter i integrationsbeskrivelsens bilag.

Services

Webservice / Serviceplatformen
FacetService
Version
5.0
I drift

Formål

Servicen udstiller OIO-operationer (Opret, Importer, Læs, Ret, Slet, Passiver, Søg og List) på forretningsobjektet Facet, dvs. på en dimension i et klassifikationssystem.

Beskrivelse

Der er otte operationer, fordelt på to grupper: Dem der ændrer i objekter (Importer, Opret, Passiver, Ret og Slet) og dem, der ikke ændrer i objekter (List, Læs og Søg).

- Importer, Passiver, Ret og Slet returnerer kun resultatet af kaldet
- Opret returnerer resultatet af kaldet samt ObjektId på den forekomst, der er blevet oprettet
- Søg og List returnerer resultatet af kaldet samt kollektioner, der indeholder ObjektRegistreringer
- Læs returnerer resultatet af kaldet samt de ObjektRegistreringer, der er efterspurgt af servicen

Servicen er udstillet med følgende sikkerhedmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Klassifikation/Facet/5

UUID: 021c1a36-47a9-494f-b52e-23f96969b4d1

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Klassifikation/Facet/5

UUID: 021c1a36-47a9-494f-b52e-23f96969b4d1

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Webservice / Serviceplatformen
KlasseService
Version
5.0
I drift

Formål

Servicen udstiller OIO-operationer (Opret, Importer, Læs, Ret, Slet, Passiver, Søg og List) på forretningsobjektet Klasse, dvs. på et begreb i et klassifikationssystem.

Beskrivelse

Der er otte operationer, fordelt på to grupper: Dem der ændrer i objekter (Importer, Opret, Passiver, Ret og Slet) og dem, der ikke ændrer i objekter (List, Læs og Søg).

- Importer, Passiver, Ret og Slet returnerer kun resultatet af kaldet
- Opret returnerer resultatet af kaldet samt ObjektId på den forekomst, der er blevet oprettet
- Søg og List returnerer resultatet af kaldet samt kollektioner, der indeholder ObjektRegistreringer
- Læs returnerer resultatet af kaldet samt de ObjektRegistreringer, der er efterspurgt af servicen

Servicen er udstillet med følgende sikkerhedmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Klassifikation/Klasse/5

UUID: d8fc386b-1585-4923-8918-979cfd54d4e1

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Klassifikation/Klasse/5

UUID: d8fc386b-1585-4923-8918-979cfd54d4e1

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Webservice / Serviceplatformen
KlassifikationService
Version
5.0
I drift

Formål

Servicen udstiller OIO-operationer (Opret, Importer, Læs, Ret, Slet, Passiver, Søg og List) på forretningsobjektet Klassifikation, dvs. på et klassifikationssystems rodelement.

Beskrivelse

Der er otte operationer, fordelt på to grupper: Dem der ændrer i objekter (Importer, Opret, Passiver, Ret og Slet) og dem, der ikke ændrer i objekter (List, Læs og Søg).

- Importer, Passiver, Ret og Slet returnerer kun resultatet af kaldet
- Opret returnerer resultatet af kaldet samt ObjektId på den forekomst, der er blevet oprettet
- Søg og List returnerer resultatet af kaldet samt kollektioner, der indeholder ObjektRegistreringer
- Læs returnerer resultatet af kaldet samt de ObjektRegistreringer, der er efterspurgt af servicen

Servicen er udstillet med følgende sikkerhedmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Klassifikation/Klassifikation/5

UUID: 79a860b6-a11c-486d-9134-c4f30a54a527

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Klassifikation/Klassifikation/5

UUID: 79a860b6-a11c-486d-9134-c4f30a54a527

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Webservice / Serviceplatformen
KlassifikationSystemService
Version
5.0
I drift

Formål

Servicen giver anvendere mulighed for at hente eller indlæse hele eller dele af et klassifikationssystem.

Beskrivelse

Servicen udstiller tre operationer: Import, Eksport og Fremsoegobjekthierarki.

Servicen er udstillet med følgende sikkerhedmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/Klassifikation/KlassifikationSystem/5

UUID: 400d47cb-8a14-43aa-8a61-c635407175f5

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/Klassifikation/KlassifikationSystem/5

UUID: 400d47cb-8a14-43aa-8a61-c635407175f5

EntityId: http://klassifikation.serviceplatformen.dk/service/klassifikation/5

Fejlkoder: Link til fejlkode

Supportydelser

Bestilling af Timepulje

Supportydelsen giver rekvirenten mulighed for at bestille en timepulje til brug for hjælp til at løse en specifik opgave, eller som deltager i en workshop med rekvirenten. 

Ydelsen giver f.eks. mulighed for (men er ikke begrænset til): 
• At bestille en workshop med en tekniker
• At bestille et review af en drejebog, m.m. 
• At bestille hjælp i forbindelse med test

Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 1.500 kr.
Antal enheder: 3-30

Bestil

Føderation og lokal IdP

Opret integration til et anvendersystem til systemet i driftsmiljøet. 
Dette omfatter:

Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 12.196 kr.
Antal enheder: 1

Bestil

Undersøgelse af langsomme forespørgsler

Supportydelsen giver anvendere mulighed for at bestille en analyse af langsomme forespørgsler. Disse forespørgsler skal være rettet mod et af følgende Støttesystemer:

  • Organisation
  • Klassifikation
  • Sags- og dokumentindeks
  • Ydelsesindeks
     
Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 11.125 kr.
Antal enheder: 1

Bestil

Udtræk af Klassifikationssystemer

Supportydelsen giver ikke-kommunale aktører og/eller kommuner, som endnu ikke har/kan få adgang til brugergrænsefladen i Klassifikation, mulighed for at bestille et udtræk af fællesoffentlige klassifikationssystemer oprettet af KOMBIT i Fælleskommunalt Klassifikationssystem.  

Læs mere

Teknisk support
Leverandør: KMD
Enhedspris: 6.000 kr.
Antal enheder: 1

Bestil

Sådan testes integrationen

Er det første gang du skal have adgang til en integration der anvender webservice, er der hjælp at hente i vejledningen ’Kom godt i gang –webservice’. Vejledningen har fokus på teknik og indeholder et praktisk eksempel på de trin du skal igennem, for at få adgang til en webservice på infrastrukturen.

Du kan finde flere gode vejledninger, blandt andet om hvordan du benytter certifikater på infrastrukturen, her.

Læs mere

Anvend integrationen i produktion

Du kan læse mere om Fælleskommunalt Klassifikationssystem på denne side.

Tilmeld notifikationer

Indtast din e-mail og tryk tilmeld, for at modtage notifikationer relateret til denne integration.

Service Level Agreement (SLA)

Information om SLA’er og åbningstider for den fælleskommunale infrastruktur finder du på denne side