Page Comparison

Description

Reference terms map concepts to standard OpenMRS dictionary concepts.  

Steps

Below are the steps to manage the concept reference terms.

1. Go to "Administration→Manage Concept Sources" and check whether you have the required dictionary added as concept source (check the below screenshot)
   
   Image Added
   
   
   
   
2. If it is not there, create a new one using "Add New Concept Source"
   
   
   Image Added
   
   
   
   
3. The name and description are mandatory fields. They are free text entry fields and they do not expect any predefined values.
   
   Image Added
   
   
   
4. After creating the concept source, create the concept reference terms. You can go to that page using "Administration→ Manage Concept Reference Terms" navigation.
   
   Image Added
   
   
   
   
5. You can add a new reference term or search for the existing reference terms and edit them.
   
   Image Added
   
6. You need to provide some key as reference term code and select the source type as it's required. You can also have other reference terms mapped to a reference term.
   
   Image Added
   
   
7. Once you have the reference term created, you can map it to any concept using "Mappings" option. You can add multiple mappings for a concept.
   
   Image Added
   
   
   
8. You just need to start typing the reference term code and the respective source will be auto-selected. Note that you can manually select the mapping relationship (like SAME-AS, NARROWER-THAN etc) and these are not configurable from the UI. 
   
   Image Added
   
   
9. You can also create a new reference term from the edit concept page on the fly as well (see the highlighted button in the above screenshot).
   
   Image Added
   
   
10. Once you add the reference terms, they will start appearing in the respective concept page in OpenMRS. A sample concept with reference terms screenshot attached below.
    
    Image Added