4.0.0 for R4B (release 20220506)

New major release: 4.0.0

More than a year ago we released the last major release of our Firely .NET SDK (version 3.0) , so it was about time to publish the new major release, version 4.0. In a major release, we allow ourselves to add some breaking changes, clean up some code, and make some code improvements. We have kept these breaking changes to a minimum so that the transition from version 3.x to 4 is not too difficult.

Version 4.0.0 contains:

• New and faster Json deserializer (parser) and serializer. We use the System.Text.Json library now. See documentation about this new serializer on this page
• New and faster Xml serializer. The deserializer will be released in following release.
• We don't target framework netstandard1.6 anymore, but added net6.0. So the following frameworks are supported: net6.0, netstandard2.0 and net452. Since net452 will no longer be supported by Microsoft on April 26, 2022, version net452 will only be available in this major version (4.x)
• a new resource resolver FhirPackageSource, which can resolve resources from a FHIR package
• Cleaned up some stale code
• New package icon

We tried to keep the backwards incompatible changes as minimum as possible. See here for an overview of those changes. This document can help you to upgrade.

Changes:

• #1879: Add NpmPackageResolver
• #1963: Removed file FhirNetApi.snk.enc
• #1976: Updated common for FiveWs
• #1980: Move some client classes to common :
  • ResourceReferenceExtensions
  • SearchParamsExtensions
  • TokenExtensions
• #1969: Validator checks if invariants don't result in empty anymore
• #1988: Removed FHIR Core packages from the specification project
• #1995: Adds Package client to the FHIR package source
• #1998: Make LegacyFhirClient obsolete
• #1957: Bump SharpZipLib from 0.86.0 to 1.3.3 in /src/Hl7.Fhir.Core.Tests
• #1934: 1095 - Move useful ElementDefinition ext methods to a single place
• #1951: Move ITerminologyService and FhirOperationException to Hl7.Fhir.Support.Poco
• #1950: Changed package icon with new logo of Firely SDK
• #1810: STU3: Behavior of PocoStuctureDefinitionSummaryProvider is now the same as StuctureDefinitionSummaryProvider
• #1945: Add setting to ignore a custom list of constraints in the validator
• #1946: Remove the ignore option in the validation setting to check best practices constraints
• #1931: Evaluate FhirPath expression using the correct scope
• #1930: Introduce CodedException everywhere
• #1896: Cleanup projectfiles and dependencies
• #1928: Use existing ValidationAttributes in the new Json deserializer
• #1911: Add new, faster, Json deserializer for POCOs
• #1910: Added an Xml serializer based on IReadOnlyDictionary
• #1821: Add IReadOnlyDictionary based Json serializer
• #1816: Adding IReadOnlyDictionary support
• #2029: HttpMessageHandler Passed To Constructor Of FhirClient Gets Disposed When FhirClient Is Disposed
• #2064: Corrected bugs in new faster serializers/deserializers
• #2061: Catch InvalidOperationException when FhirClient encounters non-FHIR Json/XML in the response
• #2048: Use IssueComponent.Expression instead of IssueComponent.Location
• #2057: Handle and generate absolute contentReferences R4
• #2050: Updated unit test TestExpandBundleEntryResource for R4
• #2054: Handle and generate absolute contentReferences
• #2055: Support providing the HttpClient direct to the FhirClient
• #2049: Support providing the HttpClient direct to the FhirClient
• #2047: #2033 Wrong namespace for the SUBSETTED type
• #2033: Wrong Namespace for R4 Subsetted Tag
• #2038: Updated unit test TestExpandBundleEntryResource.
• #2040: Do not dispose of a shared HttpMessageHandler passed into the constructor
• #2035: Treat warnings as errors
• #2045: Use the official 3.0 release of Firely.Fhir.Packages
• #2043: Use a workflow for automatic add issues to the project
• #2042: Added Source Link
• #2041: Signing the NuGet Packages
• #2023: Changes to improve performance of Bundle validation (R4)
• #2000: Fix for PR #1990 (R4)
• #1990: 3-way merge of cardinality of an element
• #1999: Fix for PR #1990

This list of changes was auto generated.

4.0.0 for R4 (release 20220506)

New major release: 4.0.0

More than a year ago we released the last major release of our Firely .NET SDK (version 3.0) , so it was about time to publish the new major release, version 4.0. In a major release, we allow ourselves to add some breaking changes, clean up some code, and make some code improvements. We have kept these breaking changes to a minimum so that the transition from version 3.x to 4 is not too difficult.

