Dialogmeldinger (import)

Dette kapittelet inneholder informasjon om import av PLO-meldinger ved hjelp av tilstandsmaskinen «DialogMessageImportArena» i DIPS Message Broker.

Message Broker Channel

Message Broker Channels filadapter må være satt opp til å håndtere innkommende XML-filer på KITH meldingsformat.

Ruting av dialogmeldinger, oppsett av filter

Meldingstypen som kommer fra KITH vil være den samme for PLO og frittstående dialogmelding (feks DIALOG_AVVIK). Hvis man mottar både PLO og frittstående dialogmeldinger i samme kanal (filshare, msmq) må det settes opp et filter. Se dokumentasjonen for DIPS Dialoge Message for hvordan dette gjøres.

Hvis man ikke ønsker å ta i bruk DIPS Dialogue Message for frittstående dialogmeldinger til fastlege, men fortsatt vil behandle disse i PLO Arena tilstandsmaskin er det mulig ved å sette "PerformExtendedPLOCheck" (se dokumentasjon av variabler i tilstandsmaskinen). Dette vil kreve endringer i filteret også, ta kontakt med DIPS Support for mulig oppsett her. Vi anbefaler imidlertid at frittstående dialogmeldinger til fastlege håndteres av DIPS Dialogue Message.

Ruting i Message Broker

Følgende meldingsrutinger må være satt opp for å kunne importere dialogmeldinger:

Forespørsel:

ObjectName: KITHARENA
ObjectEvent: DIALOG_FORESPORSEL

Svar på forespørsel:

ObjectName: KITHARENA
ObjectEvent: DIALOG_SVAR

Tilbakemelding om feil i mottatt melding:

Disse importeres dersom du importerer filen [installdir]\Message Broker\config\Routing\PloArena.xml

Output Routing i Message Broker

«DialogMessageImportArena» bruker output routing for utsending av applikasjonskvittering.

Routing key

Beskrivelse av konfigurering

(tom)

Normal utsending av applikasjonskvittering.

ERRORAPPREC

Lagring av applikasjonskvittering som feilet i validering før sending.

ERROR

Lagring av melding som feilet ved import.

Variabler i tilstandsmaskinen

Navn
Funksjon

PatientCreation

Hvis true opprettes en ny pasient i DIPS i tilfelle pasienten ikke finnes fra før. Default: true

PatientSearchEnhanced

Angir om «utvidet» pasientsøk skal brukes, hvilket betyr nøyaktig søk på navn og fødselsdato i tilfelle fødselsnummer ikke blir funnet. Default: true

AllowGenerationofNationalId

Angir om et nytt hjelpenummer skal brukes ved opprettelse av pasient i tilfelle meldingen ikke inneholder fødselsnummer. Default: true

AcceptHNO

Variabel for å angi om hjelpenummer i meldingen skal aksepteres ved mottak av henvisning. Default: true

FailWhenNoHospitalCanBeFoundFromMessage

Stopper prosessering hvis det oppstår feil ved identifisering av sendere og mottaker i meldingen. Default: true

PerformExtendedPLOCheck

Benyttes til å angi om det skal kreves at innkommende meldinger er adressert til PLO Meldingsmottak for at de skal behandles som PLO dialogmeldinger. Benyttes kun for bakoverkompabilitet der frittstående dialogmeldinger fortsatt behandles av tilstandsmaskin for PLO og ikke i ny tilstandsmaskin for dialogmelding._ Aktiverer sjekk av at mottakeren har HER-id og at dette er angitt i parameterenPLOServiceHERIDs. Hvis ikke brukes alternativ utleding av arbeidsgruppe vedManualWorkGroupIdConfig.config. Default: false

PLOServiceHERIDs

Brukes for sjekk av mottakers HER-id hvisPerformExtendedPLOChecker aktivert. Default: 222,333 (må konfigureres)

AllowDuplicateImports

Settes til false for å stoppe import av meldinger med sammeMsgIdflere ganger. Default: true

AllowNotification

Angir om det skal sendes varsler for dialogmeldinger i PLO-sak dersom man har abonnert på det. Default: False

AdmittedPatientGetUrl

Default:

WorkGroupIdGetUrl

Default:

ConnectFolderPostUrl

Default:

OrgUnitsFromRefToParentGetUrl

Default:

CheckHnrRefToConversationPostUrl

Default:

UpdateMessageStatusPostUrl

Default:

Konfigurering av ressursovervåkning

Konfigurering av ressursovervåkning for MunCareWebReq.config ("Deliverable\DIPS-MessageBroker-Service\config\dllconfig\DialogMessageImportArena\MunCareWebReq.config"):

  • Sett "UseResourceMonitoring" til "true"

  • Legg til hele HealthCheckUrl inkludert "https://" slik at denne stemmer med installasjonen

Konfigurasjonsfiler

Følgende konfigurasjonsfil er viktig for å endre oppsett av import av dialogmelding. Filen finnes i katalogen <DIPS MB InstallDir>/config/dllconfig/DialogMessageImportArena.

Navn

Funksjon

DefaultValues.xml

Gir mulighet for å sette default avsender.

Standardverdier

Det er mulig å sette følgende standardverdi i filen DefaultValues.xml: +

DefaultSenderReqCode: Denne verdien benyttes til å sette dokumentforfatter dersom det ikke lykkes å finne forfatter ut fra innkommende melding. Vi anbefaler at denne verdien settes til en gyldig rekvirentkode i DIPS.

Generering av applikasjonskvittering

Basert på innhold og resultatet av importen av innkommende melding, genereres det applikasjonskvittering på KITH-format. Følgende situasjoner fører til at det genereres en applikasjonskvittering:

Hendelse

Resultat

Innkommende melding validerer ikke

Det genereres applikasjonskvittering med status 2(avvist) og feilmelding «XML validerer ikke».

Det mangler fødselsnummer på pasienten i innkommende melding

Det genereres applikasjonskvittering med status 2(avvist) og feilmelding «Pasientens fødselsnummer mangler».

Pasientens fødselsnummer er ugyldig

Det genereres applikasjonskvittering med status 2(avvist) og feilmelding «Pasientens fødselsnummer er feil».

Mottaker finnes ikke

Det genereres applikasjonskvittering med status 2(avvist) og feilmelding «Mottaker finnes ikke».

Generell feil under import av meldingen

Det genereres applikasjonskvittering med status 2(avvist) og feilmelding «Annen Feil».

Meldingen blir importert korrekt

Det genereres applikasjonskvittering med status 1(OK).

Applikasjonskvitteringer skrives til katalog angitt i Output Routing for tilstandsmaskinen med tom routingnøkkel. +

Dersom en feil som fører til at utgående applikasjonskvittering ikke validerer oppstår, skrives applikasjonskvittering til en egen feilkatalog, angitt i Output Routing for tilstandsmaskinen med routingnøkkel APPRECERROR. +

Applikasjonskvittering sendes kun for mottaker i egen organisasjon, det vil si organisasjon med ERDATABASEBRUKER=1 i basen.

Avsenders rolle

Avsender av meldingen benyttes som forfatter av journaldokumentet som den innkommende meldingen resulterer i. Forfatter må derfor være en gyldig rekvirent i DIPS. Forfatteren forsøkes funnet etter følgende regler: +

Forsøk med nærmest angitte ORG. Hvis treff, brukes ORG som forfatter av journaldokumentet. Hvis ORG ikke gir treff, forsøk med moderorganisasjonen. +

Hvis ingen av verdiene i meldingen gir treff, brukes DefaultSenderReqCode fra DefaultValues.xml til å finne forfatter av journaldokumentet.

Arbeidsflyt

Det opprettes en arbeidsoppgave av typen «Dokumenter til vurdering» når meldingen importeres. Arbeidsflyten styres av om pasienten er innlagt eller ikke:

Arbeidsflyt når pasienten er innlagt

Hvis pasienten er innlagt, er det verdien av oppsettparametret Default arbeidsgruppe for meldinger som bestemmer hvilken arbeidsgruppe arbeidsoppgaven havner i. Verdier for sykehus, avdeling og post hentes fra innleggelsen.

Arbeidsflyt når pasienten ikke er innlagt

Hvis pasienten ikke er innlagt, er det fremdeles Default arbeidsgruppe for meldinger som bestemmer hvilken arbeidsgruppe arbeidsoppgaven legges i. Dersom den importerte meldingen er et svar på en melding som tidligere er sendt på denne pasienten, vil de organisatoriske enhetene knyttet til pasientens omsorgsepisode ved opprinnelig melding benyttes ved valg av arbeidsgruppe.

Innslag i pasientens meldingslogg

Under import av meldingen gjøres det et innslag i korrespondanseloggen. Navn på avsender, hovedmottaker og kopimottakere hentes i utgangspunktet fra meldingen etter følgende regler: +

Avsender: Som avsender velges mest nøyaktig angitte HealthCareProfessional (HCP) fra KITH-meldingens Sender-element. Dersom mest nøyaktige organisasjon ikke inneholder et HCP-element, vil navnet på denne organisasjonen bli brukt i loggen.

Hovedmottaker: Som hovedmottaker velges mest nøyaktig angitte HealthCareProfessional (HCP) fra KITH-meldingens Receiver-element. Dersom mest nøyaktige organisasjon ikke inneholder et HCP-element, vil navnet på denne organisasjonen bli brukt i loggen.

Kopimottakere: Som kopimottakere velges alle organisasjoner under OtherReceiver-elementet som er av type COP.

Korrespondanseloggen vil også vise status på arbeidsoppgaven som ble opprettet under importen av meldingen.

Meldinger som feiler ved import

Dersom en melding feiler under import, vil den bli skrevet til en egen katalog, angitt i Output Routing for tilstandsmaskinen med routingnøkkel ERROR. Alle innkommende meldinger som resulterer i en negativ applikasjonskvittering vil skrives til denne katalogen.

Oppretting av pasient

Dersom pasient angitt i meldingen ikke eksisterer i DIPS, vil denne bli forsøkt opprettet og meldingen importert.

Oversikt over logikk i tilstandsmaskin

Dialogmelding importeres etter følgende regler:

FlytskjemaPLODialogmelding

Last updated