Hl7.Fhir.Specification.R4 5.0.0-beta1

Prefix Reserved
This is a prerelease version of Hl7.Fhir.Specification.R4.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Hl7.Fhir.Specification.R4 --version 5.0.0-beta1                

                    
                

            
NuGet\Install-Package Hl7.Fhir.Specification.R4 -Version 5.0.0-beta1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Hl7.Fhir.Specification.R4" Version="5.0.0-beta1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Hl7.Fhir.Specification.R4 --version 5.0.0-beta1                

                    
                

            
#r "nuget: Hl7.Fhir.Specification.R4, 5.0.0-beta1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Hl7.Fhir.Specification.R4 as a Cake Addin
#addin nuget:?package=Hl7.Fhir.Specification.R4&version=5.0.0-beta1&prerelease

// Install Hl7.Fhir.Specification.R4 as a Cake Tool
#tool nuget:?package=Hl7.Fhir.Specification.R4&version=5.0.0-beta1&prerelease

Build Status

IMPORTANT The 5.0 version of the SDK contains substantial changes to the way we have organized the NuGet packages and source code. Please read before installing this new 5.0 version.

IMPORTANT Version 5.0 of the SDK is in beta. Navigate back to the main repository for the stable 4.x release.

Introduction

This is Firely's official support SDK for working with HL7 FHIR on the Microsoft .NET (dotnet) platform.

This SDK 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

Release notes

Read the releases notes on firely-net-sdk/releases. You can find documentation about this SDK in 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:

  • DSTU1 (published September 2014) is mostly obsolete and we are no longer maintaining this library for DSTU1.
  • DSTU2 (published October 2015) is mostly obsolete and and we are no longer maintaining this library for DSTU2.
  • STU3 (published March 2017) is older, but still widely in use. Is fully supported by this library.
  • R4 (published January 2019) is in active use and fully supported by this library.
  • R4B (published May 2022) is the latest official release of the FHIR spec and is fully supported by this library.
  • R5 (not yet published) is work-in-progress. This library currently supports "snapshot-1".

Planned release DSTU2.1 was never published by HL7, but you will still find traces of it. We are not maintaining the version, but the NuGet package is still available.

Read the online documentation, and download the correct NuGet package for your FHIR release. Depending on the version of FHIR you require, you'll find the relevant link to the package below. For most developers, just including this NuGet package is enough to get started.

Spec version Git branch NuGet
R5 https://github.com/FirelyTeam/firely-net-sdk/tree/release/5.0.0 https://www.nuget.org/packages/Hl7.Fhir.R5
R4B https://github.com/FirelyTeam/firely-net-sdk/tree/release/5.0.0 https://www.nuget.org/packages/Hl7.Fhir.R4B
R4 https://github.com/FirelyTeam/firely-net-sdk/tree/release/5.0.0 https://www.nuget.org/packages/Hl7.Fhir.R4
STU3 https://github.com/FirelyTeam/firely-net-sdk/tree/release/5.0.0 https://www.nuget.org/packages/Hl7.Fhir.STU3
DSTU2 https://github.com/FirelyTeam/firely-net-sdk/tree/develop-dstu2 https://www.nuget.org/packages/Hl7.Fhir.DSTU2

Upgrading

We spend a lot of effort trying to maintain compile compatibility (not binary compatibility) between minor releases of the SDK. We do, however, publish a new major version with breaking changes about once a year. The table below lists the breaking changes for each of the major upgrades.

SDK version Breaking changes
2.x https://github.com/FirelyTeam/firely-net-sdk/wiki/Breaking-changes-in-2.0
3.x https://github.com/FirelyTeam/firely-net-sdk/wiki/Breaking-changes-in-3.0
4.x https://github.com/FirelyTeam/firely-net-sdk/wiki/Breaking-changes-in-4.0
5.x https://github.com/FirelyTeam/firely-net-sdk/wiki/Breaking-changes-in-5.0

The SDK has been totally restructured for the 5.0 release. Please take not of the following changes if you are upgrading:

  • The additional Hl7.Fhir.Specification packages are no longer relevant starting at version 5.0 of the SDK and should not be included in your projects anymore.
  • The main NuGet package no longer contains the specification.zip file that contains all the conformance resources used in the FHIR specification. If you are using the ZipSource resolvers (e.g. for profile validation), you will need to include the correct HL7.Fhir.Specification.Data.* NuGet packages. We recommend you look at the newer FhirPackageResolver that directly use the HL7-published NPM packages. Documentation can be found here.
  • The profile validator has been split off into its own repository. The NuGet packages for the 5.0 version of the profile validator will be posted soon.

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 contributions!

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

