Formål
Integration giver kommunale fagsystemer mulighed for at aflevere til og vedligeholde metadata vedrørende sager og dokumenter i Sags- og Dokumentindekset, således at de kan udveksles med øvrige fagsystemer og overbliksløsninger, som fx løsningerne SAPA og Borgerblikket.Vilkår og betingelser
Du finder et link til de Generelle vilkår nedenfor i den blå sidefod.For alle anvendersystemer (modtager- og afsendersystemer) gælder følgende særlige vilkår:
- Det er et vilkår for tilslutning til indekserne, at anvisningerne overholdes. Anvisningerne beskriver det forretningsmæssige indhold af og formatet på alle felter i indekset, og hvilke oplysninger, der er obligatoriske, når der afleveres data til indekset. Ændringer til anvisningerne varsles under samme vilkår, som er gældende for ændringer i eksisterende integrationer og services.
For afsendersystemer gælder der herudover følgende særlige vilkår:
- Et afsendersystem skal løbende holde oplysningerne i indekset opdateret med ændringer i afsendersystemet. Opdateringen af indekset skal ske umiddelbart efter data er ændret i afsendersystemet, dvs. inden for få minutter.
- Oplysninger der ikke umiddelbart er tilgængelige i afsendersystemet, eventuelt fordi de er logisk eller fysisk slettet, skal slettes fysisk fra indekset.
- Ved tilslutning til indekset skal afsendersystemet aflevere alle relevante oplysninger, dvs. at alle oplysninger, der vedligeholdes i afsendersystemet, og som kan indeholdes i indekset, skal afleveres.
Case - Sammenhængende it til sagsbehandlerne i Syddjurs
Sags- og Dokumentindeks hjælper Syddjurs Kommune et vigtigt skridt på vejen mod større systemsammenhæng for kommunens sagsbehandlere.
Læs mereNyt i denne version
Servicen "SagDokumentIndeksService" er udvidet med ny attribut "Borgervisning". Ændringen gør det muligt for it-systemer at undtage borgervisning for udvalgte journalnotater. Attributten er implementeret på relationen "Journalpost" og kan angives via "JournalPostLokalUdvidelse".
Anvendere kan skifte til denne version, hvis de ønsker at gøre brug af den nye funktionalitet.
Der er ingen ændringer til integrationens øvrige services.
Beskrivelse
Integrationen består af tre webservices, der giver kommunale fagsystemer mulighed for at aflevere til og vedligeholde metadata vedrørende forretningsobjekterne Sag og Dokument i Sags- og Dokumentindekset.
De tre webservices indeholder tilsammen fem operationer: Kassér, Fjern, Fremsøg, Importer og Opdatér.
Derudover er det muligt at modtage beskeder, når der er ændringer i sagers tilstand i Fælleskommunalt Sags- og Dokumentindeks.
Integrationen indeholder data fra diverse fag- og ESDH-løsninger, der vedrører sags- og dokumentobjekter, sammen med tilhørende relationer og roller. Der er ikke en fast datakilde, der leverer data til indeksene. Af fagsystemer vil det være løsninger som fx Kommunernes Ydelsessystem, UDK, SAPA og Kommunernes Sygedagpengesystem. Derudover vil mange kommunale ESDH-løsninger kunne levere data til indeksene.
Services
Formål
Servicen anvendes til fysisk sletning af dele af forretningsobjektet Dokument i Sags- og Dokumentindeks.
Beskrivelse
Servicen indeholder to operationer:
- Kassér – anvendes til fysisk sletning af dele af forretningsobjektet Dokument, fx sletning af en relation.
- Fjern – anvendes til fysisk sletning af et eller flere forretningsobjekter af typen Dokument. Dokumenter kan også fjernes i sammenhæng med sletning af en eller flere sager – se servicen SagDokumentIndeksService.
Servicen er udstillet med følgende sikkerhedsmodel:
- OIO IDWS
Eksternt testmiljø
Endpoint: https://sagsogdokumentindeks.eksterntest-stoettesystemerne.dk/dokumentindeks/6
Produktionsmiljø
Endpoint: https://sagsogdokumentindeks.stoettesystemerne.dk/dokumentindeks/6
Formål
Denne service anvendes til at importere, opdatere, fjerne og fremsøge forretningsobjekterne Sag og Dokument i Sags- og Dokumentindeks.
Beskrivelse
Servicen indeholder fire operationer:
- Import – anvendes til at tilføje nye sager og/eller dokumenter til indekset.
- Opdatér – anvendes til at opdatere eksisterende sager og/eller dokumenter i indekset, herunder til at tilføje journalnotater.
- Fjern – anvendes til at fjerne (fysisk slette) sager og evt. relaterede dokumenter fra indekset.
- Fremsøg – anvendes til at læse sager og/eller dokumenter i indekset.
For fysisk sletning af dele af sags- eller dokumentobjekter (fx sletning af en relation) anvendes operationen Kassér i hhv. servicen SagIndeksService og servicen DokumentIndeksService.
Servicen er udstillet med følgende sikkerhedsmodel:
- OIO IDWS
Eksternt testmiljø
Endpoint: https://sagsogdokumentindeks.eksterntest-stoettesystemerne.dk/sagdokumentindeks/6
Produktionsmiljø
Endpoint: https://sagsogdokumentindeks.stoettesystemerne.dk/sagdokumentindeks/6
Formål
Servicen anvendes til fysisk sletning af dele af forretningsobjektet Sag i Sags- og Dokumentindeks.
Beskrivelse
Servicen indeholder én operation:
- Kassér – anvendes til fysisk sletning af dele af et forretningsobjekt af typen Sag, fx sletning af en relation på sagen.
Servicen er udstillet med følgende sikkerhedsmodel:
- OIO IDWS
Eksternt testmiljø
Endpoint: https://sagsogdokumentindeks.eksterntest-stoettesystemerne.dk/sagindeks/6
Produktionsmiljø
Endpoint: https://sagsogdokumentindeks.stoettesystemerne.dk/sagindeks/6
Formål
Denne service giver mulighed for at modtage beskeder med information om ændringer til sager i Fælleskommunalt Sags- og Dokumentindeks.
Beskeder udsendes, når ændring til en sags tilstand er godkendt.
Beskrivelse
Servicen omfatter beskedtypen: Sagsindeks_TilstandAendret i version 1.0.
Beskrivelse af beskedtypen findes i bilagssamlingen i dokumentationen.
For at modtage en besked, skal man benytte en af de services, der indgår i SF1461 Modtag beskeder via Beskedfordeler.
Eksternt testmiljø
Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671
Produktionsmiljø
Endpoint: amqp://beskedfordeler.stoettesystemerne.dk:5671
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 fx 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
Teknisk support
Leverandør:
KMD
Enhedspris:
1.500 kr.
Antal enheder:
3-30
Indlæs data i Sags- og Dokumentindeks
Indlæsning af eksisterende data i Sags- og Dokumentindeks.
Ydelsen omfatter:
Læs mere
Teknisk support
Leverandør:
KMD
Enhedspris:
42.808 kr.
Antal enheder:
1
Integration til Sags- og Dokumentindeks
Oprettelse af Integration mellem et anvendersystem og Støttesystemet Sags- og dokumentindeks i driftsmiljøet.
Dette omfatter:
Læs mere
Teknisk support
Leverandør:
KMD
Enhedspris:
5.500 kr.
Antal enheder:
1
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
Teknisk support
Leverandør:
KMD
Enhedspris:
11.125 kr.
Antal enheder:
1
Sletning af bevillinger uden tilhørende sager
Med denne ydelse kan bestilles dokumentation af bevillinger uden sager samt efterfølgende sletning af disse bevillinger. Ydelsen kan bestilles af fx KOMBIT, Leverandører og/eller Myndigheder/Anvendere.
KMD gør følgende :
Læs mere
Teknisk support
Leverandør:
KMD
Enhedspris:
Se under 'Vilkår'.
Antal enheder:
1
Beredskabsydelse til Støttesystemerne i produktionsmiljøet
Denne ydelse er rettet mod anvendere, der har behov for et teknisk beredskab hos Støttesystemernes leverandør(-er) i forbindelse med fx gennemførsel af implementering i produktionsmiljøet for at sikre ekstra opmærksomhed i forbindelse med dennes opgaver i produktionsmiljøet.
Supportydelsen giver bestiller mulighed for at bestille et teknisk beredskab i forbindelse med bestillerens planlagte idriftsættelse. I bestillingen angives hvilket Støttesystem(er), beredskabet ønskes for:
Læs mere
Teknisk support
Leverandør:
KMD
Enhedspris:
1.500 kr.
Antal enheder:
Minimum tre timer
Beredskabsydelse til Støttesystemerne i Eksternt testmiljø
Denne ydelse er rettet mod anvendere, der har behov for et teknisk beredskab hos Støttesystemernes leverandør(-er) i forbindelse med fx gennemførsel af implementering i Eksternt testmiljø for at sikre ekstra opmærksomhed i forbindelse med dennes opgaver i testmiljøet.
Supportydelsen giver bestiller mulighed for at bestille et teknisk beredskab i forbindelse med en bestillers planlagte:
- Hul igennem test
- Systemintegrationstest
- End to end test
I bestillingen angives hvilket Støttesystem(er), beredskabet ønskes for:
Læs mere
Teknisk support
Leverandør:
KMD
Enhedspris:
1.500 kr.
Antal enheder:
Minimum tre timer
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.
Anvendersystemer kan få indlæst data i Fælleskommunalt Sags- og Dokumentindeks på to måder:
- Testdata indlæses af Anvender selv ved at benytte SOAP-snitfladen med operationen "Importer".
- Testdata indlæsning bestilles hos Støttesystemernes leverandør som en supportydelse her.
Bemærk:
- Det er Anvenderens eget ansvar at skabe testdata til indlæsning.
- Anvender kan indgå aftale med en anden Anvender om at teste sammen med dennes indlæste sager.
Koordinering
Af hensyn til allokering af myndigheder og modtagelse af organisationsformularer uden personhenførbare data, bør test koordineres via KOMBIT (FKI@kombit.dk).
I de tilfælde, hvor anvender selv er i tæt samarbejde med en kommune omkring testen på Eksternt testmiljø, kan de selv forestå denne koordinering. KOMBIT skal dog stadig orienteres om disse aktiviteter for at sikre, at andre anvenderprojekter ikke har sammenfaldende testaktiviteter.
Kodeeksempler
Kodeeksemplerne demonstrerer, hvordan klasser genereres på baggrund af WSDL-filerne og hvordan webservices kaldes for bl.a. Sags- og Dokumentindeks. Kodeeksemplerne for .NET understøtter .NET 4.8. Der er kendte udfordringer med OIOIDWS, hvis man anvender nyere versioner af .NET - i maj 2023 publicerede KOMBIT derfor et kodebibliotek, der er en videreudvikling af Digitaliseringsstyrelsens OIOIDWS.Net-pakke.
Hændelser
Via integration til Beskedfordeleren kan man abonnere på ændringer i Fælleskommunalt Sags- og Dokumentindeks, så der modtages notifikationer, når sager ændrer tilstand til:
- Sag.fremdrift=status opstået (=start)
- Sag.fremdrift=status afsluttet (=slut)
Anvend integrationen i produktion
Du finder mere information på siden om Fælleskommunalt Sags- og Dokumentindeks.
Service Level Agreement (SLA)
Information om SLA’er og åbningstider for den fælleskommunale infrastruktur finder du på denne side.