In this second video in the mapping sets series, we demonstrate modifying existing mapping sets and creating new ones.

This is the second video of a three-part series about mapping sets. You can find the other videos of this series at

You might also be interested in our other videos about mapping:

Once you’ve seen the video, you can find additional documentation at:



This is the second video of the series about working with mapping sets. Today we will focus on making modifications to existing mappings and creating a new mapping set.

Let’s start with modifying this mapping set here. There are two mappings here that are incorrect: this one and this one. This one is a mapping from SNOMED CT to ATC and this is from SNOMED CT to a local code system. Let’s change the target. To do this, I just highlight the line, right-click it to bring up the context menu and then select “Remove target of selected mapping.” I could also remove the entire mapping, which would mean that the source and the target would be removed so the mapping would be completely gone or I could inactivate a mapping this way, but now I just want to remove this target here. See now it’s empty and I can find a new target in ATC. Let’s look for diclofenac, and I would like to have this code, so I just highlight the code in the view and then just simply drag it into the editor and now it’s mapped. It’s quite simple.

You could also just overwrite the content. I will show you with this one here:  “Restaurant manager” was also mapped to the wrong target and that’s from a local code system. So let’s go to local code system and look for “Restaurant manager.” Here it is already, so you can simply take the code and drag it into the editor and overwrite it. Since you’re changing content you’re supposed to confirm it: Yes, I want to change the mapping target. OK, and now it’s mapped to restaurant manager. So these are the two ways of changing the mapping.

Let me just show you how to inactivate one. Let’s inactivate this mapping: “Inactivate”, so now it’s gone because only the active mappings are shown and if I click the button here, that shows the inactive mappings, then it’s here again. We can also activate it the same way. OK and save the changes. Whenever there are unsaved changes you will see a little star here that shows that you should save.

We can also change the properties of a mapping set quite easily by simply adding content or overwriting content, so I could change the definition to “SNOMED CT to ATC, LOINC, LCS, ICD-10” and then save this change again. These three fields here are mandatory so if you’re trying to remove the content, you will get an error so it’s validated that you have these three mandatory fields, the other ones are optional. You can also inactivate an entire mapping set here by selecting “Inactive” from the drop-down menu. So much about changing existing content.

Now, let’s create a new mapping set, which I can do down here in the view. This button brings up the wizard where I have to specify the mandatory fields. If you wanted to create a mapping set in a particular folder you can also just go to the folder right-click and “Add new mapping set” and then it will be located in this folder. Let’s create one that is called “Diabetes” and it should be an “ICD-10 to SNOMED CT” mapping and the source is B2i Healthcare, Finish, OK and here is the new mapping set in the folder that I selected. The new mapping set is empty, so you can now enter a source term and then find a target or you can just enter all of the source terms first and do the mapping later.

Let me show you how you enter some terms. So let’s look for (this is ICD-10) “diabetes” and add a member just by simply selecting it and dragging it into the mapping set editor. This also works with the context menu where you can just add the selected concept or you can also add a whole part of the branch, so if I wanted to add all of these, I could do that.

Another option is to use the advanced search, which would be here for ICD-10.

Let’s look for “diabetes” and see what comes up. Now I have all search results down here in the search view and I could just take one and drag it up in here. This is actually one that is already there. This is why I get this information so you can’t add the same term twice.

I could also press the Ctrl (WIndows) or the Cmd button (on Mac) and then select several results and then move them in. With Ctrl+A or Cmd+A you select all of these 23 results that have found here and then just drag them into the mapping set, two of them are already there. OK, now I have my 23 members and I can start mapping. This works pretty much the same as I already showed you. I need to go to SNOMED CT view. By the way you can just move these views wherever you want to, this is why I have the SNOMED CT view on the right side because it’s a bit more convenient, so you can customize it the way you want. Let’s look for the first term, which would be “Abnormal glucose tolerance test.” Here is already the term that I’m looking for.

If you wanted to take a closer look at this concept, just double-click it. This opens the editor where you can see all the information about it. So you can verify that this is indeed what you’re looking for. You can see where it’s located within the hierarchy and then you just take the term and you move it into the empty spot. You don’t have to do this in the given order. You can also map this one and I just move it in here. You just have to make sure you select the correct line. When you have this circle around the line then you know this is where it’s dropped. OK and then once you’re done, you just save the mapping set and that’s it.

In the next video I will talk about how you can export and import mapping sets and how you can version them. Thank you very much for your attention. Bye-bye.