Deployment Guide
Install Visual Studio Code
- Download and install Visual Studio Code
Install .NET Core 2.1
-
Download and install .NET Core 2.1 SDK 2.1.803
-
Test your installation by opening a new terminal and running the following command:
dotnet
Running the app
-
Clone the project and open it in Visual Studio Code.
-
Open the file appsettings.json
{ "Logging": { "LogLevel": { "Default": "Debug", "System": "Information", "Microsoft": "Information" } }, "Instance": "", "Tenant": "", "ClientId": "", "ClientSecret": "", "BaseAddress": "", "Scope": "" }
-
Replace the empty fields with the Azure FHIR API credentials you have been given.
-
Save the file.
-
Navigate to the directory dotnet-azure-fhir-web-api using the terminal inside Visual Studio Code.
-
In the terminal, run the following command:
dotnet run
-
Open a web browser and navigate to https://localhost:5001/api/Patient/ to view a list of all patients.
List of API endpoints
Patients
- GET all patients: /api/Patient
- GET a patient: /api/Patient/ patient ID
- GET a selected number of pages of patient: api/pages/ number of pages
Observations
- GET all observations for a patient: /api/Observation/ patient ID
- GET a single observation for a patient: api/Observation/single/ observation ID
- GET a selected number of pages of observations for a patient: api/Observation/pages/ number of pages/patient ID
Adding more controllers
The app uses Dependency Injection (DI) design pattern. For more information on how to implement that on .NET Core check this article
Logging and debugging
Check this article for an overview of the implemented logging features.
Tool Suite
- A platform that provides access and documentation to FHIR developer tools
- Access the platform at: https://toolsuite.azurewebsites.net/
- Login with your UCL email
- Register the application you are creating for the Hackathon
- Read documentation for chosen tool to gain access
- Input chosen tools in application profile