Forretningsmæssigt overblik: Beskedfordeler

Her kan du få overblik over hvilke beskeder du allerede nu kan modtage, og hvad du skal overveje inden du benytter Fælleskommunal Beskedfordeler til nye formål

Med Fælleskommunal Beskedfordeler kan du afsende og modtage beskeder

Fælleskommunal Beskedfordeler kan benyttes til at afsende beskeder, når der sker en hændelse, som kan være relevant for omverdenen. Et givent it-system vil som regel enten skulle afsende beskeder eller modtage en given type beskeder, men i nogen tilfælde begge dele.

Fælleskommunal Beskedfordeler er den komponent i den fælleskommunale infrastruktur, der understøtter det fælleskommunale arkitekturprincip: AR 5.3: Betydelige forretningshændelser skal kunne meddeles omverdenen (FK).

Hvad er en besked?

En besked repræsenterer en forretningsmæssig hændelse fx at der er ændringer i en sag, at en person er flyttet til en ny adresse, at en person er udskrevet fra et hospital, osv.

Alle beskeder har samme tekniske format, der er illustreret nedenfor:

En besked består kort fortalt af:

En beskedkuvert, der indeholder tekniske og forretningsmæssige data til at identificere beskeden. Beskedkuverten indeholder fx filtreringsdata, der beskriver det forretningsmæssige indhold af beskeden i termer, der benyttes på tværs af det fælleskommunale it-landskab. Beskedkuverten indeholder desuden leveranceinformation, der beskriver 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 beskeder.

For hver type af besked er skrevet et dokument, kaldet en beskedtypebeskrivelse, der angiver, hvordan de forretningsmæssige data ser ud for netop denne type beskeder. Derved kan både afsender og modtager forstå indholdet af beskeden på samme måde. Du kan finde beskedtypebeskrivelsen i dokumentationen af de integrationer, der benytter beskeder, som er listet nedenfor.

Modtag beskeder via Fælleskommunal Beskedfordeler

Fælleskommunal Beskedfordeler fordeler allerede i dag en række beskeder om forskellige hændelser, som dit it-system kan modtage. Du kan modtage beskeder i forbindelse med følgende integrationer:

Hvis du har et system, der kan få glæde af en eller flere af disse beskeder, kan du med det samme gå i gang med at benytte dem. Du skal blot integrere dit it-system til Fælleskommunal Beskedfordeler og abonnere på de relevante beskeder.

Beskeder afsendes typisk umiddelbart i forbindelse med at en hændelse sker. Der er dog nogle systemer, hvor hændelser kun opdateres med fast intervaller – fx i en natlig kørsel – og her vil beskeder derfor kun blive udsendt i forbindelse med sådanne kørsler. Du kan læse nærmere om frekvensen af de enkelte beskedtyper i dokumentationen for integrationerne ovenfor.

Må du modtage en besked?

Du skal være opmærksom på, at du kun må modtage en besked, hvis der er lovhjemmel til det og du har et begrundet formål med at modtage og behandle beskeden.

For at kunne modtage beskederne skal kommunen godkende en serviceaftale om modtagelsen. Det er derfor op til kommunen at sikre, at der er lovhjemmel og at det er i orden at benytte en given type besked til et givet formål.

I praksis er det altid en god idé, at du tidligt i forløbet undersøger, om der er lovhjemmel og et begrundet formål til at benytte data i en besked i en given sammenhæng. Ellers risikerer du at implementere en løsning, som kommunerne ikke må bruge. Du kan læse mere om lovhjemmel til at benytte Fælleskommunal Beskedfordeler i integrationsbeskrivelserne for SF1461 Modtag beskeder via Beskedfordeler og SF1462 Afsend beskeder via Beskedfordeler.

Afsende beskeder via Fælleskommunal Beskedfordeler

Hvis dit it-system genererer hændelser, som er relevante for andre it-systemer i det fælleskommunale systemlandskab, kan du benytte Fælleskommunal Beskedfordeler til at distribuere beskeder om hændelserne.

Har du behov for nye typer beskeder?

For at kunne sende beskeder omkring nye typer hændelser, skal der defineres en ny beskedtype i Fælleskommunal Beskedfordeler, som beskriver det præcise format af indholdet i den nye beskedtype. Hvis du gerne vil definere en ny type af beskeder, skal du anmode om et ændringsønske på siden for ændringsønsker - så hjælper KOMBIT dig med at få defineret beskeden korrekt og med at få konfigureret Fælleskommunal Beskedfordeler til det nye formål. Bemærk, at hvis du er fra UDK eller fra et KOMBIT-projekt, skal du følge den sædvanlige interne bestillingsprocedure for bestillinger til KOMBIT/KDI.