Note: Since the 5.0 release of the SDK, the branches for STU3 and newer have been combined in a single develop branch. This branch now contains the code for all FHIR releases from STU3 and up. We have also refactored all the common code out to projects within that branch, so the separate common repository (at https://github.com/FirelyTeam/firely-net-common) is no longer in use. This greatly simplifies management and creating PRs for these projects.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages (11)

Showing the top 5 NuGet packages that depend on Hl7.Fhir.Specification.R4:

Package Downloads
Eir.FhirKhit.R4

FhirKhit tools for Fhir Release 4
FhirKhit.Tools.R4

FhirKhit tools for Fhir Release 4
FhirTool.Core

Package Description
FhirStarter.R4.Detonator.Core

FhirStarter is a lightweight FHIR server framwork where the bare minimum of functionaliy gets your FHIR server up and running. The framework lets you create a FHIR service which can be based on several input sources and is joined a single output. The main library for the FhirStarter engine. Contains logic for the FHIR rest interface, structuredefinitions and much more that can be used as reference in other projects. There is also logic from FireLy's https://github.com/FirelyTeam/spark code. For tutorials, check out the wiki from the project url. For current project status, check out the project board for issues and assignment cards. *NOTE* Hl7.Fhir.Specification.R4 must be added directly to the FHIR server project (Twisted) for the validator to work. Icons made by https://www.flaticon.com/authors/roundicons"
FhirStarter.R4.Instigator.Core

FhirStarter is a lightweight FHIR server framwork where the bare minimum of functionaliy gets your FHIR server up and running. The framework lets you create a FHIR service which can be based on several input sources and is joined a single output. The Instigator library has the necessary components to setup the FHIR server part of the service. The library will add a specific settings file + a log4net.config file which can be customized. The Detonator library is also necessary to setup the logic bits. For tutorials, check out the wiki from the project url. For current project status, check out the project board for issues and assignment cards. *NOTE* Hl7.Fhir.Specification.R4 must be added directly to the FHIR server project (Twisted) for the validator to work. Icons made by https://www.flaticon.com/authors/roundicons

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
5.11.1 38 11/25/2024
5.11.0 391 11/8/2024
5.10.3 887 9/19/2024
5.10.2 188 9/18/2024
5.10.1 351 9/12/2024
5.10.0 119 9/10/2024
5.9.1 1,302 8/8/2024
5.9.0 2,406 7/25/2024
5.8.2 333 7/10/2024
5.8.1 2,672 5/2/2024
5.8.0 189 4/24/2024
5.7.0 1,451 3/15/2024
5.6.1 3,804 2/13/2024
5.6.0 912 2/13/2024
5.5.1 3,139 1/16/2024
5.5.0 1,258 1/10/2024
5.4.0 6,666 10/26/2023
5.3.0 42,446 7/27/2023
5.2.0 3,314 5/26/2023
5.1.0 2,828 4/28/2023
5.0.0 4,589 2/17/2023
5.0.0-beta1 2,039 12/21/2022
4.3.0 271,182 9/22/2022
4.2.1 17,098 8/17/2022
4.2.0 1,262 8/16/2022
4.1.0 8,341 7/7/2022
4.0.0 79,224 5/10/2022
4.0.0-beta2 1,319 3/4/2022
4.0.0-beta1 731 2/7/2022
3.8.3 4,896 4/28/2022
3.8.2 39,005 3/28/2022
3.8.1 6,977 3/4/2022
3.8.0 19,247 1/7/2022
3.7.0 5,060 12/1/2021
3.6.0 19,740 10/15/2021
3.5.0 35,806 9/2/2021
3.4.0 12,094 6/30/2021
3.3.0 4,405 6/2/2021
3.2.0 7,256 5/4/2021
3.1.0 6,051 4/1/2021
3.0.0 21,001 2/25/2021
2.0.3 14,156 1/26/2021
2.0.2 1,730 1/22/2021
2.0.1 17,363 11/25/2020
2.0.0 1,296 11/16/2020
2.0.0-beta2 985 9/22/2020
2.0.0-beta1 3,027 7/16/2020
1.9.0 31,018 7/23/2020
1.8.0 1,713 7/2/2020
1.7.0 33,034 5/6/2020
1.6.0 21,888 3/4/2020
1.5.0 24,872 2/4/2020
1.5.0-beta1 1,341 12/19/2019
1.4.0 13,260 10/10/2019
1.3.0 8,728 7/10/2019
1.2.1 7,071 4/16/2019
1.2.0 1,327 3/29/2019
1.2.0-beta2 1,215 2/28/2019
1.2.0-beta1 1,123 2/20/2019
0.96.1 4,126 9/25/2018
0.96.0 1,755 6/6/2018

See https://github.com/FirelyTeam/firely-net-sdk/releases