Skip to content

ahdis/mag-emed-pmp

BranchesTags

Repository files navigation

Mobile Access Gateway for PMP

Test/demo cases for using the Mobile Access Gateway with the eMedication Service of CARA. Test patients are currently setup fixed and described here.

Instances

Two instances of the MAG are available, corresponding to the two PMP instances:

MAG Instance PMP Instance
https://test.ahdis.ch/mag-pmp-int/fhir/ https://ws-pmp-int.cara.ch/pmp2/
https://test.ahdis.ch/mag-pmp-dev/fhir/ https://ws-pmp-dev.cara.ch/pmp/

There is a GUI which allows to you execute the different functionality directly: https://test.ahdis.ch/mag-pmp-int/#/mag

Verify that you have in settings the correct endpoint, could be the old one because it is stored in the browser session: https://test.ahdis.ch/mag-pmp-int/#/settings).

Getting the Current Medication List of a Patient

1. Get Patient ID's (EPR-SPID and MPI-PID) based on local identifier (urn:oid:1.3.6.1.4.1.21367.2017.2.5.83|MAGMED001)

IHE PIXm Query [ITI-83] (https Query)

https://test.ahdis.ch/mag-pmp-int/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:1.3.6.1.4.1.21367.2017.2.5.83|MAGMED001&targetSystem=urn:oid:2.999.756.42.21&targetSystem=urn:oid:2.16.756.5.30.1.127.3.10.3 HTTP/1.1
Accept: application/fhir+json

returns identifiers for EPR-SPID (2.16.756.5.30.1.127.3.10.3) and MPI-ID (2.999.756.42.2)

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "targetIdentifier",
      "valueIdentifier": {
        "system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
        "value": "761337610435209810"
      }
    },
    {
      "name": "targetId",
      "valueReference": {
        "reference": "http://test.ahdis.ch/mag-pmp-int/fhir/Patient/2.999.756.42.2-CARAMED001"
      }
    },
    {
      "name": "targetIdentifier",
      "valueIdentifier": {
        "system": "urn:oid:2.999.756.42.2",
        "value": "CARAMED001"
      }
    }
  ]
}

2. Get Access Token based on Authenticated Healthcare Professional

Get Assertion based on IdP SAML token, here SAML token is abbreviated for testing, Patient (resourceId as EPR-SPID), Role (NORM) and PurposeOfUse (HCP) for Health Professional who is identified with GLN 7601002469191

POST https://test.ahdis.ch/mag-pmp-int/camel/assertion HTTP/1.1
Scope: person_id=761337610445502987^^^&2.16.756.5.30.1.127.3.10.3&ISO purpose_of_use=urn:oid:2.16.756.5.30.1.127.3.10.5|NORM subject_role=urn:oid:2.16.756.5.30.1.127.3.10.6|HCP

Accept: application/json;charset=UTF-8
Content-Type: application/xml;charset=UTF-8

<saml2:Assertion xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion" Version="2.0">
   <saml2:AttributeStatement>
      <saml2:Attribute FriendlyName="GLN" Name="GLN"
            NameFormat="urn:oasis:names:tc:ebcore:partyid-type:DataUniversalNumberingSystem:0060">
      <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:string">7601002469191</saml2:AttributeValue>
               </saml2:Attribute>
   </saml2:AttributeStatement>
</saml2:Assertion>

returns XUA Authorization Assertion for the specified scope:

{
  "access_token": "PHNh.....",
  "token_type": "IHE-SAML",
  "expires_in": 60000,
  "scope": "resourceId/761337610435209810 purposeOfUse/NORM role/HCP"
}

3. Query Medication List or Medication Card with the $find-medication-list operation

https://test.ahdis.ch/mag-pmp-int/fhir/DocumentReference/$find-medication-list?status=current&patient.identifier=urn:oid:2.16.756.5.30.1.191.1.0.2.1|c55f4ca7-bd4e-4134-8dcd-56b793ade958
Accept: application/fhir+json
Authorization: Bearer PHNh.....

if you wan to query the Medication Card instead of the Medication List you need to add the format parameter

https://test.ahdis.ch/mag-pmp-int/fhir/DocumentReference/$find-medication-list?status=current&patient.identifier=urn:oid:2.16.756.5.30.1.191.1.0.2.1|c55f4ca7-bd4e-4134-8dcd-56b793ade958&format=urn:oid:2.16.756.5.30.1.127.3.10.10|urn:che:epr:ch-emed:medication-card:2022
Accept: application/fhir+json
Authorization: Bearer PHNh.....

4. Retrieve Medication List or Medication Card

IHE MHD 68 Document retrieve with url received from above request

https://test.ahdis.ch/mag-pmp-int/fhir/camel/xdsretrieve?uniqueId=51570022-9b6a-474b-927b-e6a1b193ce16&repositoryUniqueId=2.999.756.42.1
Accept: application/fhir+json
Authorization: Bearer PHNh.....

Updating the medication

1. Get Patient ID's (EPR-SPID and MPI-PID) based on local identifier (urn:oid:1.3.6.1.4.1.21367.2017.2.5.83|MAGMED001)

IHE PIXm Query [ITI-83] (https Query)