Hvornår bør man bruge Fælleskommunal Beskedfordeler til at afsende beskeder

Fælleskommunal Beskedfordeler kan anvendes, når du har:

En væsentlig forretningsmæssig hændelse
Når der er registreret en ændring i dit it-system om væsentlige forretningsmæssige forhold, der er relevante for omverdenen. Fx når en borger bliver udskrevet fra hospitalet, en kommunal forvaltning har skiftet adresse, tilstanden af en sag har ændret sig.
En afsender, som ikke nødvendigvis kender modtageren.
Fælleskommunal Beskedfordeler er designet til scenarier, hvor afsender ikke behøver at kende de præcise modtagere. Afsender har derfor ikke mulighed for at få informationer om hvorvidt en given besked er nået frem til en given modtager, men behøver omvendt heller ikke tage højde for hvem der i sidste ende modtager beskeden.
En hændelse, som kan være relevant for endnu ukendte modtagere.
Ofte vil en ny 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 systemer eller at sende beskeder via Fælleskommunal Beskedfordeler. Man bør vælge Fælleskommunal Beskedfordeler, når det er sandsynligt, at der vil være flere sagsgange eller systemer, der på sigt får behov at kunne reagere på de hændelser, som genererer den nye beskedtype.
En hændelse som kan beskrives på lidt plads.
Beskeder om hændelser er af natur små; i praksis mindre end 1 MB. Hvis der er behov for at overføre større mængder data, for at modtagersystemet kan reagere på en hændelse, så kan man udstille en service til at hente de ekstra data og blot udsende en besked med tilstrækkelig information til at identificere hvilke data, der skal hentes.

Hvornår bør man ikke bruge Fælleskommunal Beskedfordeler

Som beskrevet ovenfor giver Fælleskommunal Beskedfordeler en løs kobling mellem afsendersystemet og modtagersystemet, hvor afsendersystem ikke nødvendigvis kender alle modtagersystemer.

Hvis du har brug for at et afsendersystem overdrager ansvar for en given opgave til et modtagersystem, kan du i stedet bruge Fælleskommunal Fordelingskomponent, der giver en forretningsmæssig kvittering for modtagelse af ”beskeder” mellem to systemer.

Beskedintegrationer til specifikke formål

Fælleskommunal Beskedfordeler kan også benyttes til at sende hændelsesbeskeder med specifikke formål, hvor beskederne kun er tiltænkt specifikke arbejdsgange, der kun understøttes af få it-systemer. Disse beskeder må man ikke abonner på, hvis man ikke er i den tiltænkte modtagergruppe. Der findes i dag følgende integrationer til specifikke formål:

SF2610 Tidlig Pension Hændelser, der kun bruges af Udbetaling Danmark (UDK)

Særligt for SKI rammeaftale 02.19

Staten og Kommunernes Indkøbsservice, SKI, har rammeaftale 02.19, der henviser til en række integrationer på Fælleskommunal Beskedfordeler. Disse er navngivet efter en tidligere navngivningsstandard, som SF1460_A, SF1460_B, SF1460_C og SF1460_D.

Disse integrationer er erstattet af SF1461 Modtag beskeder via Beskedfordeler og SF1462 Afsend beskeder via Beskedfordeler for at simplificere kommunikationen om den forretningsmæssige brug af Fælleskommunal Beskedfordeler. I SKI 02.19 bilag E.2, E2.1 og E.2.2 bruges fortsat den oprindelige navngivning.

De nye og de gamle integrationer til præcis de samme tekniske services. Leverandører, der leverer under SKI 02.19, henvises derfor til dokumentationen for SF1461 og SF1462.

SF1461 Modtag beskeder via Beskedfordeler:

SF1460_A er en delmængde af SF1461, der alene består af en enkelt service: BeskedFåTilsendt.
SF1460_B er en delmængde af SF1461, der alene består af enkelt service: VærdilisteRediger.
SF1460_D er en delmængde af SF1461, der alene består af enkelt service: BeskedHent.

SF1462 Afsend beskeder via Beskedfordeler:

SF1460_C indeholder præcis det samme som SF1462 og består af en enkelt service: BeskedAfsend.