Hl7.Fhir.Specification.STU3 4.0.0-beta1

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. .NET Framework 4.5.2 This package targets .NET Framework 4.5.2. The package is compatible with this framework or higher.
This is a prerelease version of Hl7.Fhir.Specification.STU3.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Hl7.Fhir.Specification.STU3 --version 4.0.0-beta1                

                    
                

            
NuGet\Install-Package Hl7.Fhir.Specification.STU3 -Version 4.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.STU3" Version="4.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.STU3 --version 4.0.0-beta1                

                    
                

            
#r "nuget: Hl7.Fhir.Specification.STU3, 4.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.STU3 as a Cake Addin
#addin nuget:?package=Hl7.Fhir.Specification.STU3&version=4.0.0-beta1&prerelease

// Install Hl7.Fhir.Specification.STU3 as a Cake Tool
#tool nuget:?package=Hl7.Fhir.Specification.STU3&version=4.0.0-beta1&prerelease
STU3 R4 R4B R5
Build Status Build Status Build Status Build Status
Nuget Nuget Nuget Nuget

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:

Spec version Git branch Core NuGet
R5 (experimental) https://github.com/FirelyTeam/firely-net-sdk/tree/develop-r5 https://www.nuget.org/packages/Hl7.Fhir.R5
R4B (experimental) https://github.com/FirelyTeam/firely-net-sdk/tree/develop-r4B https://www.nuget.org/packages/Hl7.Fhir.R4B
R4 https://github.com/FirelyTeam/firely-net-sdk/tree/develop-r4 https://www.nuget.org/packages/Hl7.Fhir.R4
STU3 https://github.com/FirelyTeam/firely-net-sdk/tree/develop-stu3 https://www.nuget.org/packages/Hl7.Fhir.STU3
DSTU2 https://github.com/FirelyTeam/firely-net-sdk/tree/develop https://www.nuget.org/packages/Hl7.Fhir.DSTU2
DSTU1 https://github.com/FirelyTeam/firely-net-sdk/tree/master-dstu1 https://www.nuget.org/packages/Hl7.Fhir.DSTU

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

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (7)

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

Package Downloads
FhirStarter.Flare.STU3

Contains the necessary classes to create a FHIR server. Both the setup classes and FHIR controller is here.
FhirStarter.Bonfire.STU3

Complements the Spark.Engine library with additional features such as a FHIR service interface and service handling
FhirKhit.Tools.R3

FhirKhit tools for Fhir STU 3
Eir.FhirKhit.R3

FhirKhit tools for Fhir STU 3
FhirTool.Core

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
6.0.0-alpha1 63 12/11/2024
5.11.1 190 11/25/2024
5.11.0 282 11/8/2024
5.10.3 519 9/19/2024
5.10.2 185 9/18/2024
5.10.1 1,178 9/12/2024
5.10.0 210 9/10/2024
5.9.1 233 8/8/2024
5.9.0 520 7/25/2024
5.8.2 218 7/10/2024
5.8.1 688 5/2/2024
5.8.0 233 4/24/2024
5.7.0 425 3/15/2024
5.6.1 512 2/13/2024
5.6.0 251 2/13/2024
5.5.1 325 1/16/2024
5.5.0 326 1/10/2024
5.4.0 577 10/26/2023
5.3.0 429 7/27/2023
5.2.0 594 5/26/2023
5.1.0 407 4/28/2023
5.0.0 926 2/17/2023
5.0.0-beta1 301 12/21/2022
4.3.0 56,426 9/22/2022
4.2.1 3,929 8/17/2022
4.2.0 765 8/16/2022
4.1.0 3,059 7/7/2022
4.0.0 5,259 5/10/2022
4.0.0-beta2 213 3/4/2022
4.0.0-beta1 205 2/7/2022
3.8.3 14,089 4/28/2022
3.8.2 8,997 3/28/2022
3.8.1 619 3/4/2022
3.8.0 31,293 1/7/2022
3.7.0 2,938 12/1/2021
3.6.0 21,526 10/15/2021
3.5.0 3,679 9/2/2021
3.4.0 7,357 6/30/2021
3.3.0 2,679 6/2/2021
3.2.0 5,058 5/4/2021
3.1.0 934 4/1/2021
3.0.0 11,425 2/25/2021
2.0.3 4,253 1/26/2021
2.0.2 701 1/22/2021
2.0.1 4,296 11/25/2020
2.0.0 784 11/16/2020
2.0.0-beta2 400 9/22/2020
2.0.0-beta1 479 7/16/2020
1.9.0 19,609 7/23/2020
1.8.0 1,134 7/2/2020
1.7.0 6,323 5/6/2020
1.6.0 6,602 3/4/2020
1.5.0 3,490 2/4/2020
1.5.0-beta1 530 12/19/2019
1.4.0 13,478 10/10/2019
1.3.0 11,190 7/10/2019
1.2.1 38,682 4/16/2019
1.2.0 2,378 3/29/2019
1.2.0-beta2 578 2/28/2019
1.2.0-beta1 600 2/20/2019
1.1.3 4,336 2/13/2019
1.1.2 13,349 1/31/2019
1.1.1 800 1/30/2019
1.1.0-beta1 737 12/17/2018
1.0.0 1,215 12/17/2018
1.0.0-beta1 659 11/7/2018
0.96.0 15,461 6/6/2018
0.95.0 2,881 4/12/2018
0.94.0 56,514 12/7/2017
0.94.0-beta2 1,641 11/8/2017
0.94.0-beta1 859 11/7/2017
0.93.5 7,570 10/17/2017
0.93.5-beta7 936 9/27/2017
0.93.5-beta6 904 9/5/2017
0.93.5-beta5 882 8/30/2017
0.93.5-beta4 888 8/29/2017
0.93.5-beta3 932 8/3/2017
0.93.5-beta1 941 7/27/2017
0.93.5-alpha1 944 6/15/2017
0.93.4 12,477 5/7/2017
0.93.4-alpha3 932 5/1/2017
0.93.4-alpha2 968 4/26/2017
0.93.4-alpha1 916 4/26/2017
0.93.3 1,206 4/26/2017
0.93.2 1,177 4/25/2017
0.93.1 1,195 4/25/2017
0.93.0 1,386 4/24/2017
0.93.0-alpha4 1,000 4/12/2017
0.93.0-alpha3 966 4/11/2017
0.93.0-alpha2 892 4/11/2017
0.93.0-alpha1 1,031 3/23/2017
0.90.6-alpha7 3,018 9/15/2016
0.90.5-alpha4 1,097 6/7/2016
0.90.5-alpha3 983 4/11/2016

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