Denne guide har som formål at give et overblik over, hvordan CAVE servicen kaldes.
Guiden indeholder beskrivelse af de relevante dele af snitfladen.
Dette dokument er henvendt til udviklere og arkitekter der skal anvende CAVE servicen.
Det forventes at læseren har et kendskab til REST services og FHIR standarden, da snitfladen er en REST snitflade og CAVE servicen er en implementering af FHIR standarden via Java HAPI implementeringen.
Dato | Ansvarlig | Beskrivelse |
---|---|---|
5/2-2018 | KvalitetsIT | Initiel version |
Rerence | Beskrivelse |
---|---|
REST | Representational State Transfer |
FHIR | Fast Health Interoperability Resources |
HAPI | HAPI-FHIR - Open Source FHIR implementation in Java |
CAVE servicen udstiller en REST snitflade. Installation af CAVE servicen er lavet så det kun er LAR der kan kalde CAVE servicen.
CAVE servicen er en implemtering af FHIR standarden og API'et er derfor standard FHIR. I snitfladebeskrivelsen er kun beksrevet de dele der er anvendt i forhold til LAR servicen. For yderlige detaljer henvises til FHIR standarden.
Request
For at læse AllergyIntolerance oplsyninger sker det via et HTTP Get kald. En række query parametre udgør søgekriterierne. Parametrene er standard FHIR parametre.
Søgningen sker via patient.identifer og der angives oid for CPR systemet og CPR nr. på den patient der søges data for. Nedenstående er det kald LAR servicen laver for at læse de nødvendige oplysninger. CPR nr. er markeret med fed skrifttype.
http://localhost/cave/fhir/AllergyIntolerance?patient.identifier=urn%3Aoid%3A1.2.208.176.1.2%7C0101010102&_include=AllergyIntolerance%3Apatient&_include=AllergyIntolerance%3Arecorder&_include%3Arecurse=PractitionerRole%3Apractitioner&_include%3Arecurse=PractitionerRole%3Aorganization
Response
Svart på ovenstående query består af en FHIR bundle. Der returneres nedenstående ressourcer i bundlen.
AllergyIntolerance | |
---|---|
Element | Beskrivelse |
identifier | Unik identifier for registreringen. Er altid i UUID formatet. |
clinicalStatus | Status på registreringen. Er enten Active, Inactive eller Resolved |
verificationStatus | Altid confirmed da LAR servicen altid sender confirmed. |
type | Altid allergy da LAR servicen altid sender allergy. |
category | Altid medication da LAR servicen altid sender medication. |
criticality | Kritikalitet af allergien. Er enten low, high eller unnable-to-assess. |
code | Substans eller tekstuel beskrivelse af substans som allergien drejer sig om. Består af en kode og et system eller en beskrivende tekst. System kan være oid for ATC kode og koden er så en specifik ATC kode. |
patient | Reference til Patient ressourcen. |
onsetDateTime | Tidspunkt allergien er identificeret. |
recorder | Reference til PractitionerRole ressourcen. PractitionerRole angiver organization og sundhedsfaglig person der har oprettet data. |
note | Tekst note |
reaction.manifestation | Reaktion på allergien. Består af:
|
reaction.onset | Tidspunkt hvor reaktionen er observeret. |
reaction.severity | Hvor alvorlig reaktionen er. Enten Mild, moderate eller severe. |
PractitionerRole | |
---|---|
Element | Beskrivelse |
Practitioner | Reference til Practitioner ressourcen. |
Organization | Reference til Organization ressourcen. |
Patient | |
---|---|
Element | Beskrivelse |
Identifier | Code og system. System er OID for CPR og code er CPR nummer på patienten. |
Practioner | |
---|---|
Element | Beskrivelse |
Identifier | Code og system. System er OID for autorisationskode og code er autorsiationskode for den sundhedsfaglige person der har oprettet data. |
Organization | |
---|---|
Element | Beskrivelse |
Identifier | Code og system. System er OID for SOR og code er den SOR kode for den organization der har oprettet data. |
RegisterPatientAllergyResponse
Består af ReplyStatus og en liste af MedicationAllergyIntoleranceReduced.
ReplyStatus | ||
---|---|---|
Element | Beskrivelse | Påkrævet |
StatusCode | Status kode på forespørgselen. | Ja |
StatusText | Status tekst svarende til status koden. | Ja |
Registrering af medicinintolerens sker med HTTP Post kald til CAVE servicen. Body består af en FHIR bundle med nedenstående ressourcer. Alle ressourcerne er standard FHIR ressourcer.
Beskrivelse af de anvendte felter er den samme som når der læses data. Derfor er der ikke seperat beskrivelse af de enkelte felter.
For at læse cave oplysninger i cave servicen sker det via et HTTP Get kald til CAVE Servicens REST snitflade. Nedenstående er den HTTP Get der skal laves. Det med rødt markerede er den variable del i form af CPR nummer.
http://localhost/cave/fhir/AllergyIntolerance?patient.identifier=urn%3Aoid%3A1.2.208.176.1.2%7C0101010102&_include=AllergyIntolerance%3Apatient&_include=AllergyIntolerance%3Arecorder&_include%3Arecurse=PractitionerRole%3Apractitioner&_include%3Arecurse=PractitionerRole%3Aorganization
Svaret på ovenstående request har endenstående format.
{ "resourceType": "Bundle", "id": "3cc95f66-1199-4d44-9255-ac1c3a24120d", "meta": { "lastUpdated": "2019-02-12T15:49:33.653+01:00" }, "type": "searchset", "total": 5, "link": [ { "relation": "self", "url": "http://cave.sds.dk/fhir/AllergyIntolerance?_include=AllergyIntolerance%3Apatient&_include=AllergyIntolerance%3Arecorder&_include%3Arecurse=PractitionerRole%3Apractitioner&_include%3Arecurse=PractitionerRole%3Aorganization&patient.identifier=urn%3Aoid%3A1.2.208.176.1.2%7C0101010110" } ], "entry": [ { "fullUrl": "http://cave.sds.dk/fhir/AllergyIntolerance/608", "resource": { "resourceType": "AllergyIntolerance", "id": "608", "meta": { "versionId": "1", "lastUpdated": "2019-02-12T15:49:09.000+01:00" }, "identifier": [ { "value": "69a8c8f2-a410-41d4-af4d-57bcd6a9d721" } ], "clinicalStatus": { "coding": [ { "code": "active" } ] }, "verificationStatus": { "coding": [ { "code": "confirmed" } ] }, "type": "allergy", "category": [ "medication" ], "criticality": "unable-to-assess", "code": { "coding": [ { "system": "urn:oid:2.16.840.1.113883.6.73", "code": "N07B02" } ], "text": "Metadon" }, "patient": { "reference": "Patient/607" }, "onsetDateTime": "2019-01-11T09:01:03+01:00", "recorder": { "reference": "PractitionerRole/606" }, "lastOccurrence": "2019-01-11T09:01:03+01:00", "reaction": [ { "manifestation": [ { "coding": [ { "system": "urn:oid:1.2.208.176.2.4.12", "code": "DT789" } ], "text": "Ser grønne elefanter!" } ], "severity": "severe" } ] }, "search": { "mode": "match" }, "response": { "status": "201 Created", "etag": "W/\"1\"" } }, { "fullUrl": "http://cave.sds.dk/fhir/PractitionerRole/606", "resource": { "resourceType": "PractitionerRole", "id": "606", "meta": { "versionId": "1", "lastUpdated": "2019-02-12T15:49:09.000+01:00" }, "practitioner": { "reference": "Practitioner/604" }, "organization": { "reference": "Organization/605" } }, "search": { "mode": "include" }, "response": { "status": "201 Created", "etag": "W/\"1\"" } }, { "fullUrl": "http://cave.sds.dk/fhir/Patient/607", "resource": { "resourceType": "Patient", "id": "607", "meta": { "versionId": "1", "lastUpdated": "2019-02-12T15:49:09.000+01:00" }, "identifier": [ { "system": "urn:oid:1.2.208.176.1.2", "value": "0101010110" } ] }, "search": { "mode": "include" }, "response": { "status": "201 Created", "etag": "W/\"1\"" } }, { "fullUrl": "http://cave.sds.dk/fhir/Practitioner/604", "resource": { "resourceType": "Practitioner", "id": "604", "meta": { "versionId": "1", "lastUpdated": "2019-02-12T15:49:08.000+01:00" }, "identifier": [ { "system": "urn:oid:1.2.208.176.1.3", "value": "AUT_ID2" } ] }, "search": { "mode": "include" }, "response": { "status": "201 Created", "etag": "W/\"1\"" } }, { "fullUrl": "http://cave.sds.dk/fhir/Organization/605", "resource": { "resourceType": "Organization", "id": "605", "meta": { "versionId": "1", "lastUpdated": "2019-02-12T15:49:08.000+01:00" }, "identifier": [ { "system": "urn:oid:1.2.208.176.1.1", "value": "SOR_KODE1" } ] }, "search": { "mode": "include" }, "response": { "status": "201 Created", "etag": "W/\"1\"" } } ] } |