Aktivering av TB-Tjenestebuss køer og arv

Owned by kjetill.vassmo.lund, created
Last updated: Feb 02, 2023 by Kenneth Myhra
5 min read

All meldingsutveksling foregår via RabbitMQ Tjenestebuss og egne køer for alle kommunikasjonsparter.

Når Tjenestebuss aktiveres på en virksomhet blir det opprettet en kø på Tjenestebuss for virksomheten, og en egen kø for hver kommunikasjonpart under virksomheten. Disse køene blir lagt inn i adressefeltene i AR.

For å forenkle drift og overvåkning av løsninger er det innført mulighet for arv av køer. Det innebærer at flere kommunikasjonsparter kan kommunisere via samme kø - analogt med EDI meldingsutveksling for virksomheten.

Når arv bestilles for en mengde virksomheter, vil scriptet også sette at nye kommunikasjonsparter også får arv.

Bestilling av endring til kø-arv på TB gjøres på følgende måte:

  • EPJ sender epost til kundesenter@nhn.no med de kontorer som skal over – NB! merket "Kø-arv i AR"

    • Bestillingen inneholder liste over Virksomheters HERID – hvor alle underliggende kommunikasjonsparter skal bruke arv. Dette må da være FL-virksomheter som kun har én EPJ tilknyttet, slik at all trafikk kan gå til samme virksomhetskø.

    • Hvis det er viktig med koordinering av tidspunkt for opprettelse og endring av køene, så må kontaktperson vedlegges i saken, slik at NHN kan informere.

    • NHN.saksnr fordeles til GD-dagvakt med beskjed om å kjøre script for å endre til Kø-Arv.

  • Dersom én kommunikasjonspart har egne køer, må evt. arv settes manuelt!

Dokumentasjon: FERDIG
Løsningen: I DRIFT

Forretningsbehov

Id

Brukerhistorie

Forretningsmessige akseptansekriterier

1

Som EPJ leverandør ønsker jeg færre køer å lytte på slik at drift og overvåkning av meldingsutveksling blir enklere.

  1. Køer opprettes på organisasjons nivå

  2. Underliggende kommunikasjonsparter benytter organisasjonens felles kø, slik at det blir færre køer å lytte på.

2

Som fastlege-virksomhet ønsker jeg at ved kø-oppsett på nivå 1, og alle eksisterende tjenester (nivå 2) er satt opp med arv, skal alle nye tjenester som kobles inn også settes opp med arv automatisk.

Dersom alle fastleger/tjenester under virksomheten med CPP/kø-oppsett benytter arv, skal dette også settes automatisk ved opprettelse av nye kommunikasjonsparter.

3

Som kommunal-tjeneste ønsker jeg å ønsker jeg selv å kunne bestemme kø-oppsett på de enkelte tjenester, for å evt. legge opp til arv på de kommunikasjonsparter som går til hoved EPJ som støtter mange tjenester.

Det må være mulig for EPJ/Virksomhet å sette riktig kø-arv oppsett i henhold til virksomhetens tjenester.

Forutsetninger & tips

  1. Forutsetning for å benytte kø-arv fra virksomhet er at EPJ har CPP integrasjon med AR.

  2. Det er et ønske at alle legekontorer benytter arvede køer fra virksomheten, på alle sine kommunikasjonsparter. NB! dette gjelder ikke kontorer med tjenstester knyttet til andre EPJ systemer. (Arv kan benyttes på ønskede felles tjenester, men dette må håndteres spesielt!)

  3. Virksomheter som fikk aktivert Tjenestebuss før "arv av Tjenestebuss" ble implementert, har ikke sin egen kø. En slik kø kan opprettes ved å aktivere Tjenestebuss på nytt ved bestilling til kundesenter@nhn.no.

  4. Hvis man aktiverer Tjenestebuss på nytt på en virksomhet vil det ikke skje noe annet enn at AR synkroniseres med TB på nytt, og at manglende virksomhetskøer opprettes. Køer (fra kommunikasjonspartene) som ikke lenger refereres fra AR blir markert for sletting.

  5. Hver lege har fortsatt hvert sitt CPP oppsett og kan styre hva de støtter funksjonelt. Meldingene sendes bare teknisk via en annen kø enn før. Kommunikasjonsparten er den samme.

Skru på arv

En kommunikasjonpart har som standard sine egne køer i Tjenestebuss. I noen tilfeller vil det ikke være nødvendig med egne køer og man ønsker å gjenbruke køen til overliggende enhet. Da kan man skru på arv.

Opprette køer på virksomhet => må gjøres av admin/NHN

  1. Dette gjøres ved å aktivere køer på virksomheten først
    Velg rediger på legekontoret og velge Tjenestebuss [Aktiver]
    Bekreftelsen vises som her:

    Deretter ser man at køene er aktivert:

  2. Lagre - køene er opprettet.


Velge arv på de tjenestene som skal benytte virksomhetens køer => må gjøres av enheten selv

  1. For å fullføre arv må du velge dette på hver kommunikasjonpart (person evt. tjeneste):
    I edit-modus kan du trykke på [pilen] som vist i bildet under, for å velge arv fra virksomheten.

    Arv vil da gjelde for alle typer køer for denne kommunikasjonparten (Sync, Async, Error). 

  2. Så må du bekrefte at du ønsker arv av AMQP-køer fra overliggende virksomhet.

     

  3. Etter bekreftelsen vises dette ved at det er endret til “Arves fra virksomheten“

     

  4. Lagre for at endringene skal beholdes.

  5. Til slutt må du inn for å oppdatere CPP - kun gå inn på siden og lagre, for at endringene skal oppdateres her.

 

Når man skrur på arv vil dette igangsettes ila 1t. De eksisterende køene bli markert for sletting, og vil slettes etter 4 døgn/97 timer.

NB! Det er eieren av kommunikasjonparten sitt ansvar å påse at det ikke er klienter som forventer å finne en kø på de gamle adressene.
EPJ må tømme de gamle køene, og starte å lytte på nye køer. 

Kun intern NHN:

 

Teknisk Implementasjon

Når scriptet kjøres av NHN på virksomheter som skal ha arv på alle kommunikasjonsparter, vil det samtidig (Fom. grunndatas leveranse 1/5.22) bli satt en egenskap i AR som sørger for at alle fremtidige nye kommunikasjonsparter opprettes med arv.

Integrasjonskrav:

  1. Uten integrasjon i EPJ, settes arv manuelt i AR - dette er EPJ-leverandøren/virksomhetens ansvar.

  2. For å minimere behovet for koordinering.
    a) EPJ bør automatisk identifisere at køer er tilgjengelig på virksomheten og arv er tatt i bruk for en kommunikasjonspart. EPJ skal lytte på gamle køer i minst 1 time dersom dette avdekkes automatisk
    b) Dersom EPJ ikke automatisk avdekker bruk av arv skal EPJ lytte på gamle køer i minst 4 dager. Dette for å sikre at nye og gamle køer blir håndtert i overgang til arv.