Page History
| Navitabs | ||
|---|---|---|
| ||
Indholdsfortegnelse
| Table of Contents |
|---|
Introduktion
Formål
Denne guide har som formål at give et overblik over Graviditetsmappens app facade (GM Facade). Formålet med dokumentet er at give anvendere et overblik over løsningen, samt en oversigt over, hvilke User Stories der er understøttet af GMAF og hvordan disse er implementeret (flows).
Beskrivelse
GM Facade er en REST udstilling af Graviditetsmappens journal data fra kompomenten MHD (Generisk udstilling (MHD) - Leverancebeskrivelse), som en FHIR model sikret med JTP-H.
Links til mere information
Dokumentation for anvendt FHIR model findes her: https://build.fhir.org/ig/trifork/gm-fhir-ig/branches/main/index.html
Dokumentation for krav til JTP-H findes her: NSP Access Handler - Design og arkitekturbeskrivelse
Relevante use-cases
Pt. er det kun borgeren selv der kan hente data via. denne GM Facade.
Læsevejledning og forudsætninger
Dette dokument er henvendt til udviklere og arkitekter, der skal anvende GM Facade.
Sikkerhed
| Service udstil type | REST med JTP-H bearer token. |
| Krævede adgange | JTP-H token identificerer borgeren, der har adgang til egne dokumenter. |
| Whitelisting | Nej |
| Krævet sikkerhedsniveau | Data udstilles kun til borgerlogin, og kun borgerens egne dokumenter. |
| Forudsætninger for anvendelse | Ingen |
| Logning | Standard adgangslog via NSP Access Handler |
Definitioner og referencer
| Reference | Beskrivelse |
|---|---|
| JTP-H | JWT Token Profile for Healthcare (se NSP Access Handler - Design og arkitekturbeskrivelse) |
| GM Facade | Graviditetsmappens app facade |
| FHIR | FHIR står for Fast Healthcare Interoperability Resources. Det er en standard udviklet af HL7 (Health Level 7) til elektronisk udveksling af sundhedsoplysninger. |
| MHD | Mobile Access to Health Documents |
Adgang, brug og snitflader
Adgang
Adgang til servicen sker ved at medsende en Authorization-header med bearer token i form af JTP-H. Et gyldigt JTP-H token til test kan erhverves vha. OATH 2.0 med følgender properties:
...
| Endpoint | <serverurl>/gmaf/api/2025/06/25/journal |
| Beskrivelse af services | Returnerer borgeren (som angivet i JTP-H) journaldata vedrørende Graviditetsmappen |
| Resultat | Dokumenttyperne Svangerskabsjournal, vandrejournal og Målinger |
Snitfladebeskrivelse og brug
Hent journal for borger
Hent Journal
Henter borgers journal i Graviditetsmappen
...
Endpointet returnerer JSON svarende til implementerings guide'en for dokumenttyperne Svangerskabsjournal, Vandrejournal og Målinger (se https://build.fhir.org/ig/trifork/gm-fhir-ig/branches/main/index.html)
Fejlbeskeder
I fejl-scenarier vises disse fejlkoder:
Fejlkode | Scenarie |
|---|---|
| Ugyldig sikkerhedsbillet | Sikkerhedsbillet er ikke gyldig, f.eks., udløbet, forkert audience osv. |
| Tjenesten skal kaldes med en gyldig sikkerhedskontekst | Der er angivet et bearer token |
| Ingen matchende aktør fundet for sikkerhedskontekst | Bearer token angiver ikke et gyldigt borgeropslag |
Test
Følgende brugere burde have journal data på både Test 1 og Test 2:
| CPR |
|---|
| 1704999948 |
Eksempel kode og klient
Se integrations test i https://git.nspop.dk/scm/com/graviditetsmappens-app-facade.git for eksempel på komplet integration til komponenten.
Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |
| 1/7 2025 | Thomas Glæsner | Udfyldt |
...