Versions Compared

Key

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

...

  1. Source Concept Details Panel
    1. Displays the source terminology, concept id, and concept name.
    2. If the source terminology is SNOMEDCT, a blue information icon is displayed.  Clicking this opens the SNOMEDCT Concept Browser
    3. If the destination terminology is ICD10 (or another terminology with loaded indexes), a blue book icon is displayed.  Clicking this opens the Index Viewer.

  2. Map Group and Map Entries Panel
    1. Displays a summary current map entries attached to the record, sorted by group.  The entry currently being edited is highlighted in green.
    2. To add a map group or entry, click the Add Entry/Group buttons.
    3. Entries and groups can be deleted by clicking the "x" icon attached to the desired element.  Note that deleting a group will also delete all of its entries.
    4. Entries and groups can be reordered by drag-and-drop.

      An example of multiple groups and entries is shown below, with the current entry highlighted in green.

       
  3. Map Notes Panel
    1. Displays any notes currently attached to the record.  Notes can be deleted by clicking the "x" icon on the desired note.
    2. To add notes to the record, enter some text into the rich text editor and click "Add Note".
    3. Note can be entered directly or copied and pasted from external sources such as websites or MS Word documents, with formatting preserved.  This editor supports the following elements:
      1. Basic formatting (bold, italics, underline)
      2. HTML elements (e.g. <p>, <div>, anchor tags, hyperlinks)
      3. HTML image elements hosted on another website/server

      A sample note is shown below.



  4. Map Principles Panel
    1. Displays any principles currently attached to the record.  Principles can be deleted by clicking the "x" icon on the desired note.
    2. Principles can be added from the drop-down box, with displayed principles taken from the hyperlinked document.

      An example of an applied principle is shown below.

       
  5. Flags Panel
    1. To flag a record for review, simply click the checkbox.
    2. The three currently supported flags are Consensus Review, Editorial Review, and Lead Review.

  6. Feedback Panel
    1. Displays any communication between the user and anyone else involved in a discussion about this record.
    2. To submit new Feedback to one or more leads attached to the project, enter text and click "Send Feedback".
    3. Feedback can be formatted in the same ways Map Notes can (see #3)

  7. Record Summary Widget:  Displays a summary of the current state of the record as edited.

  8. Target Panel:
    1. Displays the currently selected target code and Preferred Term for the selected map entry (highlighted in green in #2)
    2. To change the target, enter the target code into the text box and click "Set Target".
    3. If the entry has no target, this must be explicitly indicated by clicking "Set Empty Target" when the text box is empty

  9. Mapping Parameters Panel:
    1. Displays the map relation, map advices, and map rule for the selected map entry (highlighted in green in #2)
    2. Only those parameters appropriate to the current project are displayed.  For example, if the project is not rule-based, the "Rule" row and button will not appear.
    3. If map relations are available for this project and selected target, a drop-down menu will appear with those relations valid for assignment.

      An example of an assigned relation with drop-down options is shown below.

    4. To set the rule (for a rule-based project), click the "Set Rule" button.  A modal pop-up will prompt for the Rule Category and any required parameters.  Click "Add Rule" to finish setting the rule.

      An example of using the Rule Constructor to set a chronological age requirement is shown below.

    5. If Map Advices are available for this project and selected target, a drop-down picklist will appear with those advices valid for assignment.  Advice can be added by simply selecting the desired item in the drop-down box.  Advice can be removed by clicking the "x" icon on the displayed advice values.

      An example of advices attached to the entry is shown below.

  10. Terminology Browser Panel
    1. Displays a nested-tree structure representing the target terminology.
    2. The terminology browser has three major components, which are marked in the screenshot below.
      1. Search Tools
        1. To perform a search, enter text and hit Enter or "Search".  The tree will change to reflect only those nodes (and parents) that match the search terms.
        2. To reset the search, hit "Reset".  The tree will revert to the full top-level hierarchy for the terminology.
        3. Searches are remembered for each session;  to go forward or back use the arrow buttons.
      2. Tree Node Controls
        1. If a target code has children, toggle display of those children with the arrowhead button preceding the target code.
        2. If a target code does not have children, it is a leaf node and a leaf icon will appear.
        3. If a target code has additional information (e.g. inclusions, exclusions), toggle display of that information with the blue information icon.
        4. If a target code is valid for assignment, assign this entry to the current entry (see #2, #8).
      3. Information Panel:  Displays any relevant information for this target code.  Depending on the target terminology, may contain clickable links to other target codes or code ranges.  Clicking these links will perform a new search based on the linked content.
    3. An example of a search for "cholera" performed in the Terminology Browser for ICD10 is shown below.

       

Anchor

...

finishingWorkFromDashboard

...

finishingWorkFromDashboard

Finishing assigned work from the dashboard

...

From the Main Dashboard, this widget displays feedback and conversation status for mapping work.

 

The main components of the Feedback widget, as labeled on the screenshot, are:

...

Accessed from the Feedback widget, this feature displays the full history of a conversation surrounding mapping a concept.   

Image Added

The main components of the Feedback Conversations widget are, as labeled in the screenshot:

  1. A summary of the map record being discussed..
  2. The comments left by individuals participating in the conversation.
  3. The rich text editor where new comments can be edited.  See Map Record Notes for further details on this editor.
  4. The recipients list
    1. Displays the number of recipients who will receive the new feedback.
    2. To add or remove users from the list, click the drop-down and select or deselect the desired recipients
  5. The general controls
    1. Mapped Concept View:  Opens the Concept Records page displaying all mappings for all viewable projects for this concept, including historical mappings.
    2. SNOMEDCT Browser:  Only displayed if the source terminology is SNOMEDCT.  Opens the SNOMEDCT Browser for this record's concept.
    3. Index Viewer:  Only displayed if an index viewer is available for this project's destination terminology.  Opens the index viewer for this project's destination terminology.
    4. Mark unviewed:

...

    1.  Check/uncheck this box to change the viewed status of this conversation.
    2. Mark resolved:  Check/uncheck to change the resolved status of this conversation.
    3. Send Feedback:  Click to submit the contents of the text editor as a new comment on this conversation.

1.

...

Anchor
indexViewer
indexViewer

Index Viewer

This feature provides access to any indexes available for a project's target terminology.  These indexes aide the mapper in finding a target id for a mapping given some search terms.  This feature is accessible from the book icon on the Map Records dashboard if the project has indexes available.  See below.  It is also available from the Feedback Conversation Dashboard and the Map Project widget.

 

Image Added

 

Upon opening, the Index Viewer will appear in a separate browser tab from the Mapping Tool. Displayed are the indexes for ICD10.

Image Added

Searches

Searches can be performed by typing text strings into the various search fields, followed by clicking on the 'Go' button.

Contextualized Term Searches

Searches begin by entering words intended to match the main terms of the index files. In the example below, "diabetes" is the initial main term search. To search within the main term results, the second search box can be populated. In this example, the sub-search term "pregnancy" is used. And finally, a sub-sub term search can be performed within the results of the first two fields. In this example, "fetus" is used.

Image Added

 

The first search box (1) searches only the main term level, the sub search box (2) to only the term level immediately below the main term level, and the sub-sub search box (3) to only the term level immediately below that one.

 

Special Searches

If you want to search by code instead of by term, the field prefix "code" can be used as in the example below, with the search "code:O03.9". Note, the same restrictions on the "level" of the search described above apply here too.

Image Added

If you want to find search results that are known to start with a particular word, you can use the field prefix "s" as in the example below, with the search "s:diabetes". If you try searching just "diabetes" you will note there are a many more results spread across the various lettered tabs.

Image Added

When clicking on a linked entry in one of the tabs, it attempts to construct a matching search to find the corresponding results. Note - due to inconsistencies in the representation and other data quality issues it is not always possible to find a matching entry. And in some cases, the linked strings have more than three parts and the search only supports three parts. In these cases an appropriate notification message will be displayed. Use this feature where appropriate but realize that it may require additional manual intervention.

Image AddedTODO

  • n/a