matthansen0 / FHIRPower

This repository is focused on Azure API for FHIR and Power Platform

PowerApps with Azure API for FHIR

This repository hosts the guidance and reference architecture for using PowerApps with Azure API for FHIR. These are only samples to get started and doesn't include all FHIR resources or functionality.

Scenario

Enhance physician efficiency. The PowerApps application with FHIR for doctors is an indispensable tool when it comes to orchestrating massive patient datasets, optimizing communication, and making their job less stressful with minimum paperwork. It helps get more reliable results and insights faster that might be needed for further patient treatment.

Improve patient experience. The PowerApps application with FHIR for patients ensures all their medical data is secure, while enabling patients access to their health data using user-friendly interface.

Architecture

Overview

Azure API for FHIR

The healthcare industry is rapidly transforming health data to the emerging standard of FHIR® (Fast Healthcare Interoperability Resources). FHIR enables a robust, extensible data model with standardized semantics and data exchange that enables all systems using FHIR to work together. FHIR also enables the rapid exchange of data in applications. Backed by a managed PaaS Azure API for FHIR offering, FHIR also provides a scalable and secure environment for the management and storage of Protected Health Information (PHI) data in the native FHIR format.

Power Platform Connectors for Azure API for FHIR

A connector is a proxy or a wrapper around an API that allows the underlying service to talk to Microsoft Power Platform. Connectors provide a way for users to leverage a set of pre-built actions and triggers to build applications and workflows.

The two Connectors that work with Azure API for FHIR contain a subset of FHIR Resources and are bi-directional, supporting both reads and writes to the FHIR Service.

FHIRBase and FHIRClinical are certified custom connectors that allows for building secure healthcare applications to enable interoperability using FHIR.

Prerequisites

Azure API for FHIR

• Deploy Azure API for FHIR with First Party Auth by deploying via the Azure Portal.
• To access the Azure API for FHIR, apply RBAC by adding users to FHIR Data Reader or FHIR Data Contributor role using Access Control (IAM). The users with access will authenticate through the Connector which assumes their role.
• Load sample data into Azure API for FHIR. Detailed instructions to load synthetic data can be found in the OpenHack-FHIR Github
• See the following link for more details on Using Azure API for FHIR

Power Platform

• Get access to Power Platform environment to create Power Apps.
• Custom Connectors FHIRBase and FHIRClinical need to be added to your PowerPlatform Environment by an Environment Administrator.
• Details on FHIRBase Actions and FHIRClinical Actions for API calls.
• Mapping FHIR Base and Clinical Resources to FHIRBase and FHIRClinical connectors.
• More details on Power Apps

Getting Started

This repository provides a starter kit by reading a few fields from these FHIR resources - Patient, Practitioner, Observation, Encounter, Appointment, Medication Request and Diagnostic Report (Lab Results). It provides the ability to extend the App to include more fields and resources, write and update to Azure API for FHIR.

Let's get started on the steps to import sample Power App packages and run them in your Power Platform, and Azure API for FHIR environments.

Import sample PowerApps package

• Download the sample packages.
• Open your Power Apps Portal.
• Click Apps on the left ribbon.
• Click Import canvas app.
• Click Upload and choose the sample .zip file you downloaded.
• Click Update in IMPORT SETUP and select Create as new, enter Resource name and click Save.
• Click Import.

Edit or Run imported Apps

• You will get a message All package resources were successfully imported.
• Click Apps on the left ribbon to see the App you imported. NOTE there might be a few minutes delay.
• Select the imported App, and choose Edit to look at the code, make changes, or Play to run the App.
• If you already have FHIRBase and FHIRClinical connectors added in Prerequisites above, you will get a popup - your App asking your permission to use the connectors, click Allow.
• Enter the URL of FHIR Server created in Prerequistes above. You can find the Azure API for FHIR service, in FHIR metadata endpoint with the metadata suffix. Ex: https://AzureAPIforFHIRName.azurehealthcareapis.com

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [e-mail] with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.