Version 4.0.0 contains:

• New and faster Json deserializer (parser) and serializer. We use the System.Text.Json library now. See documentation about this new serializer on this page
• New and faster Xml serializer. The deserializer will be released in following release.
• We don't target framework netstandard1.6 anymore, but added net6.0. So the following frameworks are supported: net6.0, netstandard2.0 and net452. Since net452 will no longer be supported by Microsoft on April 26, 2022, version net452 will only be available in this major version (4.x)
• a new resource resolver FhirPackageSource, which can resolve resources from a FHIR package
• Cleaned up some stale code
• New package icon

We tried to keep the backwards incompatible changes as minimum as possible. See here for an overview of those changes. This document can help you to upgrade.

Changes:

• #1879: Add NpmPackageResolver
• #1963: Removed file FhirNetApi.snk.enc
• #1976: Updated common for FiveWs
• #1980: Move some client classes to common :
  • ResourceReferenceExtensions
  • SearchParamsExtensions
  • TokenExtensions
• #1969: Validator checks if invariants don't result in empty anymore
• #1988: Removed FHIR Core packages from the specification project
• #1995: Adds Package client to the FHIR package source
• #1998: Make LegacyFhirClient obsolete
• #1957: Bump SharpZipLib from 0.86.0 to 1.3.3 in /src/Hl7.Fhir.Core.Tests
• #1934: 1095 - Move useful ElementDefinition ext methods to a single place
• #1951: Move ITerminologyService and FhirOperationException to Hl7.Fhir.Support.Poco
• #1950: Changed package icon with new logo of Firely SDK
• #1810: STU3: Behavior of PocoStuctureDefinitionSummaryProvider is now the same as StuctureDefinitionSummaryProvider
• #1945: Add setting to ignore a custom list of constraints in the validator
• #1946: Remove the ignore option in the validation setting to check best practices constraints
• #1931: Evaluate FhirPath expression using the correct scope
• #1930: Introduce CodedException everywhere
• #1896: Cleanup projectfiles and dependencies
• #1928: Use existing ValidationAttributes in the new Json deserializer
• #1911: Add new, faster, Json deserializer for POCOs
• #1910: Added an Xml serializer based on IReadOnlyDictionary
• #1821: Add IReadOnlyDictionary based Json serializer
• #1816: Adding IReadOnlyDictionary support
• #2029: HttpMessageHandler Passed To Constructor Of FhirClient Gets Disposed When FhirClient Is Disposed
• #2064: Corrected bugs in new faster serializers/deserializers
• #2048: Use IssueComponent.Expression instead of IssueComponent.Location
• #2057: Handle and generate absolute contentReferences R4
• #2050: Updated unit test TestExpandBundleEntryResource for R4
• #2054: Handle and generate absolute contentReferences
• #2049: Support providing the HttpClient direct to the FhirClient
• #2047: #2033 Wrong namespace for the SUBSETTED type
• #2033: Wrong Namespace for R4 Subsetted Tag
• #2038: Updated unit test TestExpandBundleEntryResource.
• #2040: Do not dispose of a shared HttpMessageHandler passed into the constructor
• #2035: Treat warnings as errors
• #2045: Use the official 3.0 release of Firely.Fhir.Packages
• #2043: Use a workflow for automatic add issues to the project
• #2042: Added Source Link
• #2041: Signing the NuGet Packages
• #2023: Changes to improve performance of Bundle validation (R4)
• #2000: Fix for PR #1990 (R4)
• #1990: 3-way merge of cardinality of an element
• #1999: Fix for PR #1990

This list of changes was auto generated.

3.8.3 for STU3 (release 20220428)

Changes:

Bugfixes:

• #2029: HttpMessageHandler Passed To Constructor Of FhirClient Gets Disposed When FhirClient Is Disposed

Others:

• #2048: Use IssueComponent.Expression instead of IssueComponent.Location
• #2054: Handle and generate absolute contentRefernces
• #2055: Support providing the HttpClient direct to the FhirClient - STU3
• #2046: STU3: Do not dispose of a shared HttpMessageHandler passed into the constructor
• #2038: Updated unit test TestExpandBundleEntryResource.
• #2043: Use a workflow for automatic add issues to the project
• #2042: Added Source Link
• #2041: Signing the NuGet Packages
• #2022: Changes to improve performance of Bundle validation (R3)
• #1999: Fix for PR #1990
• #1990: 3-way merge of cardinality of an element

This list of changes was auto generated.

3.8.3 for R5 (release 20220428)

Changes:

