It is possible to import a map file in one of two ways:

  1. During the map creation process
  2. From the view screen of an existing map

This page explains the expected map file format, and the two import approaches.

Import Map File Format

An existing mapping file used to import a map into Snap2SNOMED must:

  • Be a CSV or TSV file
  • Have a header row
  • Be in one of the following formats
    • source_code, target_code, target_display, relationship_type
    • source_code, source_display, target_code, target_display, relationship_type
      • Note: This second format is the same as Snap2SNOMED's Export file format

Relationship type values in the map import file must be one of the following codes (from the first column of the table below):

Relationship Type CodesDescription
TARGET_EQUIVALENTTarget is equivalent to source
TARGET_INEXACTTarget is inexact to source
TARGET_BROADERTarget is broader than source
TARGET_NARROWERTarget is narrower than source

Import during map creation

You can import an existing map using the "Create map" dialogue. The "Import existing map" button will appear after uploading and/or selecting your source file.

Note: Large maps can take long to import, please do not refresh your browser while the import is running.

If there is an error in your imported map file, the import will fail, but a map with only the source code will be created. After correcting any errors, you can attempt to re-import your map file from within the new map (see 'Import into an existing map' below.

Import into an existing map

To import a map file into a map that has already been created in Snap2SNOMED, open/view the map, and click the IMPORT button near the top of the page (see screen shot below).

Associated FAQ's

If you import an existing map and some of the map targets contain errors, e.g. if some of the concepts are inactive, or not available in the selected Edition, ta red flag will show for the involved map records (see image below). 

Within the authoring task, you can see, in the Target properties section, that the concept is inactive.

The system checks for duplicate source code pairs and an import error occurs if two rows in the source code set contain the same code. An example of this is shown in the image below.

  • No labels