FAQ

FAQ

 

 

 

https://snomed.atlassian.net/wiki/display/ISUG/Reviewing+and+Feedback#ReviewingandFeedback-SubmittingaTaskforReview

AREA

Question

Answer

REF

NOTE

AREA

Question

Answer

REF

NOTE

1

Access

How do I access SCA

Production Environment is here https://authoring.ihtsdotools.org/#/home

 

 

2

Testing

Will we always have a testing environment after we go live?

Yes User Acceptance Testing can be done here in UAT https://uat-authoring.ihtsdotools.org/#/home

 

 

3

Help

How do I get assistance or ask a question?

Reporting issues - please continue to use the FEEDBACK button on Production and UAT

General Help Me - Please send an email to the techsupport@ihtsdo.org

Specific -Need Project Added or a Task Deleted -Please send an email to techsupport@ihtsdo.org 

 

 

4

Task

How do I unclaim a task that I no longer want to review

Please see: Cancelling a review

 

 

5

Editing

How do I add concepts with stated relationships to a task from the dialog window when editing?

If you want to save a concept into the Saved List from search results, you can click the 'add' button

 to add the concept into the Saved List. After the concept is added, the 'add' button is disabled 
, so you can't add the same concept into the Saved List twice.

Edit a Concept From the Saved List: To load a concept from the saved list into the edit panel click the 'edit button' 

 to the right of the concept you wish to add.

 

 

6

Retire

How do I retire a concept that is being used as a stated parent?

You need to confirm the inactivation. Start by clicking the inactivation button in the editors dialog box (popup window). This dialog has tabs that list the children and the descendants of the selected concept. The "Incoming relationships" tab shows all the destination relationships that would be affected by the inactivation. You will need to do a replacement/substitution for any concepts that may be affected by the change. Once the replacement/substitution is completed you can retire the concept.

 

How do we handle inactivation of concepts that are used as parents?

Automation not implemented

7

Inactivate

How do I inactivate a concept that is being used as an inferred parent?

 

We cannot retire anything assigned by the classifier. The solution is to identify which attribute is improperly assigned which is causing the inference, then amend/correct the modelling. (MH response)

How do we handle inactivation of concepts that are used as parents?

Automation not implemented

8

Merge

How will we deal with content merge conflicts?

The Terminology server will attempt to merge content changes automatically but it can't always do this and any 'conflicts' will be reported back from the merge operation. At this point the author is required to resolve the conflict. See: Rebase Task - Pull in Changes From Project

How will we deal with content merge conflicts?

 

9

Promoting

Is it possible to promote a task before having it reviewed, running classification, or running verification.

Yes, there are no restrictions on preventing an Author from skipping best authoring practices.

Caution -Validation should be done before promotion. 

Caution --Promoting content which has not been classified can lead to unexpected classification results in other author's tasks.

See: Promotion FAQ

Is a classification mandatory before a validation/promotion?

 

10

Promoting

Is it possible to promote a task without running a classification 

Yes, there are no restrictions on preventing an Author from skipping best authoring practices

Caution -Promoting content which has not been classified can lead to unexpected classification results in other author's tasks.

Is a classification mandatory before a validation/promotion?

 

11

Promoting

Can I promote a task without it being reviewed?

Yes, there are no restrictions on preventing an Author from skipping best authoring practices

 

Is a review always mandatory before promotion?

 

12

Review

How do I submit a concept to be reviewed?

Click here Reviewing and Feedback#SubmittingaTaskforReview

 

 

13

Review

How do I review or claim a concept?

Click here Reviewing and Feedback#ReviewinganAuthoringTask

 

 

14

Feedback

How do I provide Feedback?

Click here Reviewing and Feedback#ViewingandRespondingtoFeedbackfromaReview

 

 

15

Review

How do I add a reviewer?

All Authors will be assigned to all projects. All authors will have the same "rights" so there is no distinguishing between the ability of someone who is editing a concept, lead on a project or someone who is preparing all content for a release. You do not need to add a reviewer all authors will be able to access your tasks that need to be reviewed.

 

 

16

Re-baseline

How do I know if I need to re-baseline? 

See: Rebase Task - Pull in Changes From Project

Reviewing and Feedback#MarkingaTaskasReviewComplete

 

17

Classification

How do I run the classifier before reviewing to ensure that the reviewer is seeing the most current content and relationships?

See: Classification

Reviewing and Feedback#MarkingaTaskasReviewComplete

 

18

Review

What does moving the concept to the "Concept Reviewed List" signify?

