Hl7.Fhir.R4B
4.0.0-beta2
Prefix Reserved
See the version list below for details.
dotnet add package Hl7.Fhir.R4B --version 4.0.0-beta2
NuGet\Install-Package Hl7.Fhir.R4B -Version 4.0.0-beta2
<PackageReference Include="Hl7.Fhir.R4B" Version="4.0.0-beta2" />
paket add Hl7.Fhir.R4B --version 4.0.0-beta2
#r "nuget: Hl7.Fhir.R4B, 4.0.0-beta2"
// Install Hl7.Fhir.R4B as a Cake Addin #addin nuget:?package=Hl7.Fhir.R4B&version=4.0.0-beta2&prerelease // Install Hl7.Fhir.R4B as a Cake Tool #tool nuget:?package=Hl7.Fhir.R4B&version=4.0.0-beta2&prerelease
STU3 | R4 | R4B | R5 |
---|---|---|---|
Introduction
This is the official support SDK for working with HL7 FHIR on the Microsoft .NET (dotnet) platform.
Release notes
Read the releases notes on firely-net-sdk/releases. You can find documentation about this SDK in the Firely docs site.
What's in the box?
This library provides:
- Class models for working with the FHIR data model using POCO's
- Xml and Json parsers and serializers
- A REST client for working with FHIR-compliant servers
- Helper classes to work with the specification metadata, most notably
StructureDefinition
and generation of differentials - Validation of instances based on profiles
- Evaluation FhirPath expressions
IMPORTANT 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:
- DSTU1 (published September 2014) is mostly obsolete, and the .NET version for this publication is not maintained anymore.
- DSTU2 (published October 2015) in widespread use, and is not supported by this library anymore since version 2.0.
- STU3 (published March 2017), mature support by this library and most other tooling on the market.
- R4 (published January 2019), the latest release of the FHIR spec and fully supported by this library.
Planned release DSTU2.1 was never published by HL7, but you will still find traces of it, in particular we still keep the NuGet package for it available.
Getting Started
Get started by reading the online documentation. Depending on the version of FHIR you require, you'll find the relevant links to the packages and develop branches in this repository below:
Please note that the source code for the Firely .NET SDK is split up into two GitHub repos: one (with the branches listed above) with code that is specific to a FHIR release (this repo), and one that contains the code that is applicable across all FHIR releases (a separate common repository). This second repository is included in the first one using a Git Submodule, so all you have to do is check out the main repo (this one) and learn how to work with Submodules. To clone this repository with submodules, you can do:
git clone --recurse-submodules -j8 https://github.com/FirelyTeam/firely-net-sdk.git .
Please refer to our submodules overview for more details.
Upgrading
Upgrading to 2.x? Breaking changes are listed here.
Going further? See 3.x breaking changes.
Support
We actively monitor the issues coming in through the GitHub repository at https://github.com/FirelyTeam/firely-net-sdk/issues. 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 contributors!
If you want to participate in this project, we're using Git Flow for our branch management, so please submit your commits using pull requests on the correct develop-stu3
/develop-r4
/develop-r4B
/develop-r5
branches as mentioned above!
GIT branching strategy
- NVIE
- Or see: Git workflow
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net452 is compatible. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.5.2
- Hl7.Fhir.Serialization (>= 4.0.0-beta2)
- Hl7.Fhir.Support (>= 4.0.0-beta2)
- Hl7.Fhir.Support.Poco (>= 4.0.0-beta2)
- Hl7.FhirPath (>= 4.0.0-beta2)
-
.NETStandard 2.0
- Hl7.Fhir.Serialization (>= 4.0.0-beta2)
- Hl7.Fhir.Support (>= 4.0.0-beta2)
- Hl7.Fhir.Support.Poco (>= 4.0.0-beta2)
- Hl7.FhirPath (>= 4.0.0-beta2)
- System.ComponentModel.Annotations (>= 5.0.0)
-
net6.0
- Hl7.Fhir.Serialization (>= 4.0.0-beta2)
- Hl7.Fhir.Support (>= 4.0.0-beta2)
- Hl7.Fhir.Support.Poco (>= 4.0.0-beta2)
- Hl7.FhirPath (>= 4.0.0-beta2)
- System.ComponentModel.Annotations (>= 5.0.0)
NuGet packages (14)
Showing the top 5 NuGet packages that depend on Hl7.Fhir.R4B:
Package | Downloads |
---|---|
Hl7.Fhir.Specification.R4B
Metapackage including Firely's SDK Base Class Library and specification conformance data for HL7 FHIR R4B. Its sole purpose is to provide a backwards-compatible package reference for projects that used pre-5.0 versions of the SDK. |
|
Udap.Model
Package is a part of the UDAP reference implementation for .NET. |
|
brianpos.Fhir.R4B.DemoFileSystemFhirServer
Demonstration implementation of a FHIR R4 Facade using the file system as a super simple storage provider |
|
Hl7.Fhir.Validation.Legacy.R4B
Firely's Legacy profile validator (pre-SDK 5.0) for HL7 FHIR R4B. |
|
brianpos.Fhir.R4B.WebApi.AspNetCore
This library Implements a FHIR Facade that you can add to other projects where you provide the storage engine through implementing a set of model interface classes |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
6.0.0-alpha1 | 107 | 12/11/2024 |
5.11.1 | 2,061 | 11/25/2024 |
5.11.0 | 2,175 | 11/8/2024 |
5.10.3 | 6,852 | 9/19/2024 |
5.10.2 | 645 | 9/18/2024 |
5.10.1 | 935 | 9/12/2024 |
5.10.0 | 516 | 9/10/2024 |
5.9.1 | 6,403 | 8/8/2024 |
5.9.0 | 1,836 | 7/25/2024 |
5.8.2 | 3,437 | 7/10/2024 |
5.8.1 | 11,842 | 5/2/2024 |
5.8.0 | 2,921 | 4/24/2024 |
5.7.0 | 4,287 | 3/15/2024 |
5.6.1 | 6,819 | 2/13/2024 |
5.6.0 | 867 | 2/13/2024 |
5.5.1 | 3,130 | 1/16/2024 |
5.5.0 | 1,768 | 1/10/2024 |
5.4.0 | 35,649 | 10/26/2023 |
5.3.0 | 27,467 | 7/27/2023 |
5.2.0 | 6,107 | 5/26/2023 |
5.1.0 | 3,104 | 4/28/2023 |
5.0.0 | 7,691 | 2/17/2023 |
5.0.0-beta3 | 270 | 2/1/2023 |
5.0.0-beta2 | 283 | 1/19/2023 |
5.0.0-beta1 | 1,976 | 12/21/2022 |
4.3.0 | 100,495 | 9/22/2022 |
4.2.1 | 14,616 | 8/17/2022 |
4.2.0 | 3,939 | 8/16/2022 |
4.1.0 | 3,013 | 7/7/2022 |
4.0.0 | 164,827 | 5/10/2022 |
4.0.0-beta2 | 1,515 | 3/4/2022 |
4.0.0-beta1 | 908 | 2/7/2022 |
3.8.3 | 2,077 | 4/28/2022 |
3.8.2 | 1,312 | 3/28/2022 |
3.8.1 | 2,898 | 3/4/2022 |
3.8.0 | 920 | 1/7/2022 |
3.7.0 | 1,534 | 12/1/2021 |
3.6.0 | 1,009 | 10/15/2021 |
3.5.0 | 988 | 9/2/2021 |
3.4.0 | 1,064 | 6/30/2021 |
3.3.0 | 1,062 | 6/2/2021 |
3.2.0 | 1,094 | 5/4/2021 |