Introduction

This is a direct port of the Java implementation of the HL7 FHIR Mapping Language on the Microsoft .NET (dotnet) platform. https://github.com/hapifhir/org.hl7.fhir.core/blob/master/org.hl7.fhir.r4/src/main/java/org/hl7/fhir/r4/utils/StructureMapUtilities.java

The file/code structure is planned to remain inline with the java implementation to ease maintenance.

Possible uses:

• between versions of FHIR
• data exaction for SDH (SDOH etc)
• from US Core to IPA
• other formats to/from FHIR

Release notes

Not released yet!

What's in the box?

This library provides:

• FHIR Mapping Language (FML) Parser - returning a Firely SDK StructureMap POCO object
• Serializer to output a FML representation of a StructureMap POCO object
• Evaluation of FML transforms

Running the unit tests locally

There are a few minor tricks to get the unit tests running locally as they depend on some other github projects for the source content, specifically:

• https://github.com/FHIR/interversion.git
• https://github.com/HL7/fhir-sdoh-clinicalcare.git
  • There are a few issues with these maps that i've resolved in this branch https://github.com/brianpos/interversion/tree/Feature/BP-R3-R4mapupdates

Once you have these projects locally, update the path of these in the unit test classes

Note: The unit test PrepareStu3CoreStructureDefinitions should be run to download the cross version npm packages from http://fhir.org/packages/xver-packages.zip

And not all unit tests actually have any assertions, some are done for debugging purposed and require manual checks of the output trace. (These will be fixed as the project matures)

If you are on mac or linux or don't have the full Visual Studio and just want to run it from the commandline there is a test tool that you can use to run directly.

brian@linux-test:fhir-net-mappinglanguage/VersionConversionTester$ dotnet run --project VersionConversionTester.csproj /mnt/c/git/hl7/interversion /mnt/c/temp/examples-json.zip

You can also run this in the visual studio debugger and select the paths via the launchSettings (created one for e and c drives)

Getting Started

Coming soon

Support

Exploratory project at this stage, but may support this via issues coming in through the GitHub repository at https://github.com/brianpos/fhir-net-mappinglanguage/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-r4/develop-r4B branches as mentioned above!

GIT branching strategy

• NVIE
• Or see: Git workflow

FML language Issues

https://jira.hl7.org/browse/FHIR-39282