The term 'map' is used to describe the instructions to convert from source/s to target/s. There are 2 representations
of this map.
The 'mapping file' is the textual representation of the instructions. It is created by the designer using a tool
such as this one, and is intended to be portable across engines
The StructureMap resource which is created from the mapping file using the $convert operation (in this implementation - other architectures are possible).
There are many ways that you can create these maps - here is on process
Create a sample of the input file as a Json file in your favourite editor. (It can be modified in the app,
but it's easier to start with an existing file.
Optionally (but preferably) create a Logical Model that describes the structure of this input file. Having such
a model enables some of the features of the mapping engine. Use the clinFHIR Logical Modeller or Firely Forge tool for this.
The file needs to be stored on the mapping server (as a StructureDefinition resource) and you'll need to add the url to
the mapping file.
Create the terminology resources (ValueSet, CodeSystem, ConceptMap) that are needed for the transform.
Create a new map, giving it an id, name and description using the 'New Map' button in the navbar. Don't select the
'sample' checkbox or from a library
Paste the contents of the example input file into the 'Sample Input' text area. When the map is updated (a button
appears when either the example or map is changed) the example is saved in an extension on the map.
Create the transformation map by entering the contents into the 'Mapping' text area. You'll need to save the map (which
generates the StructureMap resource) before executing the transform. A button will appear to the top right whenever there
are changes to be saved.
Execute the map against the example input by clicking the 'Execute Transform' button. This will call the $transform
operation on the mapping server and will display the output at the bottom of the screen in a number of different formats
You can continue to modify both the map and the example any number of times. Both will be saved (as extensions) whenever
the StructureMap is updated.