https://test.ahdis.ch/mag-pmp-int/fhir/Patient/$ihe-pix?sourceIdentifier=urn:oid:1.3.6.1.4.1.21367.2017.2.5.83|MAGMED001&targetSystem=urn:oid:2.999.756.42.21&targetSystem=urn:oid:2.16.756.5.30.1.127.3.10.3 HTTP/1.1
Accept: application/fhir+json;charset=UTF-8
Content-Type: application/fhir+json;charset=UTF-8

returns identifiers for EPR-SPID (2.16.756.5.30.1.127.3.10.3) and MPI-ID (2.999.756.42.2)

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "targetIdentifier",
      "valueIdentifier": {
        "system": "urn:oid:2.16.756.5.30.1.127.3.10.3",
        "value": "761337610435209810"
      }
    },
    {
      "name": "targetId",
      "valueReference": {
        "reference": "http://test.ahdis.ch/mag-pmp-int/fhir/Patient/2.999.756.42.2-CARAMED001"
      }
    },
    {
      "name": "targetIdentifier",
      "valueIdentifier": {
        "system": "urn:oid:2.999.756.42.2",
        "value": "CARAMED001"
      }
    }
  ]
}

2. Get Access Token based on Authenticated Healthcare Professional

Get Assertion based on IdP SAML token, here SAML token is abbreviated for testing, Patient (resourceId as EPR-SPID), Role (NORM) and PurposeOfUse (HCP) for Health Professional who is identified with GLN 7601002469191

POST https://test.ahdis.ch/mag-pmp-int/camel/assertion HTTP/1.1
Scope: resourceId/761337610445502987 purposeOfUse/NORM role/HCP
Accept: application/json;charset=UTF-8
Content-Type: application/xml;charset=UTF-8

<saml2:Assertion xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion" Version="2.0">
   <saml2:AttributeStatement>
      <saml2:Attribute FriendlyName="GLN" Name="GLN"
            NameFormat="urn:oasis:names:tc:ebcore:partyid-type:DataUniversalNumberingSystem:0060">
      <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:string">7601002469191</saml2:AttributeValue>
               </saml2:Attribute>
   </saml2:AttributeStatement>
</saml2:Assertion>

returns XUA Authorization Assertion for the specified scope:

{
  "access_token": "PHNh.....",
  "token_type": "IHE-SAML",
  "expires_in": 60000,
  "scope": "resourceId/761337610435209810 purposeOfUse/NORM role/HCP"
}

3. Publish CH EMED FHIR document with IHE MHD Provide Document Bundle transaction

The document has to be submitted according to the IHE MHD Provide Document Bundle ITI-65 transaction with the following special considerations for each of the resource elements within the Bundle. As a Document Source you need to provide different identifiers:

  • Adjust Mapping with List to DocumentManifest
Resource Element Value
Binary.contentType text/xml
Binary.data Base64 encoded CDA according to above step
List.extension author role extension
List.extension ihe-sourceId
List.extension ihe-designationType
List.identifier unique oid generated by Document Source
List.identifier unique uuid generated by Document Source
List.status current
List.subject.reference targetID from PIXm call (see sep 1)
DocumentReference.identifier uuid of Document (Bundle.identifier.value as uniqueId for XDS
DocumentReference.status current
DocumentReference.date Bundle.Composition.date
DocumentReference.subject targetID from PIXm call (see step 1)
DocumentReference.content.attachment.creation Bundle.Composition.date
DocumentReference.content.format DocumentEntry.formatCode, see table below
DocumentReference.author reference to contained PractitionerRole
DocumentReference.type XDS typeCode, see table below
DocumentReference.category XDS classCode, see table below
DocumentReference.securityLabel XDS confidentialityCode

See the cara emed-service-guide for Document formatCode, DocumentEntry.classCode and DocumentEntry.typeCode:

See mtp-submit.json for a Provide Document Bundle message example.

The Provide Document Bundle message is sent to the base URL as defined in FHIR. See http://hl7.org/fhir/R4/http.html for the definition of “HTTP” access methods and “base”.

POST https://test.ahdis.ch/mag-pmp-int/fhir/
Accept: application/fhir+json;charset=UTF-8
Content-Type: application/fhir+json;charset=UTF-8
Authorization: Bearer PHN...

The server returns a HTTP Status code appropriate to the processing outcome, conforming to the transaction specification requirements as specified in http://hl7.org/fhir/R4/http.html#transaction

Logs

You can access any logs also directly at https://ws-pmp-int.cara.ch/pmp2/mhd/logs.

Copy cubernetes log from testinstance

kubectl cp mag-pmp-84ccc7fdbd-jc7wl:logs ./pmplogs/

kubectl cp mag-pmp-5796cd7d5f-gjjqz:logs ./pmplogs/

kubectl cp mag-pmp-5796cd7d5f-8wvp6:logs ./pmplogs/ kubectl logs --follow mag-pmp-5796cd7d5f-8wvp6

kubectl exec --stdin --tty mag-pmp-84ccc7fdbd-jc7wl -- /bin/sh

About

Mobile Access Gateway for eMedication Service

Resources

Readme

License

Apache-2.0 license
Activity
Custom properties

Stars

0 stars

Watchers

2 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •