Release notes¶
All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.
Release 0.6.0 - 2021-01-27¶
- Known Issue: The (C)-CDA support is currently disabled due to an issue with accessing the .value element of a complex CDA element. We will publish a hotfix for this as soon as possible.
- Known Issue: CSV parsing lowercases all identifiers, meaning that CSV headers should be accessed lowercase in the map file.
- Feature: Upgraded to Firely SDK version 2.0.3. This new major release includes improved support for the normative version of FHIRPath. See https://github.com/FirelyTeam/firely-net-sdk/wiki/Breaking-changes-in-2.0#changes-to-the-fhirpath-engine for more details.
- Feature: “: <type>” (StructureDefinition.group.rule.source.type) can now be used on the source side of a mapping rule
- Feature: “(min..max)” (StructureDefinition.group.rule.source.min / max) can now be used on the source side of a mapping rule
- Feature: StructureMapSourceListMode (first | not_first | last | not_last | only_one) are now fully implemented
- Feature: $convert is now extracting /// experimental = <bool> from a StructureMap as a metadata annotation
- Experimental support for HL7 v2 has been added. See Supported source data formats.
- Feature: Suppport for <<types>> group annotations has been added. Please note that <<type+>> annotations are not yet supported.
- Feature: A “delimiter=<delimiter>” and “header = <absent|present>” parameter can be added to the Content-Type header for text/csv
- Fix: The internal LogicalModel type for CSV representation has been renamed from CSV_Transport to CSV
- Fix: A simple copy rule now checks if the source and target types are the same instance types
- Fix: Let statements with constants can now be used
- Fix: Line numbers have been added to error messages from the CSV parser to improve the debugging experience
- Fix: “/administration” was always included the .reference string of a Reference. Now all references stay as they are defined in the mapping. No absolute reference is being generated when executing $transform
- Fix: Include more details in the error message if the compilation step to IL fails when executing $transform
Release 0.5.0 - 2020-09-04¶
- Feature: Support for parsing Variant Call Format files. See Supported source data formats.
- Feature: External variables can now be used in a log FHIRPath statement using the %var syntax
- Feature: “default” FHIRPath statements can now be specified in mapping rules, the default FHIRPath statement will be executed if the src element is empty
- Feature: Upgrade to .NET FHIR API v1.9
- Fix: An error is now thrown if a mapping attempts to call a mapping function without a contex (e.g. “src.ele -> create(‘<resourceType>’) as var”, note the missing target assignment)
Release 0.4.0 - 2020-07-26¶
- Fetaure: Implement $transform as a Type level interaction using Parameter resources as input
- Feature: Upgrade the .NET FHIR API to 1.7
- Feature: $convert?$persist returns a location header
- Feature: External variables can now be used in a where FHIRPath check using the %var syntax
- Feature: Added support for the truncate transformation function
- Feature: Added support for casting a string to an integer
- Feature: Allow any kind of date type as the first parameter of dateOp
- Feature: Support the direct mapping of complex child elements
- Fix: Don’t overwrite non-repeating elements if the collate option is being used
- Fix: The initial group selection did not account for type aliases
Release 0.3.6 - 2020-06-09¶
- Fix: Using $convert with the ?persist would try to persist the result of the conversion even if there was an error.
Release 0.3.5 - 2020-05-26¶
- Feature: As StructureMaps are conformance resources, they are now stored in the Vonk administration endpoint. Please check Configuring FHIR Mapper on Firely Server for enabling $convert and $transform on the /administration endpoint. Using the FHIR Mapper on the default branch (“{{BASE_URL}}/”) is no longer supported.
- Feature: Support for natively mapping text/csv content to FHIR. See Supported source data formats.
- Feature: Adding ?persist=true to $convert will now automatically store the StructureMap in Vonk
- Fix: Improved the error message if an unknown / uninterpretable Content-Type header was sent to $transform
- Fix: $transform could be executed on a StructureMap using a different information model (e.g. executing $transform using FHIR R4 on a StructureMap stored in STU3). This could lead to unexpected behaviour in the mapping execution.
- Fix: If a FHIR Bundle was produced using $transform and the debug mode was enabled, a Bundle of Bundles would be returned. Now, the debug log is integrated into the result bundle.
- Fix: Using a FHIRPath statement in “check” mode always threw an error regardless of the statement
- Fix: A stacktrace is now included in error messages thrown during the execution of $transform
- Fix: Harmonized the dateOp parameters with FHIR data types.
- Fix: The source resource type of the initial mapping group is now checked against the provided resource type when calling $transform
- Fix: Return an exception if it is attempted to create a child of a choice[x] element without passing a concrete type.
- Fix: Circular ‘using’ statements could lead to a StackOverflow in Vonk
Release 0.3.4 - 2020-03-23¶
- Feature: “Cannot resolve symbol” error messages now include a ‘GroupId’ for improved debugging
- Feature: CCDA transformations are now supported for FHIR version STU3 in addition to R4
- Fix: “@primitivvalue@” is no longer printed when logging static text within a mapping statement
- Fix: “status” metadata information were not copied to the StructureMap by $convert if the mapping file included a comment between the first group and the metadata information
Release 0.3.3 - 2020-03-10¶
- Built against Vonk 3.3.0
- Upgraded .NET API to version 1.6
- Added support for reading HL7 (C)-CDA XML files natively. See Supported source data formats.
Release 0.3.2 - 2020-03-03¶
- Internal release.
Release 0.3.1 - 2020-02-11¶
- Internal release.
Release 0.3.0 - 2020-02-11¶
- Built against Vonk 3.2.0
- Fix: Error messages about empty groups now contain the corresponding group id
- Fix: Improved internal unit tests
- Fix: Improved handling of the ‘collate’ target list mode. In some cases the usage of collate resulted in too many repeating elements.
- Feature: “import” statements can now be used. All StructureMaps need to be uploaded first to the Administration Endpoint of Vonk.
- Fix: $transform was not showing up in the CapabilityStatement of Vonk when using FHIR R4
- Feature: Added support for different parameters for the dateOp function. See Supported Mapping Language features.
- Feature: Calls to evaluate() which return an empty result set result now in an error message to improve debugging
- Feature: $convert now uses the name of the StructureMap as its id
Release 0.2.0 - 2019-11-18¶
- Built against Vonk 3.0.0
- Compatible with Vonk 3.0.0, 3.1.0
- Upgrade to .NET API 1.4.0
- Initial public release
Release 0.1.0 - 2019-11-18¶
- Built against Vonk 2.1.0
- Initial internal release