My Health Record FHIR® Mobile Gateway - Clinical Document Service

Reading & Development: 2 hours

Quick Intro

In this guide, we will be accessing Prescription and Dispense List and Allergies List contained in a patient’s clinical document service. This differs from the previous guide where we accessed this information from the Personal Health Summary. As per FHIR® specifications you will notice that Prescriptions will be accessed using the MedicationOrder FHIR® resource, the Dispense Records via the MedicationDispense resource and allergies via AllergyIntolerance.

Step 1: Prescription List (GET)

This API provides the ability to retrieve Prescription information for an individual from the My Health Record system and returns a bundle of MedicationOrder resources. A maximum of 99 resources are returned in the response. 

Familiarise yourself with the API and parameters for the Prescription List below.

View the API Specification Section 3.6 for a more in depth understanding.

In the next few steps, we will modify our UI and add the code-behind logic to retrieve the Prescription and Dispense List returned as JSON.

Add a new UI page

1. Create a new content page called PrescriptionDispenseListPage.xaml.

2. Add the following UI code between <ContentPage.Content> tags inside the PrescriptionDispenseListPage.xaml file.

<StackLayout>
    <Label Text="Clinical Document Services" Margin="0, 20, 0, 20" Style="{StaticResource PageHeader}"
        VerticalOptions="Start"
        HorizontalOptions="CenterAndExpand"
        HorizontalTextAlignment="Center"/>
    <BoxView HorizontalOptions="FillAndExpand" HeightRequest="1" Color="#222222" Margin="0, 0, 0, 20"/>
    <Button Margin="0,10,0,0" Text="Prescription List" HorizontalOptions="Center"
        x:Name="prescriptionList"
        Clicked="prescriptionList_Clicked"
        BackgroundColor="{StaticResource Primary}"
        TextColor="White" />
</StackLayout>

prescription-list-addui-page.png

3. Add this new page into the Flyout Menu bar using the following code inside the AppShell.xaml file.

<ShellContent Title="Prescription Dispense Allergy List" Route="PrescriptionDispensePage" ContentTemplate="{DataTemplate local:PrescriptionDispenseListPage}" />

Code to retrieve Prescriptions

1. Add a new method inside the IMhrFhirService

Task<IRestResponse> GetPrescriptionList(string id, string fromDate, string toDate);

2. Add an implementation method as per the code below inside the MhrFhirService class 

public async Task<IRestResponse> GetPrescriptionList(string id, string fromDate, string toDate)
{
    RestRequest request = new RestRequest("MedicationOrder", Method.GET);
    request.AddParameter("patient", id);
    request.AddParameter("datewritten", "ge"+fromDate);
    request.AddParameter("datewritten", "le"+toDate);
    // This method was already added in the previous guide to add request headers such as authorisation, app id, app version. 
    await AddStandardHeaders(request); // Added in previous guide.
    IRestResponse fhirApiResponse = await _httpClient.ExecuteAsync(request);
    return fhirApiResponse;
}

3. Add the following method on Prescription List button click event inside the partial class PrescriptionDispenseListPage.xaml.cs. You will note we have used hard-coded date values for this example.

private async void prescriptionList_Clicked(object sender, EventArgs e)
{
    IMhrFhirService mhrFhirService = DependencyService.Get<MhrFhirService>();
    string fromDate = "2010-01-01";
    string toDate = "2020-12-31";
    IRestResponse fhirMhrApiResponse = await mhrFhirService.GetPrescriptionList("1089887702", fromDate, toDate); // Patient Id
    if (fhirMhrApiResponse.StatusCode == HttpStatusCode.OK)
    {
        string json = fhirMhrApiResponse.Content;
    }
    else
    {
        string errorDesc = fhirMhrApiResponse.StatusDescription;
    }
}

4. Run the application and test the Prescriptions List.

By using the Visual Studio debugger, JSON data is shown in the JSON visualizer as shown below.

json-visualizer-fhirapi.png

To ensure readability of this guide, we have not expanded the complete JSON object.

Step 2: Dispense List (GET)

The following code for the Dispense List is very similar. As per the API specifics below we will receive a bundle of MedicationDispense resources.

