https://confluence.ihtsdotools.org/display/ISUG/Reviewing+and+Feedback#ReviewingandFeedback-SubmittingaTaskforReview
No | 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 | ||||||
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 |
| ||||||
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? |
| ||||||
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? |
| ||||||
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 | ||||||
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.
| ||||||
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.
| ||||||
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.
| ||||||
51 | Review | What does the modified date reflect? | The modified date reflects that last change to the concept NOT the last time feedback was left | ||||||
52 | Classification | I am seeing results in the classification report that are not correct | If an author did not classify before promoting tasks, the results are showing up in the classification results for every other task on the branch. Once they are promoted, the only way to remove them from all other tasks is to rebase again, and rerun classification. Note- There is no 'blocking' but only a warning before promoting. It is up to the decision of the author to promote without classifying, or not. | ||||||
53 | Classification | I cannot find my classification report | Please see WRP-2044 | ||||||
54 | Editing -New Concepts needed as parents of new concepts | Cannot use newly created concepts as parents for new concepts in the same task | This is due to a constraint based on how the MRCM save validation works - MRCM rules currently apply to the inferred view, not stated. This means new content must be classified (and inferred relationships saved) before it is permitted as an attribute value in the concept edit panel. Attempting to add the parent before it is classified will trigger the MRCM validation rule, blocking the save action. The process is as follows: 2. Classify and save classification results. 3. Copy the new parent SCTID from the more details popup in the edit panel concept header. 3. Search for new parent by pasting the new SCTID into the Search tab. 4. Create new child concept. Add FSN, PT. 5. Drag the parent from the search list as a target into the new child concept empty Is A relationship. Save. Similar principles apply to other attributes - any new concepts must first be classified and the results saved before using as an attribute target. Currently the MRCM only allows you to save a concept if the attribute value is specified before the attribute type. The easiest is to add a new relationship that has no attribute type specified yet. A bit complicated but a workaround until the fix (WRP-2300) is implemented. | Please refer to WRP -2300 to ensure this work around is still needed. | |||||
55 | Editing | Can not add a valid attribute | This is due to a bug with the validation not working correctly that is addressed in WRP-2300. Please try to do it the following sequence, I could verify that it is working this way (see screenshot) If you specify the attribute type before the attribute value, the bug gives you the MRCM error, which prevents you from proceeding. In your screenshot the parent Disease (disorder) is not correctly specified. If you type "disease (disorder)", you have to wait until the concept is displayed in the drop-down list and then select it from there. If you just type disease in the text field without selecting from the drop-down list, it will not accept this as a valid target. Another option is to drag the concept from the saved list. | See ATF-517 for use case | |||||
56 | Taxonomy | Why can't I see the taxonomy view? | The taxonomy view is only available after accepting the results of the classification. It is only possible to preview the concept in the diagram, but not in the taxonomy. | ||||||
57 | Search Notification Error | When I am searching for concept I get this error? | Notification message for Error performing search[object Object] Not Found - When you open a task for the first time, the branch is created, which takes a few seconds. If you start searching during this time, you will get the error in the search as the latest version of SNOMED hasn't been completely loaded into your task -the system needs to catch up and will work in a few moments. | See WRP-2436 for status and ATF-505 for use case. | |||||
58 | Search | I want to enter digits in my search queries | For numeric values that aren't SCTIDs returning empty results, by entering the value as a string query enclosed in double quotes. For example, entering "101" (including the quotes) will return all concepts with the digits 101 in their descriptions. Wildcards can also be added, for example "101"* will return all concepts with numbers starting with the digit sequence101 in their definitions (eg 1011, 1013 etc). Results will also include concepts whose relationship values include the quoted string, for instance searching for "101"* showsHemoglobin Rush (substance) as the 8th result, which is actually matching its acceptable synonym Hb 101(G3), Glu-gln | Please refer to WRP-2582 for status of correction implementation |