Bugfixes:

• #2029: HttpMessageHandler Passed To Constructor Of FhirClient Gets Disposed When FhirClient Is Disposed

Others:

• #2048: Use IssueComponent.Expression instead of IssueComponent.Location
• #2057: Handle and generate absolute contentReferences R4
• #2050: Updated unit test TestExpandBundleEntryResource for R4
• #2054: Handle and generate absolute contentRefernces
• #2049: Support providing the HttpClient direct to the FhirClient
• #2038: Updated unit test TestExpandBundleEntryResource.
• #2040: Do not dispose of a shared HttpMessageHandler passed into the constructor
• #2043: Use a workflow for automatic add issues to the project
• #2042: Added Source Link
• #2041: Signing the NuGet Packages
• #2023: Changes to improve performance of Bundle validation (R4)
• #1990: 3-way merge of cardinality of an element

This list of changes was auto generated.

3.8.3 for R4B (release 20220428)

Changes:

Bugfixes:

• #2029: HttpMessageHandler Passed To Constructor Of FhirClient Gets Disposed When FhirClient Is Disposed

Others:

• #2048: Use IssueComponent.Expression instead of IssueComponent.Location
• #2057: Handle and generate absolute contentReferences R4
• #2050: Updated unit test TestExpandBundleEntryResource for R4
• #2054: Handle and generate absolute contentReferences
• #2049: Support providing the HttpClient direct to the FhirClient
• #2038: Updated unit test TestExpandBundleEntryResource.
• #2040: Do not dispose of a shared HttpMessageHandler passed into the constructor
• #2043: Use a workflow for automatic add issues to the project
• #2042: Added Source Link
• #2041: Signing the NuGet Packages
• #2023: Changes to improve performance of Bundle validation (R4)
• #2000: Fix for PR #1990 (R4)
• #1990: 3-way merge of cardinality of an element

This list of changes was auto generated.

3.8.3 for R4 (release 20220428)

Changes:

Bugfixes:

• #2029: HttpMessageHandler Passed To Constructor Of FhirClient Gets Disposed When FhirClient Is Disposed

Others:

• #2048: Use IssueComponent.Expression instead of IssueComponent.Location
• #2057: Handle and generate absolute contentReferences R4
• #2050: Updated unit test TestExpandBundleEntryResource for R4
• #2049: Support providing the HttpClient direct to the FhirClient
• #2038: Updated unit test TestExpandBundleEntryResource.
• #2040: Do not dispose of a shared HttpMessageHandler passed into the constructor
• #2043: Use a workflow for automatic add issues to the project
• #2042: Added Source Link
• #2041: Signing the NuGet Packages
• #2023: Changes to improve performance of Bundle validation (R4)
• #2000: Fix for PR #1990 (R4)
• #1990: 3-way merge of cardinality of an element

This list of changes was auto generated.

3.8.2 for STU3 (release 20220328) HOTFIX

Hotfix for the Validator. This fix solves a performance issue on validating large bundles. The Validator uses now state to keep track of which (nested/contained)resources have already been validated. In this way we are avoiding duplicate validation which keep bundle validation performance reasonable.

Changes:

• #2022: Changes to improve performance of Bundle validation (R3)

This list of changes was auto generated.

3.8.2 for R5 (release 20220328) HOTFIX

Hotfix for the Validator. This fix solves a performance issue on validating large bundles. The Validator uses now state to keep track of which (nested/contained)resources have already been validated. In this way we are avoiding duplicate validation which keep bundle validation performance reasonable.

Changes:

• #2023: Changes to improve performance of Bundle validation (R4)
• #2022: Changes to improve performance of Bundle validation (R3)

This list of changes was auto generated.

3.8.2 for R4B (release 20220328) HOTFIX

Hotfix for the Validator. This fix solves a performance issue on validating large bundles. The Validator uses now state to keep track of which (nested/contained)resources have already been validated. In this way we are avoiding duplicate validation which keep bundle validation performance reasonable.

Changes:

• #2023: Changes to improve performance of Bundle validation (R4)
• #2022: Changes to improve performance of Bundle validation (R3)

This list of changes was auto generated.

3.8.2 for R4 (release 20220328) HOTFIX

Hotfix for the Validator. This fix solves a performance issue on validating large bundles. The Validator uses now state to keep track of which (nested/contained)resources have already been validated. In this way we are avoiding duplicate validation which keep bundle validation performance reasonable.

Changes:

• #2023: Changes to improve performance of Bundle validation (R4)

This list of changes was auto generated.