Firely.Fhir.Validation.R4 3.2.0

Introduction

This is Firely's official FHIR validator API for validating HL7 FHIR resources against profiles. These profiles contain the full gamut of FHIR validation rules, and are used to validate the data in the FHIR resources.

Release notes

Read the releases notes on firely-net-sdk/releases.

Documentation

You can find documentation on the validation api at the Firely docs site.

Getting Started

Before installing one of the NuGet packages (or clone the repo) it is important to understand that HL7 has published several updates of the FHIR specification, each with breaking changes - so you need to ensure you use the version that is right for you. Read the online documentation, and download the correct package for your FHIR release by searching for Firely.Fhir.Validation.<spec version>. For most developers, just including this NuGet package is enough to get started.

The main class in this package is the Validator.

⚠️ Thread-safety warning: The Validator class and its associated resolvers (including their internal caches) are not thread-safe. If you need to perform validation concurrently across multiple threads, you must create a separate Validator instance (and separate resolver instances) for each thread. Sharing a single instance across threads without synchronization will result in unpredictable behavior.

An example implementation can be found here.

Using a pre-release NuGet package

Every release of the validator API results in a NuGet package on the normal NuGet feed. However, each commit on our develop branch also results in a pre-release package. These are public too. So if you want to be brave and use a pre-release packages, you can do so by adding https://nuget.pkg.github.com/FirelyTeam/index.json to your NuGet sources:

• Get a Personal Access token (PAT) from github.com with scope read:packages

• Next open a console on your machine and run dotnet nuget add source --name github --username <USERNAME> --password <PAT> https://nuget.pkg.github.com/FirelyTeam/index.json

USERNAME: your username on GitHub PAT: your Personal access token with at least the scope read:packages

Support

We actively monitor the issues coming in through the GitHub repository. You are welcome to register your bugs and feature suggestions there. For questions and broader discussions, we use the .NET FHIR Implementers chat on Zulip.

Contributing

We are welcoming contributions!

If you want to participate in this project, we're using Git Flow for our branch management. Please submit PRs on GitHub with changes against the develop branch.