Tutorial

Note

A whole tutorial referenced here is available in the following Postman collection: https://documenter.getpostman.com/view/1515623/2sBXcLex64

Note

Alternatively to setting up a local instance of openFHIR, you can also use https://sandbox.open-fhir.com (as used in the referenced postman collection above)

The tutorial’s example data is a realistic newborn growth chart (daily weight, length, BMI and head circumference measurements during the maternity stay), and the FHIR side of the mappings conforms to the HL7 Vital Signs with Qualifying Elements implementation guide — profile-fixed LOINC codes, the mandatory vital-signs category, status, subject and effective[x], meta.profile claims, and the AssociatedSituation extension for the state of dress during weighing.

In this tutorial, we’ll go over mapping of a growth chart template that consists of the following archetypes:

  • openEHR-EHR-COMPOSITION.growth_chart.v0

  • openEHR-EHR-OBSERVATION.body_weight.v2

  • openEHR-EHR-OBSERVATION.height.v2

  • openEHR-EHR-OBSERVATION.body_mass_index.v2

  • openEHR-EHR-OBSERVATION.head_circumference.v1

Concepts you’ll get familiarized after completing this tutorial are:

  • how to prepare a state of the openFHIR Engine

  • how to run a mapping

  • how to edit a mapping and how this reflects in change of the output

  • how to use inline terminology mapping

  • how to use complex (ConceptMap) terminology service