Within the review view a reviewer is not obligated to provide feedback on a concept. The purpose of the Concept Reviewed is to move concepts that a user does not desire to provide feedback on. The thought behind this is that all feedback is then only for concepts that require action or discussion. Moving a concept to the concept review list does not signify any specific status. * note this will change with the redesign of review and feedback

Reviewing and Feedback#MarkingaTaskasReviewComplete

 

19

Validation

What does validation do or check?

Validation runs the Release Validation Framework which checks the following assertions -

Assertions Validated for the SNOMED CT International Edition#ComponentCentricValidation

 

 

20

Search

What search functionality is available,i.e. exact matching with quotes, + for required, etc? Filter by semantic tag?

You can use wildcards in the search term to find partial matches. Asterisk ( * ) matches all subsequent characters regardless of word length. Question mark ( ? ) matches a single character. For example:

punc* would find all words stemmed with "punc" eg punch, punched, punctum, puncture etc
punc? would find punch
punc??? would find punched and punctum
punc?u? would find punctum but not punched

 

 

21

Search

What is Grouped by concept ?- it isn't clear to me what is being grouped?  Descriptions? Subtypes?

Grouping by concepts vs all view matching terms is similar to search functionality on many websites sites allowing a user to search titles and descriptions or just titles. The same theory is applied here and that if multiple terms matching your query are found you can toggle the search results to display the top level concept (so if your query matches multiple components of a relationship it will only return one result), or you can view all matching terms.

 

 

22

Taxonomy

 

How does the Taxonomy display multiple parents?

The taxonomy displays as follows:

 

 

23

Views

How do I tell if this the inferred view or stated?

There is a blue circle at the top of the screen which indicates what view you are looking at.

 

 

24

Search

Can we search for active concepts only?

Search is now defaulted to Active concepts only.

To view both active and inactive concepts click the "Active And Inactive" Button within the search results.

 

 

25

Search

How do I search for Concept IDs?

Entering a concept ID into the search should return the relevant concept

 

 

26

Taxonomy

How do I search in Taxonomy

Steps

Reference

Currently the taxonomy does not have a search bar above it, however if you search for a concept you may lookup the concept in the taxonomy by clicking the 

Lookup in Taxonomy button.

 

 

27

Taxonomy

How do I create or modify a concept by using the Taxonomy feature?

See Create New / Clone Existing Concept

 

 

28

Promotion

What happens or needs to happen after promotion to make merge the content into the mainline and make the updates available to our users.

Once all tasks are promoted in each project, The Authoring release manager would approve the projects for inclusion into the release. Updates for the users will be available through a report generated by Confluence indicating the status.

 

 

29

Approve

How do we approve a concept after we have selected and reviewed it

Use Case -Penni edited, I claimed and reviewed then she got it back. She then had to rebase, and then does Penni promote and is that the same as approving. Or is my reviewed = to approving.

Reviewed is not = to approving only promotion = approved

 

 

30

Promotion

How do I promote an individual task that is in a state of "promoted" without promoting all of the tasks in that state? In other words I need to be able to select a task to promote with project.

You can not promote an individual task. When promoting a project, you promote all tasks in the promoted state as they are all completed and ready for promotion to the release..

 

 

31

Project

My Projects list does not display lead information

If project information changes during a user's session, this information will be stale. Highly unusual occurrence, and workaround exists (simply reload the app).

 

 

32

Editing

There are Inadvertent changes being made to the concept I am trying to copy and paste from? Why is this happening?

  • If a description or relationship is inadvertently dropped onto the same concept, it DOES NOT automatically save. Affirmative action is required by the user. If the "Save Concept" button is not clicked and the task is promoted, the concept that appears to be modified will be unchanged on the term-server.

  • The save button can be eliminated by using the "Revert concept" button to undo all changes and return the concept to the currently saved state on the term-server.

 

 

33

Task

Can a task be closed without going through the whole process (e.g. task created and found to be a duplicate - with appropriate processes in place here)?

There is no closed status on a Task, the user will have the ability to delete the task. This delete feature will be implemented by Dec 3.

 

 

34

Task

How are tasks assigned?

When a task is created it will have a status of "New" any user within the same role can pick up the task by clicking on the task name. This will assign the task to that user.

 

 

35

Task

Can tasks be re-assigned?

Currently the feature is not available within the tool. However the ability to change a task is available within JIRA which is the connecting backend for tasks. Contact the project lead for the project where the task needs to be re-assigned, if you are the project lead please contact TechSupport via freshdesk and we will assist

 

 

36

Task

