Cloning of Concepts and Adding Them to a Collection

When a concept is close but not an exact match for your needs, you may need to refine it to better align with your requirements. For instance, if you come across a concept in CIEL or another source that closely matches what you're looking for but requires some modifications, you can use the "Clone to Source" option. This feature allows you to create a copy of the concept within your source enabling you to customize it as needed.

In the example below, we’ll explore how to clone the "Smoking Status" concept to add a new answer, "Passive Smoker," which is not included in the original CIEL concept.

1. Type "smoking status" in the global search.

2. Use the filter to return CIEL concepts.

3. Use the checkbox adjacent to the concepts to explore the most probable result you are looking for.

4. Review the details of that concept by checking it's class, datatype, associations etc.

5. If you are satisfied that this is the concept you want, click on "Clone to Source."

6. Add this concept to your source (Mini Demo Source).

This operation will clone the selected concept(s), plus any answers or set members recursively following specified mappings.

7. Click on "Preview" to view the details of concepts and mappings that will be added to your source.

8. Here are the details once you click on "Preview".

9. Click on ← BACK

10. Click on "ADD" to add copies of the concepts to the mini-demo-source.

11. After the success message appears and the results of copies added, Click on CLOSE.

12. Go back to the mini-demo-source.

13. Verify that the "smoking status" concept and its associated answers have been added.

• Note that these are no longer CIEL concepts; they are owned by the organization or source that created them.

• Now you are in a position to customize this concept to suit your needs.

14. To tweak the "Smoking Status" concept, navigate to "Manage Content".

15. Click on "Add Concept".

16. Add the Concept Class (in this case Finding).

17. Add the Datatype (in this case N/A).

18. Add the Locale (in this case English).

19. Add the Type (in this Fully Specified).

20. Check "Preferred"

21. Type the name of the new concept you are adding (in this case "Passive Smoker").

22. Click on CREATE to finish creating the new concept.

23. When you review the concepts in your source, you'll find the newly added concept included.

24. The next step is to add this mapping as an answer to the concept "Smoking Status".

25. Click on the checkbox adjacent to the "Smoking Status" concept and then click the "ADD NEW MAPPING +" button.

26. Set the relationship type to Q&A (which represents a question-answer relationship).

27. Click on Mini Demo Source as the "Source".

28. Search for the newly added concept (i.e."Passive Smoker").

29. Click on SAVE to finish adding this "Passive Smoker" mapping/answer

30. Verify that the "Smoking Status" answers now include this new concept (Passive Smoker).

31. Verify that the "Smoking Status" answers now includes this new concept (Passive Smoker).

32. Add the cloned concept (in the source) to the collection, click "Add to Collection".

33. Click on Mini Demo Collection.

34. Select Yes, apply OpenMRS-compatible cascade.

35. Click on ADD.

36. Go back to the "User Collections".

37. Click on mini-demo collection

38. Confirm that the "smoking status" concept has been added successfully.

39. Check that the answers include the newly added answer-concept "Passive Smoker"

40. Note that the source of this concept is no longer CIEL BUT "mini-demo-source".