readme.md

Dotnet Sample

Introduction

This directory contains a demo client displaying how to use the PubSub feature of Firely Server. The client is written in C# running on dotnet core. and using the Firely Server Contract nuget package.

Build

Run the following command to build the project.

dotnet restore
dotnet build

Usage

First you need to start the following dependencies to be able to run the client

RabbitMQ

In the sample, RabbitMq is used as the message bus for the PubSub feature.

So, in order to be able run the sample, you need to instantiate a RabbitMQ instance with following command

docker run -d --name firely-broker -p 15672:15672 -p 5672:5672 rabbitmq:3-management

when browsing to http://localhost:15672 - management console will be opened. Default credentials are guest/guest

Jaeger

Jaeger can be use to observed the OpenTelemetry traces from the sample.

In order to enable that, you need to instantiate a Jaeger instance with the following command:

docker run -d --name jaeger -p 16686:16686 -p 4317:4317 jaegertracing/all-in-one:latest

The traces can then be viewed when browsing to http://localhost:16686.

Firely Server

Start Firely server and make sure to enable the PubSub in the settings file as described in the documentation.

Using the client interactively

Once RabbitMq and Firely Server are running, you can start the client using:

dotnet run --project Firely.Server.MessageSender

You then got an CLI interface where you can enter command and then get corresponding response and notification.

Valid commands are:

        Quit
                q 
        Help
                ? 
        Create Patient
                c familyName patientId patientVersion
        Retrieve Patient
                r patientId patientVersion
        Update Patient
                u familyName patientId newPatientVersion currentPatientVersion
        Delete Patient
                d patientId currentPatientVersion

Using the client to import resources from a directory

Run the client with the import <directoryPath> command appended. This will perform an upsert of FHIR JSON resources from this directory to Firely Server:

dotnet run --project Firely.Server.MessageSender import "./test data"