Beskedfordeler

En besked repræsenterer en forretningsmæssig hændelse. Det kan fx være, at der er ændringer i en sag, at en person er flyttet til en ny adresse, at en borger er udskrevet fra sygehuset osv.

En besked består af:

• En beskedkuvert, der indeholder tekniske og forretningsmæssige data, der bruges til at identificere beskeden. Beskedkuverten indeholder fx filtreringsdata, der beskriver det forretningsmæssige indhold. Beskedkuverten indeholder også leveranceinformation/tekniske data om beskeden; hvor den kommer fra og hvor den må sendes hen.
• Beskeddata, der indeholder forretningsmæssige data, der er specifikke for netop denne type af besked.

De hændelser, som it-systemer kan modtage eller afsende som beskeder via Beskedfordeler, er specificeret som ”beskedtyper”. For hver beskedtype er defineret beskedkuvert og beskeddata.

Der er beskrivelser af de respektive beskedtyper i dokumentationen til de integrationer i infrastrukturen, der benytter beskeder.

Beskeder afsendes typisk i forbindelse med at en hændelse/ændring sker i et afsendersystem. 

Der er dog nogle afsendersystemer, hvor hændelser kun opdateres med fast intervaller – fx i en natlig kørsel – og her vil beskeder kun blive afsendt med et fast interval.

Et it-system, der modtager beskeder, skal altid hente beskederne umiddelbart når de er tilgængelige. 

Beskedfordeleren opbevarer beskeder i op til 7 dage (kan ændres op til 30 dage i brugergrænsefladen), men dette er kun tænkt som en sikring mod at miste beskeder i fejlsituationer. Du må ikke bruge Beskedfordelen til at opbevare beskeder.

Dit it-system må kun modtage en beskedtype, hvis der er lovhjemmel til det og der er et begrundet formål med at modtage og behandle beskederne i it-systemet.

For at dit it-system kan modtage beskeder, skal den eller de kommuner, der bruger dit it-system, godkende en serviceaftale. Det sker i Fælleskommunalt Administrationsmodul. Det er kommunen, der skal sikre, at der er lovhjemmel og at det er i orden at bruge beskedtypen til formålet.

Det er en god idé, at du tidligt undersøger, om der er lovhjemmel og et begrundet formål til at benytte data i en beskedtype i dit it-system. Ellers risikerer du at implementere en løsning, som kommunerne ikke må bruge. 

Du kan bruge Fælleskommunal Beskedfordeler til at sende beskeder, når du har:

1. En væsentlig forretningsmæssig hændelse
   Når der er en ændring/hændelse i dit it-system om væsentlige forretningsmæssige forhold, der er relevante for omverdenen. Fx når en borger bliver udskrevet fra sygehuset, en kommunal enhed har skiftet adresse, tilstanden af en sag har ændret sig osv.
    
2. En afsender, som ikke nødvendigvis kender modtageren
   Beskedfordeleren er designet til, at afsender af en besked ikke behøver at kende de præcise modtagere. Afsender har derfor ikke mulighed for at få informationer om hvorvidt en besked er nået frem til en given modtager, men behøver omvendt heller ikke tage højde for hvem der modtager beskeden.
    
3. En hændelse, som kan være relevant for endnu ukendte modtagere
   Ofte vil en beskedtype blive implementeret for at løse et specifikt behov. Her står man over for et designvalg mellem at lave en direkte integration mellem it-systemer eller at sende beskeder via Beskedfordeler. Du bør vælge Beskedfordeleren, når det er sandsynligt, at der vil være flere sagsgange eller it-systemer, der på sigt får behov at kunne reagere på de hændelser, som genererer beskedtypen.
    
4. En hændelse som kan beskrives på lidt plads
   Beskeder om hændelser er i praksis mindre end 1 MB. Hvis du har behov for at overføre større mængder data for at modtagersystemer kan reagere på en hændelse i dit it-system, kan dit it-system udstille en service, hvor modtagersystemer kan hente de ekstra data. På den måde skal dit it-system blot sende en besked med tilstrækkelig information til at et modtagersystem kan identificere hvilke data, det skal hente via den udstillede service.

For at kunne sende beskeder om nye typer hændelser, skal der defineres en ny beskedtype, som beskriver det præcise format (beskedkuvert og beskeddata) af indholdet i den nye beskedtype. 

Hvis du har behov for en ny beskedtype, skal du melde det ind som et ændringsønske på via formularen i Digitaliseringskataloget - så hjælper KOMBIT dig med at få defineret beskedtypen korrekt og med at få konfigureret Beskedfordeler til det nye formål. 

Brugergrænsefladen til Beskedfordeleren bruges af leverandører af it-systemer, der skal modtage beskeder til at konfigurere ”dueslag” til modtagelse. Hvis dit it-system kun skal afsende beskeder, har du ikke behov for at kunne logge på brugergrænsefladen.

Når du er logget på brugergrænsefladen, kan du redigere opsætning af dueslag for de it-systemer, der er oprettet under din virksomheds CVR-nummer i Fælleskommunalt Administrationsmodul.

For at få adgang til brugergrænsefladen, skal du benytte MitID. Du skal have din organisations NemLog-in administrator til at tildele dig en eller begge af nedenstående roller i NemLog-ins Brugeradministration:

• ”Beskedfordeler - Ekstern test - Anvendersystemadministrator” for at kunne opsætte og administrere dueslag til modtagelse af beskeder i det eksterne testmiljø.
• ”Beskedfordeler - Anvendersystemadministrator” for at kunne opsætte og administrere dueslag til modtagelse af beskeder i produktionsmiljøet.

Du kan læse mere om brugergrænsefladen i brugerdokumentationen her.

Du finder links til brugergrænsefladen her:

• Brugergrænseflade til Fælleskommunal Beskedfordeler (Eksternt testmiljø)
• Brugergrænseflade til Fælleskommunal Beskedfordeler (Produktionsmiljø)

Er du i tvivl, om du skal bruge Fælleskommunal Beskedfordeler, Fælleskommunal Filudveksling eller Fælleskommunal Fordelingskomponent, kan du her læse hvornår du skal vælge den ene eller anden løsning:

• Beskedfordeler: Når du har brug for at kunne reagere på hændelser i andre it-systemer og datakilder, eller når andre it-systemer skal have besked om hændelser i dit it-system. Beskeder kan fx handle om, at en borger har skiftet adresse eller at en sag er blevet oprettet/ændret.
   
• Filudveksling: Når du har brug for at sende eller modtage datafiler til/fra andre it-systemer. Filerne kan fx indeholde oplysninger om borgeres indkomstforhold eller ledelsesinformation.
   
• Fordelingskomponent: Når du har brug for at overdrage dokumenter eller journalnotater mellem it-systemer. Fx kan et journalnotat, som Borgerservice har oprettet, sendes videre til det it-system, hvor borgerens sag behandles, eller sagsdokumenter kan sendes videre, hvis en borgers sag overdrages.