Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titleIn this page:

This page provides instructions for creating concepts to your SNOMED CT extension using Simplex. The process is initiated by exploring the SNOMED CT browser, and identifying the proper parent for your concept. Then editing the spreadsheet with the details about your new concept, including the addition of relevant synonyms. Finally, uploading the spreadsheet into simplex, and checking that the concept has been created as intended. Review this video to see how this is done step by step.

Prerequisite steps: 


Step-by-step instructions

1. Click "Artifacts"

First, navigate to the extension artifacts manager area in Simplex.

Click 'Artifacts'

2. Click "Simple extension concepts"

Here, you'll notice that some concepts have already been added. These include the metadata concepts required to represent the extension plus any derivatives you have added. To view the concepts, and the details for managing these, click "Simple extension concepts".

Click 'Simple extension concepts'

3. View concepts

Now, you see the concepts currently included in your extension to the right of the screen. Notice how you see the concepts naming and identifying the derivatives you have created. You will also find your module concept.

View concepts

4. Click "Download"

To create a new concept for your extension, the first thing you need to do is to download the spreadsheet with the details about the concepts in your extension. Click the download button to the right of step 1 in the process description below the concepts.

Click 'Download'

5. Access browser

Before editing the spreadsheet you just downloaded, you need to make sure that you know the details of the parent concept of your new extension concept. Therefore, go to your extension browser. You can do this by following the link next to any of your extension concepts

Access browser

6. Search to find appropriate parent concept

In the browser, do a search for the concept that should be the parent of your extension concept. In this example, I want to create a concept representing a local procedure on the respiratory system. So, the parent I want is the concept procedure on respiratory system.

Search to find appropriate parent concept

7. Click "Copy FSN and Concept ID"

Once you've identified the appropriate parent concept for your new extension concept, copy the conceptId and a term for the parent concept.

Click 'Copy FSN and Concept ID'

8. Open spreadsheet

Now, open the spreadsheet with the extension concepts you downloaded earlier in your preferred spreadsheet editor. Bear in mind that you should be able to save the spreadsheet in Excel format after editing.

Open spreadsheet

9. View the structure of the spreadsheet

This is the spreadsheet in which you apply all the information required to create your extension concepts. The first row includes some instructions helping you to add the necessary information correctly. Notice how the first two columns include the concept identifier and the terms for the parent concepts.

View the structure of the spreadsheet

10. Enter ConeptId and term for the parent concept

In the first column, enter the conceptId for the parent concept, and in the second column, add the term for the parent concept. Notice that each extension concept created in Simplex can only have one parent.

Enter ConeptId and term for the parent concept

11. Omit column C and D

As you are creating a new concept for your extension, you should ignore columns C and D, which are used to hold the identifier for the concept and the active state. When uploading the spreadsheet into Simplex, it will generate an identifier for your concept and assign it the status of active.

Omit column C and D

12. Navigate to column E and F

Having provided the details about the parent concept, navigate to column E and F to apply the terms for the new extension concept. Column E is for terms in English and the US-English dialect. Column F is for terms in your local language or dialect.

Navigate to column E and F

13. Enter the preferred term

In this example, I am only going to create terms in English. In the same row as the details for the parent concept, I enter the term that is going to be the preferred term

Enter the preferred term

14. Add synonyms

In the subsequent rows, you can add the synonyms you want for your concept. Please note that you don't need to add any values in column A to D

Add synonyms

15. Save and download spreadsheet

Once you have created your concepts and the related terms, you should save and download the spreadsheet in Excel format.

Save and download spreadsheet

16. Switch to Simplex

Once you have edited the spreadsheet with the details of your extension concepts, navigate back to simplex.

Switch to Simplex

17. Upload spreadsheet

Click the 'choose file' button in step 3 of the process and once the file has been selected, you click the 'upload data' button.

Upload spreadsheet

18. View new concept

Once the import has been performed, you can now see the concept in the list of extension concepts. In the case of multiple concepts, you may have to navigate to another page, to see them all.

View new concept

19. Click "Open in Browser"

You can click 'Open in Browser', to view the concept and its associated synonyms.

Click 'Open in Browser'

20. Review concept

In the browser, you can now see the concept appearing in the hierarchy as expected, with the parent you stated in the spreadsheet. You can also see the terms you stated as synonyms. Note that the concept has inherited the defining properties from its parent. In this example, the concept has a procedure site of 'Structure of respiratory system'

Review conceptThank you for watching this video.


Demonstration Video

