Til hovedinnhold Direktoratet for medisinske produkter Direktoratet for medisinske produkter

Innføring av system-URL i samsvar med GUPRI

Publisert:

Endringer

Bakgrunn

Datakonsumentene av FHIR-tjenesten fra DMP (SAFEST-prosjektet) opplever utfordringer knyttet til referanser for kodeverk, identifikatorer og extensions. Disse utfordringene omfatter blant annet:

  • Behovet for å forstå hva et dataelement representerer. Dette håndteres ved bruk av system-attributtet i CodeableConcept og Identifier, og url-attributtet i Extension​. Disse attributtene skal inneholde en URL.
  • Flere eksisterende system-URL er sårbare for endringer eller peker ikke til en tilgjengelig ressurs.

Dette er en direkte følge av FHIR sin fleksibilitet og utvidbarhet og gjelder spesielt data som leveres som Extension, CodeableConcept og Identifier.

Eksempel: Angivelse av pakningsnivå i et pakningshierarki

"valueCodeableConcept" : {
  "coding" : [ {
    "system" : "https://volven.no/toolws/index.asmx/wsAppInfoSchema?strKveKode=7850",
    "code" : "20",
    "display" : "Sekundærnivå"
  } ] }

Verdien i «system» attributtet («https://volven.no/toolws/index.asmx/wsAppInfoSchema?strKveKode=7850») er her det eneste konsumenten har for å identifisere elementet og forstå semantikken av koden i kodeverket det refereres til. Fordi Finnkode har overtatt forvaltning av nasjonale kodeverk fra Volven peker ikke URLen til det korrekte kodeverk og dettes dokumentasjon.

Problemstillingen skal løses ved å innføre nye system-URL i samsvar med GUPRI (Globally Unique, Persistent and Resolvable Identifier).

Hva er en system-URL?

En system-URL er en unik og varig identifikator som entydig identifiserer et kodeverk, et identifikator-attributt eller en extension. Den fungerer som en stabil referanse i datautveksling for å angi hvilken terminologi eller klassifikasjon en kode tilhører, og brukes i FHIR-ressurser som system-attributt i CodeableConcept og Identifier, og som url-attributt i Extension.

Krav til system-URL

  • System-URL må være stabil gjennom hele livssyklusen og alltid peke til en nettside som gir tilstrekkelig informasjon for mottaker.
  • System-URL må kunne leses og forstås både av systemer og mennesker.
  • Datakonsumentene må kunne bruke «system» og «code» for å slå opp kodeverk og koder brukt i ressursen CodeSystem.

For å sikre at URL er stabil vil det bli satt opp en tjeneste som omdirigerer fra de nye, stabile URL til de faktiske URL.

Løsning

I eksemplet over blir system URL endret til

"valueCodeableConcept" : {
  "coding" : [ {
    "system" : "https://mpd.noma.no/codesystem/package-level",

    "code" : "20",
    "display" : "Sekundærnivå"
  } ] }

Hvordan løsningen ivaretar krav til «GUPRI» system-URL

  • System-URL må være stabil gjennom hele livssyklusen og alltid peke til en nettside som gir tilstrekkelig informasjon for mottaker.

Både domene (noma.no) og subdomene (mpd - «Medicinal Product Dictionary») eies av Direktoratet for medisinske produkter. Domenet noma.no eies av DMP (engelsk: Norwegian Medical Products Agency, NoMA) er en rolle som eksisterer uansett om legemiddelkatalogen skifter eierskap. 

  • System-URL må kunne leses og forstås både av systemer og mennesker.

System URLen angir nå semantikken av attributtet (package-level), type attributt (codesystem) og peker til et domene Direktoratet for Medisinske Produkter eier (noma.no) med en subdomene for legemiddelgrunndata (mpd - «Medicinal Product Dictionary»).

  • Datakonsumentene må kunne bruke «system» og «code» for å slå opp kodeverk og koder brukt i ressursen CodeSystem.

Dersom «https://mpd.noma.no/codesystem/package-level» tastes inn i en nettleser, returnerer DMP den til enhver tid korrekte URL til dette kodeverket. På nåværende tidspunkt ville det være «https://finnkode.helsedirektoratet.no/adm/collections/7850»

Dersom «https://mpd.noma.no/codesystem/package-level» sendes til DMP av et autorisert system, videresendes forespørselen til det konkrete kodeverket i DMPs FHIR grensesnitt. Enkelte koder kan hentes ved å angi koden i tillegg: «https://mpd.noma.no/codesystem/package-level/20»

Innføring og overgangsperiode

Tidspunktet for innføring av nye system-URL er ikke endelig fastsatt. Når implementeringen nærmer seg, vil DMP sende ut en driftsmelding i forkant. Det er derfor viktig at alle konsumenter holder kontaktinformasjonen sin oppdatert hos DMP for å sikre at de mottar denne varslingen i tide.

Det vil bli en overgangsperiode med to versjoner, inkludert to implementeringsguider på Simplifier, men detaljer rundt dette er ikke fastsatt.