Alternativet med etablering av API-integrasjon forutsetter at leverandøren selv har kapasitet til å utvikle eget brukergrensesnitt for sluttbrukere og håndtere trafikk mellom leverandørens løsning og API-et hos Norsk helsenett.

Det forventes 3 typer av brukergrensesnitt:

• grensesnitt for søk og filtrerings muligheter

• grensesnitt for å vise frem referanser med relevante metadata

• grensesnitt for å vise frem refererte dokumenter i strukturert og ustrukturert format

Grensesnitt for søk og filtrerings muligheter:

I dette grensesnittet skal løsningen kunne søke på et bestemt pasient etter brukerens valg. Det er ikke lagt inn støtte for å kunne søke på flere pasienter samtidig.

Sluttbruker skal ha mulighet for å begrense og/eller tilspisse søk og levernadøren må derfor etablere et brukergrensesnitt som gir mulighet for filtrering

Følgende søkeparametere kan defineres

• maks. ønsket konfidensialitets nivå på referanser (N-Normal, R-restricted og V-very restricted)

• tidsperiode på søk

• øvrige søkeparametere, ref. IHE-spesifikasjon for søk

Grensesnitt for å vise frem referanser med relevante metadata

Ved å sende søk til PJD API'et blir det alltid returnert en respons. Ved feilsituasjoner (ved nedetid osv) vil det fremkomme tidelige feilmeldinger at tjenesten er evt. nede for øyeblikket.

Leverandøren må sørge for en oversiktlig brukergrensesnitt som lister opp alle referanser. Enkelte pasienter har ingen referanser mens kroniske pasienter kan ha titalls til hundrevis av referanser. Leverandøren bør vurdere å tilpasse visning basert på relevante metadata og evt. filtrering av resultatsliste uten å gjøre ny kall mot API'et dersom det ikke er en vessentlig endring i grunnlaget.

Leverandøren må ta hensyn til at enkelte referanser er "begrenset med metadata", dvs. at sluttbrukeren er informert om at det finnes referanse men den ikke er tilgjengelig for deling, dvs. det finnes ikke nødvendig referanse til selve dokumentet

Grensesnitt for å vise frem strukturert og ustrukturert dokumentformat 

Siden integrasjon foregår i leverandørens løsning så må leverandøren også sørge for riktig fremvisning av journaldokumenter som kan være både strukturerte og ustrukturerte helseopplysninger 

Eksempler på mulige (semi-)strukturerte dokumentformater:

• HTML-dokumenter

• XML-formater

  • HL7 FHIR Document

  • HL7 CDA

  • KITH-dokumenter [ebXML]

    • Epikrise

    • Henvisning

    • ...

Eksempler på mulige ustrukturerte dokumentformater:

• PDF

• RTF

• TIFF

• GIF

• PNG

• JPG

• TXT

Leverandør selv velger den tilnærmingen som passer best for den arbeidsflaten som løsningen skal primært levere på. 

En typisk scenario er at enkelte løsninger konverterer alt til PDF-formatet før visning på skjermen, samtidig bruk av PDF-format er ikke nødvendivis egnet for bruk på håndholdte enheter hvor HTML-visning kan by på bedre alternativer.

Leverandøren som lager et slikt gresnesnitt må ta høyde for at det kan komme "ukjent" format som løsningen ikke er i stand å rendre og derfor må det vises en plakat med "ukjent formattype".

Tips:

Utviklere i Norsk helsenett gir gjerne en eller flere anbefalinger og råd når det gjelde de ulike typer av journaldokumenter. Det meste ble testet i vår egen "PJD DemoEPJ".

Det er ingen krav, ved bruk av PJD API-et, til leverandørens godkjenning for å kunne tilby funksjonalitet for journaldokumenter i produksjon.

Derimot det stilles krav til sluttbrukere som skal benytte leverandørens løsning om signering av bruksvilkår for bruk av PJD-funksjonalitet.