Hvordan fungerer det?
Helsenorge har definert et “generisk innsynformat”. Dette er et “meta-språk” som gjør det mulig å strukturere og delvis formatere responsen med opplysninger som kommer fra registrene. På Helsenorge vil responsen vises for innbygger og formateres tilpasset innbyggers deviceenhet.
Formatet (hva som er mulig og hva som er lov) er definert av Helsenorge i to forskjellige XSDer:
Et skjema (XSD) for representasjon av innhold, dvs. de opplysninger som er registrert om innbygger.
Et annet skjema ( XSD) for tabularisk oversikt over logg over bruk, eller logg over utleveringer av innbyggers registrerte opplysninger.
Registeret bygger opp en XML-struktur med innholdet fra registeret som skal presenteres basert på riktig XSD avhengig av brukstilfelle over. På Helsenorge presenteres innholdet på en standardisert måte for innbygger som også er tilpasset den enhet innbygger benytter.
Når innbygger er på Helsenorge og ber om å få se innsynsrapport fra et register sender det aktuelle registeret en XML-fil som inneholder opplysninger for aktuell innbygger til Helsenorge.
Helsenorge tolker XML-filen og presenterer den til innbygger på definert måte.
Hva kan innsynsformatet brukes til?
Visning av registerinnhold på Helsenorge
Visning av logg over bruk av registeropplysninger på Helsenorge
Visning av logg over utleveringer av registeropplysninger på Helsenorge
Krav samt tips og råd til oppbygning og innhold
Hva | Krav | Tips og råd |
---|---|---|
Visning av registerinnhold |
|
|
Visning av logg over bruk av registeropplysninger på Helsenorge | Tabell som viser Logg over bruk må inneholde følgende kolonner, i denne rekkefølgen:
|
|
Visning av logg over utleveringer av registeropplysninger på Helsenorge | Samme som over | Samme som over |
Hvordan kan du formatere innholdet?
Når du skal lage en presentasjon og visning av innholdet som kommer fra registeret kan du benytte følgende elementer til å formatere og angi hvordan det skal bli presentert for innbygger.
Det er mulig å lese og forstå alle muligheter og regler gjennom å se på XSDen, men presentasjonen under er en forenklet og mer leservennlig forklaring av de muligheter og alternativer som finnes. Her ser du også når og hva de ulike alternativene er egnet for samt eksempler.
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Hovedinndeling og struktur
I hver seksjon kan du benytte alternativene under for å presentere innholdet på ønsket måte. Du kan bruke så mange av variantene du ønsker og i den rekkefølgen du selv ønsker. |
Expand | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
Presentasjon av registerinnhold inne i en seksjonFor selve innholdet som ligger i registeret knyttet til hver enkelt innbygger finnes det flere alternativer. Du kan selv bygge opp innholdet med de av disse elementene som egner seg - og kombinere dem i den rekkefølgen du ønsker. Noen elementer er det mulig å bruke inni hverandre, andre kan bare brukes over og under hverandre. Se XSDen for detaljer knyttet til dette.
|
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
Støtteinformasjon og veiledning til innbygger slik at presentasjonen av registerinnholdet blir selvforklarendeRegisterinnhold er ikke alltid enkelt å forstå for innbyggere. Det er derfor viktig å legge til støtteinformasjon, veiledning og beskrivelser til innbygger utover det spesifikke registerinnholdet. Det finnes derfor noen alternativer i innsynsformatet som kan benyttes for å legge til dette.
|
Versjoner av formatet
Formatet kan utvides med flere muligheter i nyere versjoner, men vi sørger for at vi er bakoverkompatible slik at det fremdeles er mulig å bruke eldre versjoner, men da uten mulighet til å benytte det nye som er kommet i nyere versjoner.
Oversikt over versjoner:
5.1
5.2 - nytt format som kommer høst 2021
Mulighet for veiledningstekst
Mulighet for ordforklaringer
Endret formatering instruksjoner for tekst til mer generiske verdier
Alle skjemaer finnes på undersiden: https://helsenorge.atlassian.net/wiki/spaces/HU/pages/1686208513
Hvordan teste dette?
Det er laget en egen side/test-tjeneste hvor du kan laste opp din formaterte XML-fil for å teste og verifisere hvordan det vil se ut og bli presentert på Helsenorge. På Helsenorge vil responsen vises for innbygger og formateres tilpasset innbyggers device.
Det finnes også nyttige lenker til detaljert dokumentasjon og eksempler direkte på testsiden.
Merk! Testsiden krever, på samme måte som alle integrasjoner, at aktørens system (IP-adresse) er whitelistet mot Helsenorges testsystemer.
Teknisk dokumentasjon
Registeret sender en XML-fil som har en bestemt struktur som er definert i en XSD-fil som er tilgjengelig fra Helsenorge.
XMLen som sendes for hvert enkelt innsyn blir parset av systemet og det genereres presentasjonskode som viser disse dataene i tråd med Helsenorges mal for presentasjon.
Detaljert informasjon om alle muligheter og det som trengs for å implementere innsynsformatet får du ved å se på de aktuelle skjemaene som finnes på undersiden: https://helsenorge.atlassian.net/wiki/spaces/HU/pages/1686208513