1. Add a button called Dispense List underneath the Prescription List button inside the PrescriptionDispenseListPage.XAML file.

<Button Margin="0,10,0,0" Text="Dispense List" HorizontalOptions="Center"
                x:Name="dispenseList"
                Clicked="dispenseList_Clicked"
                BackgroundColor="{StaticResource Primary}"
                TextColor="White" />

2. Add a new method inside the IMhrFhirService interface.

Task<IRestResponse> GetDispenseList(string id, string fromDate, string toDate);

3. Add an implementation method as per the code below inside the MhrFhirService class created in previous guides.

public async Task<IRestResponse> GetDispenseList(string id, string fromDate, string toDate)
{
    RestRequest request = new RestRequest("MedicationDispense", Method.GET);
    request.AddParameter("patient", id);
    request.AddParameter("whenhandedover", "ge" + fromDate);
    request.AddParameter("whenhandedover", "le" + toDate);
    // This method was already added in previous guide to add request headers such as authorization, app id, app version. 
    await AddStandardHeaders(request);
    IRestResponse fhirApiResponse = await _httpClient.ExecuteAsync(request);
    return fhirApiResponse;
}

4. Add the following method on the Dispense List button click event added in previous step inside the partial class PrescriptionDispenseListPage.xaml.cs

private async void dispenseList_Clicked(object sender, EventArgs e)
{
    IMhrFhirService mhrFhirService = DependencyService.Get<MhrFhirService>();
    string fromDate = "2010-01-01";
    string toDate = "2020-12-31";
    IRestResponse fhirMhrApiResponse = await mhrFhirService.GetDispenseList("1089887702", fromDate, toDate); // Patient Id
    if (fhirMhrApiResponse.StatusCode == HttpStatusCode.OK)
    {
        string json = fhirMhrApiResponse.Content;
    }
    else
    {
        string errorDesc = fhirMhrApiResponse.StatusDescription;
    }
}

5. Run the application and test the Dispense List.

By using the Visual Studio debugger, JSON can be shown JSON Visualizer as shown below. We have partially expanded a MedicationDispense entry.

json-visualizer-fhirapi-response.png

public async Task<IRestResponse> GetAllergyIntoleranceList(string id)
{
    RestRequest request = new RestRequest("AllergyIntolerance", Method.GET);
    request.AddParameter("patient", id);
    request.AddParameter("reporter._type", "Practitioner");
    // This method was already added in previous guide to add request headers such as authorization, app id, app version. 
    await AddStandardHeaders(request);
    IRestResponse fhirApiResponse = await _httpClient.ExecuteAsync(request);
    return fhirApiResponse;
}

Step 3: Get Allergies List (SHS) (GET)

This API provides the ability to retrieve an individual’s allergies and adverse reactions information and returns a bundle of AllergyIntolerance resources from the most recent Shared Health Summary document stored in the consumer’s My Health Record. If you are unfamiliar with the concept of a Shared Health Summary, please take a moment to read about it’s purpose here.

We will be accessing the same AllergyIntolerance API as we did in the previous guide, however they key difference is using a reporter._type as “Practicioner” instead of “Patient”.

The following code is to retrieve the patient’s AllergyIntolerance information from the My Health Record System. You will notice a lot of similarities to previous code and would likely leverage the method already created for the Personal Health Summary AllergyIntolerance request by simply adding a parameter to parse for reporter._type.

The example below creates a new method.

public async Task<IRestResponse> GetAllergyIntoleranceList(string id)
{
    RestRequest request = new RestRequest("AllergyIntolerance", Method.GET);
    request.AddParameter("patient", id);
    request.AddParameter("reporter._type", "Practitioner");
    // This method was already added in previous guide to add request headers such as authorization, app id, app version. 
    await AddStandardHeaders(request);
    IRestResponse fhirApiResponse = await _httpClient.ExecuteAsync(request);
    return fhirApiResponse;
}

Conclusion

Your sample application should now be able to access medications and allergies information which has been added to the My Health Record by the healthcare provider. This builds on the functionality you had already developed to retrieve Patient Health Summary information. In the next guide we will be able to access clinical documents directly by using the Generic Document Service.

View All | Back | Next: Generic Document Services - My Health Record FHIR® Gateway Developer Guide 6