Integrering med Norsk helsenetts Dokumentlager

Merk ℹ️
For spørsmål knyttet til dokumentdeling, eller integrering som dokumentkilde, er du velkommen til å kontakte oss i vår Slack-kanal #ext-nhn-pasientens-journaldokumenter

Nedenfor beskrives de vanlige integrasjonstrinnene for å bli en dokumentkilde ved bruk av NHN Dokumentlager, utviklet av Norsk helsenett. Vanlig integrasjon følger en «gradvis overgang» fra å lagre alt i eksisterende lagringsløsning, til å laste opp både i lagringsløsningen og i NHN Dokumentlager, noe som gir en smidig overgang.

NHN Dokumentlager er en IHE XDS/XCA-kompatibel XCA-svarsgateway med integrert register og lager utviklet av Norsk helsenett.

Trinn ved integrering med Norsk helsenetts lagringsløsning

Som integratør vil du hovedsakelig samhandle med to tjenester: NHN Dokumentlager API og NHN Document Repository.

• NHN Dokumentlager API (Audience: nhn:repo) er inngangsporten til dokumentlagring og inneholder endepunkter for opplasting av en FHIR-bunke
• NHN Document Repository er lagringsløsningen som brukes i Norsk helsenett. Det kjører flere instanser av NHN Document Repository i våre miljøer.
  • Ved integrasjon vil du motta Object Identifiers (OID) – en HomeCommunityId og RepositoryUniqueId som identifiserer din instans av NHN Document Repository.

I ditt eksisterende lagringssystem må du opprette en videresendingsmekanisme som fungerer som følger:

• Dokumentet og metadata må transformeres til en FHIR-bunke i samsvar med ITI-65-transaksjonen i MHD-profilen.
• Før opplasting av FHIR-bunken må alle egendefinerte koder og kodesystemer mappes i henhold til den norske IHE XDS-metadataspesifikasjonen og kodesystemene som brukes i helsevesenet i Norge.
  • Norsk profil for XDS-metadata
• Når et dokument lastes opp til din lagringsløsning, sendes dokumentet og metadata også til NHN Dokumentlager API, som videresender det til din tildelte instans av NHN Document Repository.
• Svaret vil inneholde et FHIR OperationOutcome som signaliserer om operasjonen ble fullført med eventuelle feil. Dette bør håndteres enten av integrasjonsmotoren eller grensesnittet, avhengig av mekanismen for videresending av dokumenter.

Integrasjonsdokumentasjon for ITI-65

Slack-kanal for integrasjonsspørsmål

For å få en instans av NHN Document Repository, og for spørsmål om integrasjoner, er du velkommen til å kontakte oss i vår Slack-kanal:
#ext-nhn-pasientens-journaldokumenter

Migrasjonsprosess for datalagring

Steg 1: Eksisterende lagringsløsning (0 % av dokumenter lagret i NHN-infrastruktur)

Dette kan representere den nåværende arkitekturen til et EPJ-system som ønsker å koble seg til NHN Dokumentlager, der dokumentene er lagret i systemets lokale lagringsløsning.

Se Leverandørens dokumentlager for mer informasjon.

flowchart LR

act[Helsepersonell]

subgraph "EPJ-system"
    eepr[EPJ-system]
    epdb[(Lagringsløsning)]
end

act--Laster opp dokumenter-->eepr

eepr --Laster opp til<br>intern lagring--> epdb

Steg 2: Parallell lagringsløsning med NHN Dokumentlager (25–75 % av dokumenter lagret i NHN-infrastruktur)

Dette er vanligvis hvordan en overgangsfase ser ut, der du lagrer dokumenter i begge register/lager samtidig, slik at NHN Dokumentlager kan forespørres av Norsk helsenetts XCA Initiating Gateway og eksponerer de delte dokumentene gjennom NHN Dokumentlager som et målfellesskap. Det kan være nødvendig med noe migrering for å synkronisere alle dokumentene mellom det eksisterende systemet og NHN Dokumentlager.

Dette er en enkel tilnærming som gjør det mulig å hente dokumenter fra eksisterende lagring som normalt, samtidig som de gjøres tilgjengelige for det bredere XCA-fellesskapet.

For noen aktører er denne parallelle/hybride løsningen en tilstrekkelig lagringsløsning. Alle dokumenter lagres både i eksisterende lagringsløsning og i NHN Dokumentlager. Det kan finnes begrensninger i leverandørens system eller organisasjon som hindrer en mer grundig integrasjon. Dette er derfor en løsning med lav kostnad og lav risiko.

Denne løsningen passer for:

• aktører som er leverandørlåst til eksisterende lagringsinfrastruktur og ønsker å dele dokumenter, men ikke kan få leverandører til å støtte samhandling eller integrasjon
• aktører som ønsker å pilotere en interoperabel lagringsløsning
• aktører som planlegger utvikling av FHIR/XDS-kompatible grensesnitt for direkte kommunikasjon med Norsk helsenett
• aktører som ønsker å dele kun bestemte dokumenttyper (f.eks. kun dele dokumenter under kjernejournalforskriften eller med innbyggere i Norge)

flowchart LR

act[Helsepersonell]

subgraph "Norsk helsenett"
  xcads[(NHN Document Repository)]
  phr[[PJD REST API]]
  xcagw[NHN<br>XCA Gateway]
end

subgraph "EPJ-system"
    eepr[EPJ-system]
    epdb[(Lagringsløsning)]
    intngn[[FHIR-integrasjons-<br>lag]]
    fwd((&nbsp;))
end

act --Laster opp dokumenter--> eepr

eepr --Videresender til både<br>intern lagring<br>og NHN--> fwd

fwd --> intngn
fwd --> epdb

intngn --ITI-65 HL7 FHIR ProvideBundle-request--> phr 
phr --Videresender til<br>riktig<br>XcaDS--> xcads

xcads <--Forespørsler etter<br>dokumenter--> xcagw

Steg 3: NHN-styrt lagringsløsning med NHN Dokumentlager (100 % av dokumenter lagret i NHN-infrastruktur)

Dette gjelder dersom du migrerer fra en parallell lagringsløsning, eller dersom du ikke har en lagringsløsning fra før.

Denne løsningen passer for:

• aktører som ikke har eksisterende infrastruktur for dokumentlagring
• aktører som ikke har midler til å etablere infrastruktur
• aktører som ønsker full utsetting av dokumentpersistering

flowchart LR

act[Helsepersonell]

subgraph "Norsk helsenett"
    xcads[(NHN Document Repository)]
    xcagw[NHN<br>XCA Gateway]
    phr[[PJD REST API]]

end

subgraph "EPJ-system"
    eepr[EPJ-system]
    intngn[[FHIR-integrasjons-<br>lag]]
end

act--Laster opp dokumenter-->eepr

eepr --> intngn
intngn --> phr
phr-->xcads

xcads <--Forespørsler etter<br>dokumenter--> xcagw