HTML
<div style="position:relative;padding-bottom:56.25%;"> <iframe style="width:100%;height:100%;position:absolute;left:0px;top:0px" src="https://embed.app.guidde.com/playbooks/4JwtTbgFa71As9o5VhGXDR" title="Create new concepts in Simplex" frameborder="0" referrerpolicy="unsafe-url" allowfullscreen="true" allow="clipboard-write" sandbox="allow-popups allow-popups-to-escape-sandbox allow-scripts allow-forms allow-same-origin allow-presentation"></iframe> </div>
<p style="display: none">
00:00: This guide provides instructions for creating Concepts to your snomed

00:04: CT extension using simplex. The process is

00:08: initiated by exploring the snomed CT browser and identifying

00:12: the proper parent for your concept. Then editing the spreadsheet

00:16: with the details about your New Concept including the addition of relevant synonyms.

00:22: Finally uploading the spreadsheet into simplex and checking that the concept

00:26: has been created is intended. Review this video to see how this

00:30: is done step by step.

00:33: First navigate to the extension artifacts manager area and

00:37: Simplex.

00:39: Here you'll notice that some Concepts have already been added.

00:43: These include the metadata Concepts required to represent the extension Plus

00:47: any derivatives you have added. To view the concepts and

00:51: the details for managing these click simple extension Concepts.

00:56: Now you see the concepts currently included in your extension to the right

01:00: of the screen. Notice how you see the concepts naming and

01:04: identifying the derivatives you have created? You will also find your module

01:08: concept.

01:10: To create a new concept for your extension.

01:12: The first thing you need to do is to download the spreadsheet with the details about the

01:16: concepts in your extension. Click the download button to the right of

01:20: Step 1 in the process description below the concepts.

01:25: Before editing the spreadsheet you just downloaded you need to make sure that you

01:29: know, the details of the parent concept of your new extension concept.

01:33: Therefore go to your extension browser. You can do this by following

01:37: the link next to any of your extension Concepts.

01:42: In the browser do a search for the concept that should be the parent of your extension

01:46: concept. In this example.

01:48: I want to create a concept representing a local procedure on the respiratory

01:52: system. So the parent I want is the concept procedure

01:57: on respiratory system.

02:00: Once you've identified the appropriate parent concept for your new extension concept

02:04: copy the concept ID and a term for the parent concept.

02:09: Now open the spreadsheet with the extension Concepts you downloaded earlier

02:13: in your preferred spreadsheet editor. Bear in mind that you should be

02:17: able to save the spreadsheet in Excel format after editing.

02:22: This is the spreadsheet in which you apply all the information required to create your

02:26: extension Concepts. The first row includes some

02:30: instructions helping you to add the necessary information correctly.

02:34: Notice how the first two columns include the concept identifier and the terms for

02:38: the parent Concepts.

02:41: In the First Column enter the concept ID for the parent concept

02:45: and in the second column add the term for the parent concept.

02:49: Notice that each extension concept created in Simplex can only have one

02:53: parent.

02:55: As you are creating a New Concept for your extension, you should ignore columns

02:59: C and D which are used to hold the identifier for the concept and the active

03:03: state. When uploading the spreadsheet into Simplex, it

03:07: will generate an identifier for your concept and assign at the status of active.

03:13: Having provided the details about the parent concept navigate to column

03:17: enf to apply the terms for the new extension concept.

03:21: Column e is for terms in English in the US English dialect.

03:26: Column F is for terms in your local language or dialect.

03:31: In this example. I am only going to create terms in English.

03:35: In the same row as the details for the parent concept I enter the term that

03:39: is going to be the preferred term.

03:42: In the subsequent rows you can add the synonyms you want for your concept? Please

03:47: note that you don't need to add any values in column a to d.

03:52: Once you have created your Concepts in the related terms, you should save

03:56: and download the spreadsheet in Excel format.

04:00: Once you have edited the sheet with the details of your extension Concepts navigate

04:05: back to simplex.

04:07: Click the choose file button in step 3 of the process and once the

04:11: file has been selected you click the upload data button.

04:16: Once the import has been performed. You can now see the concept in the list

04:20: of extension Concepts. In the case of multiple Concepts,

04:24: you may have to navigate to another page to see them all.

04:29: You can click open in browser to view the concept and its Associated synonyms.

04:35: In the browser, you can now see the concept appearing in the hierarchy is expected

04:39: with the parent you stated in the spreadsheet.

04:43: You can also see the terms you stated as synonyms.

04:46: Note that the concept has inherited the defining properties from its parent.

04:51: In this example, the concept has a procedure site of structure of respiratory

04:55: system.

04:58: Thank you for watching this video.

</p>