Can I delete a task I created by mistake?

  • Project-level deletion

    • Go to Projects, select a Project with tasks, view the Tasks in Project

    • Click the gear icon to the right of a task

    • Modal appears, click Delete task

    • Modal closes, table updates with that task no longer shown

  • Task-level deletion

    • Click on a task from dashboard

    • Click Edit Task

    • Modal opens, click Delete task

    • Modal closes, application routes to dashboard, deleted task is no longer shown

 

 

37

Review

Something shouldn't be available for review if it has not passed "validation"

Classification or validation does not restrict the ability to review.

 

 

38

Project

How do I add people to a project?

There is not a specific UI interface within the new tool. If you need to add authors to a project you must  make that request via Freshdesk attend to Tech Support. All IHTSDO authors will have access to all projects as that has been the requirement request. The project lead role only signifies a point person for that project area.

 

 

39

Classification

Classification Report - Is it possible to sort by primary and secondary columns?

As it stands it is possible to replicate the functionality you're after by combining the search field (Which will cut the list down based upon the text you enter against target, source and type descriptions), and then ordering the filtered list using the column headers.

 

 

40

Editing

Parent and additional attributes not visible in Edit panel of Feedback/Review screen

Use Case

I picked up a concept for review and then clicked "Show in Edit Panel." The concept FSN and descriptions are visible, but not the isa relationship and any additional attribute-value relationships. Therefore I cannot fully review the concept and change made to it.

The change that the author has made to the concept is likely inactivation. In this case all of the concepts relationships are also inactivated. By default inactive relationships are not displayed in the edit panel. If you click the down arrow in the header you will be able to view these inactive relationships

 

 

41

Editing

In order to fully define a concept, I added a new Is-a relationship but I can't remove the existing Is-a relationship. There is no minus sign by it.

The new Is-a relationship has a minus sign as does the Has dose form attribute I added.

You cannot remove the is a relationship to Cephalosporin class of antibiotic (product) because it has already been published. This is why there is no minus button. In your use case the relationship would have to be inactivated by clicking the icon next to the relationship.

 

 

42

Browser

The TS browser requires username and password. I am also not sure which username and password to use.

Login and password is snowowl & snowowl - The change for integration with SCA is a lower priority with the current objectives for completion.

 

 

43

Review

Where can I see the reason for an inactivation?

Click the three dots next to the concept

 

 

44

Editing

What do the case sensitive acronyms mean?

Based on discussion with the authors, the following abbreviations should be used to indicate the case significance.

  • cI for 900000000000020002|Only initial character case insensitive (core metadata concept)|

  • CS for 900000000000017005|Entire term case sensitive (core metadata concept)|

  • ci for 900000000000448009|Entire term case insensitive (core metadata concept)|

 

 

45

Classification

When I hover over the classification icon, it says "completed". Does that mean it has been accepted? If not, then it shouldn't be up for review - correct?

The tooltip does not indicate if the classification results were accepted or not. It simply shows that a classification report exists for this task. When you click on the icon, you can review the report.

If the classification icon is red, the report could not be retrieved for some reason, this is unrelated to your editing. In this case you should try to run the classification again

 

 

46

Editing

How do I delete a concept

You can only delete an unpublished concept

1.If a user creates a new concept that they have not saved, but wish to delete they may do so by clicking the 

  in the concept's title bar.


2. The ui will display a warning to advise the user that their work will be deleted, selecting Okay continues with removing the concept. 

 

 

47

Tasks and Promotion

After I promote a project  the tasks get promoted but the project remains and I can add new tasks?

Yes

 

 

48

Classification

Why is the Save button not available for my completed Classification?

The save button will not be activated if the classification resulted in no changes to inferred relationships. This might happen if you make changes, run and save a classification and then classify again.

 

 

49

Classification Reports

What does the classification report show?

Once you accept a classification, the new report shows only the changed made between the previous classification and the new one.

 

 

50

Project Status

What does "forward" mean?

If the project is FORWARD you can go ahead and promote your project. As there is no need to rebase, this button is disabled. FORWARD indicates that the content on your project is "ahead" of the content on the mainline, so there is new content on your project that is not on mainline yet. This is the best case scenario.

After project promotion, your project status will change to UP-TO-DATE. This means that the content on your project is now the same as the content on the mainline. As there is no content to promote, and no need to rebase, both buttons are disabled.

You have to rebase if the status is BEHIND or DIVERGED. To avoid mistakes, we restricted the workflow so that you can only promote if you have rebased.

  • If someone else promotes a project, your project status will change to BEHIND. This means that there is content on the mainline that is not reflected in your project yet.

  • DIVERGED means that your project and the mainline do have different content. For example, if you promote a task to your project and someone else promotes their project to the mainline.

Copyright © 2026, SNOMED International