Migrate Concepts and Concept Sets

Purpose and Benefits

Bahmni supports import of concepts via CSV files. There are two types of data you can create via CSV import:

Concept
Concept Set.

With Concept Set import, multiple Concepts or Concept Sets can be grouped under a parent concept.

Note

From v0.90 Bahmni, We are supporting the CSV import of special characters/non-english characters. This is done as part of this Jira card.

Types of CSV Imports

Bahmni has different CSV formats for import of Concepts and Concept Sets. For each type of import we have attached a sample file with some example rows.

1. Concept

New concepts can be created by uploading a concepts.csv file containing the below mentioned fields:

Key	Use	Mandatory
uuid	Concept will created with this uuid	Y
name	Name of the Concept	Y
description		N
class	Class can be Misc/Abnormal depending on the concept type.	Y
shortname	Bahmni will use shortname while showing the concept.	Y
datatype	Datatype can be Numeric/Boolean/Coded or N/A	Y
units	Can mention for Numeric datatype	N
High Normal	Can mention for Numeric datatype	N
Low Normal	Can mention for Numeric datatype	N
locale		N
synonym.1		N
answer.1/2/3	Should be the fully specified name of concept. The datatype should be Coded.	N
reference-term-source		N
reference-term-code		N
reference-term-relationship		N

Before putting a Concept value in answer(s) section make sure that the Concept already exists in the system. If not, then put a row/section before the parent Concept row in CSV. This is done to ensure that the child Concept information gets imported before the parent Concept is imported. Otherwise, the parent Concept will not be able to refer to a non-existent child Concept.

2. Concept Set

New concept set can be created by uploading the concept_sets.csv and filling up the below fields:

Key	Use	Mandatory
uuid	Concept-Set will created with this uuid	Y
name	Name of the Concept-Set	Y
description		N
class	Class can be Misc/Concept Details depending on the concept-set type.	Y
shortname	Bahmni will use shortname while showing the concept-set	Y
child.1/2/3/4	Should be the fully specified name of concept or concept-set.	Y
reference-term-source		N
reference-term-code		N
reference-term-relationship		N

Before putting a Concept or Concepts or Concept Set as child make sure that the Concept(s) or Concept Set(s) already exists in the system. If not, then put a row/section before the parent Concept Set row in CSV. This is done to ensure that the child Concept Set information gets imported before the parent Concept Set is imported. Otherwise, the parent Concept Set will not be able to refer to a non-existent child Concept.

Also, it is suggested to import all Concepts first, and then import Concept Sets, since sets cannot refer to non-existent concepts.

On this Page

Other Types of Data Migration

Feature Details

Configure CSV Import - Feature Guide

Usage Details

Configure CSV Import - Implementer's Guide

Bahmni Wiki

Migrate Concepts and Concept Sets

Analytics

Purpose and Benefits

Types of CSV Imports

1. Concept

2. Concept Set

Related content