All pages
Powered by GitBook
1 of 73

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Log in

How do I... ?

Provide Feedback

See my projects

Steps
References

EITHER (from anywhere in the application) Open the page header drop down menu and press My Projects in the overlaid menu options list.

OR (from any Dashboard view) Press My Projects in the Dashboard view left sidebar menu.

Task - Classification and Validation

How do I... ?

  • Classify my task changes (to generate inferred relationships)

  • Preview concept changes before saving classification results

  • Preview concrete domain attributes and values in classification results

  • Validate my task changes

Task - Rebase and Promotion

How do I... ?

  • Rebase my task from the project (synchronize with changes made in its parent project since task creation)

  • Promote my (non-complex) task changes to their parent project (share with other authors)

  • Promote my (complex) task changes to their parent project (share with other authors)

  • Promote my (batch) task changes to their parent project (share with other authors)

Open one of my tasks (open task as an Author)

Steps
References

Log in to the Managed Service Authoring Platform

Steps
References

See my tasks

Steps
References

How to...

Task - Batch

Dashboard

Create a new report and/or report category

In the current version this is achieved via service requests to the technical team.

You can use the form (or raise an INFRA devops support ticket directly in JIRA) to request a new report (either in an existing category, or requesting a new one), as done for AP issues and improvement requests.

This will be processed and prioritised along with other AP and RP feature/improvement requests for inclusion in a future release.

Request a new feature or improvement, or raise an issue for the Reporting Platform

In the current version this is achieved via service requests to the technical team.

You can use the form (or raise an INFRA devops support ticket directly in JIRA), as done for Authoring Platform (AP) issues and improvement requests, and noting the Reporting Platform (RP) in the form details.

Your request will be processed and prioritized along with other AP and RP feature/improvement requests for inclusion in a future release.

Task - Saved List

Preview concrete domain attributes and values in classification results

Steps
References

Log in to the International Authoring Platform

Steps
References

Task - Edit

Provide Feedback
Automatically Promote my task changes to their parent project (share with other authors)
Provide Feedback

How do I... ?

Update content via batch upload
Provide Feedback

Claim a task for review (open task as a Reviewer)

  • See my projects

  • See all projects

  • Create a new project

  • Search for tasks

  • Provide Feedback

    How do I... ?

    See my tasks
    Create a new task
    Open one of my tasks (open task as an Author)
    See tasks submitted for review (by other authors)
    Raise an Issue
    Provide Feedback
    Raise an Issue
    Provide Feedback

    How do I... ?

    Add a concept to my task Saved List and act on saved concepts
    Add a saved concept to the Project Favorites list and act on the listed concepts
    Provide Feedback
    Provide Feedback

    How do I... ?

    Edit a concept
    Create a new concept
    Add a General Concept Inclusion (GCI) to a concept
    Modify a General Concept Inclusion (GCI) in a concept

    OR In the My Tasks view, press the classification status icon (if present), on the task you want to open. This opens the Task View to the context of the current Classification report.

    Whilst loading, the main content panel is cleared, and a blue header notification stating "Loading task details..." is presented. When completed, the header notification changes to "Task details loaded".

    The Task Classification layout is presented, showing the latest Classification report. This is a full-width layout, maintaining the Options panel menu for navigation back to other task contexts.

    OR In the My Tasks view, press the validation status icon (if present), on the task you want to open. This opens the Task View to the context of the current Validation report.

    Whilst loading, the main content panel is cleared, and a blue header notification stating "Loading task details..." is presented. When completed, the header notification changes to "Task details loaded".

    The Task Validation layout is presented, showing the latest Validation Report. This is a full-width layout, maintaining the Options panel menu for navigation back to other task contexts.

    OR In the My Tasks view, press the feedback status icon (if present), on the task you want to open. This opens the Task View to the context of the Review and Feedback activity tab.

    Whilst loading, the main content panel is cleared, and a blue header notification stating "Loading task details..." is presented. When completed, the header notification changes to "Task details loaded". ,p>

    The Task Review and Feedback layout is presented, showing concepts to review, concepts approved, and inferred concept changes within the task. This layout maintains the Activities panel (Left Sidebar), as well as the Options panel menu for navigation back to other task contexts.

    Provide Feedback

    EITHER In the My Tasks view, press the name link on the task you want to open. This opens the Task View to the context of the default Task Editing layout.

    The Task View is presented with the default Task Editing layout, showing 4 key content regions below the site header:

    • Edit panel, showing concepts loaded or created within the task (initially empty for a new task).

    • Concept Model panel, showing a SNOMED CT schematic representation (in SNOMED CT Diagramming Guideline notation) of concepts in the Edit panel (initially empty for a new task).

    • Activities (Left Sidebar) panel, containing tabs for:

      • Taxonomy

      • Search

      • Saved List

      • Feedback

      • Create Batch

      • Task Details

    • Options menu panel, containing buttons for:

      • Create new concept

      • Create new concept from template

      • Task Classification

    On opening the task, any concepts previously loaded into the editor will be reloaded to restore the editing context from your most recent task editing session (the task state is automatically saved and restored by the application). After completing loading, a blue header notification will state "All concepts loaded" for a brief interval (or until you press the X in the upper right corner of the notification box).

    Provide Feedback

    Each Managed Service has its own ??-authoring sub-domain within the ihtsdotools.org domain.

    Go to the Managed Service AP in your web browser using the appropriate URL from the References list (sorted by country code in the sub-domain prefix).

    The Managed Service AP uses the SNOMED International Identity Management Service (IMS) to authenticate and authorise registered account access.

    If you're already registered with an existing SNOMED International Jira/Confluence account which has been granted AP access then you can use those credentials.

    https://au-authoring.ihtsdotools.org/ MS Australia https://at-authoring.ihtsdotools.org/ MS Austria https://be-authoring.ihtsdotools.org/ MS Belgium https://ch-authoring.ihtsdotools.org/ MS Switzerland https://de-authoring.ihtsdotools.org/ MS Germany https://dk-authoring.ihtsdotools.org/ MS Denmark https://ee-authoring.ihtsdotools.org/ MS Estonia https://fr-authoring.ihtsdotools.org/ MS France https://ie-authoring.ihtsdotools.org/ MS Ireland https://kr-authoring.ihtsdotools.org/ MS Korea https://nl-authoring.ihtsdotools.org/ MS Netherlands https://no-authoring.ihtsdotools.org/ MS Norway https://nz-authoring.ihtsdotools.org/ MS New Zealand https://se-authoring.ihtsdotools.org/ MS Sweden https://us-authoring.ihtsdotools.org/ MS United States

    If you are not logged in to the AP, your web browser will be redirected to IMS for account authentication and access authorisation. You will see the IMS login screen in your web browser. Enter your account name and password.

    If you check the Automatic log in box before pressing Log In, your credentials will be cached, so that your account name and password are automatically entered in the form when you next need to log in.

    With your credentials entered, press Log In.

    If your credentials cannot be authenticated or your account is not authorised for access to the AP, then IMS will reload the login screen so you can try again with updated credentials.

    Once authenticated and authorised, your web browser will then be redirected back to the Authoring Platform URL which triggered the authorisation and authentication process.

    At this point you will have an authorised account session cookie in your web browser which means you will no longer be prompted for account credentials until either you have explicitly logged off or closed your web browser.

    If one of the main URLs above was used to open the Authoring Platform, you will then see the appropriate Dashboard - My Tasks view, and a blue notification box will show in the page header stating "All tasks loaded" (the header notification will automatically close after a brief interval, or you can press the X button in its upper right corner to close it manually).

    The example screens in this page are for a Managed Service Ireland test account login, but others follow an identical pattern.

    If this is the first time you have used the AP (or all your existing tasks have been either promoted or deleted) then you will see an empty Dashboard listing view. This is where your tasks will be listed once created.

    At this point you're in the AP and ready to author content in your own tasks or review content created in other tasks by other authors.

    OR (from any Dashboard view) Press My Tasks in the Dashboard view left sidebar menu.

    The Dashboard My Tasks view is presented.

    Provide Feedback

    EITHER Go to the AP domain name web address. The default AP page is the Dashboard My Tasks view.

    https://authoring.ihtsdotools.org

    OR Go to the AP home page web address. This opens the Dashboard My Tasks view.

    https://authoring.ihtsdotools.org/#/home

    OR (from anywhere in the application) Open the page header drop down menu and press My Tasks in the overlaid menu options list.

    Log in to the Training Authoring Platform
  • Dashboard

    • See my tasks

    • Create a new task

    • Open one of my tasks (open task as an Author)

  • Task - Taxonomy and Concept Search

    • Browse the taxonomy to locate concepts

    • View concept details when browsing the taxonomy

    • Search for concepts by text or SCTID query

  • Task - Saved List

    • Add a concept to my task Saved List and act on saved concepts

    • Add a saved concept to the Project Favorites list and act on the listed concepts

  • Task - Batch

    • Update content via batch upload

  • Task - Edit

    • Edit a concept

    • Create a new concept

    • Add a General Concept Inclusion (GCI) to a concept

  • Task - Classification and Validation

    • Classify my task changes (to generate inferred relationships)

    • Preview concept changes before saving classification results

    • Preview concrete domain attributes and values in classification results

  • Task - Rebase and Promotion

    • Rebase my task from the project (synchronize with changes made in its parent project since task creation)

    • Promote my (non-complex) task changes to their parent project (share with other authors)

    • Promote my (complex) task changes to their parent project (share with other authors)

  • Project - Rebase and Promotion

    • Rebase a project (synchronize content changes from other projects)

    • Promote a project (promote to MAIN)

  • Reporting Platform

    • Open the Reporting Platform

    • Find an existing report

    • Read an existing report

  • Raise an Issue

  • MRCM Maintenance Tool

    • Browse Domains

    • Browse the Applicable Attributes/Ranges for a selected Domain

  • Work in an extension (Managed Service, Community Content and Training Authoring differences)

    • Import extension language or dialect terms (via a batch upload)

      • Import extension language/dialect batch file formats

    • Search using an extension language or dialect

  • Provide Feedback

    Log in
    Log in to the International Authoring Platform
    Log in to the Managed Service Authoring Platform

    Provide Feedback

    Open the Classification Results for a task and Preview a changed concept which has concrete domain attributes.

    The Preview Panel presents concrete values using the "green concrete value box" style.

    Vertically scroll the Preview Panel if needed to see all attributes for a complex concept definition.

    Provide Feedback

    Go to the International AP in your web browser.

    The International AP uses the SNOMED International IMS to authenticate and authorise access via a registered account.

    If you're already registered with an existing SNOMED International Jira/Confluence account which has been granted AP access then you can use those credentials.

    https://authoring.ihtsdotools.org/

    If you are not logged in to the AP, your web browser will be redirected to IMS for account authentication and access authorisation. You will see the IMS login screen in your web browser.

    Enter your account name and password.

    If you check the Automatic log in box before pressing Log In, your credentials will be cached, so that your account name and password are automatically entered in the form when you next need to log in.

    With your credentials entered, press Log In.

    If your credentials cannot be authenticated or your account is not authorised for access to the AP, then IMS will reload the login screen so you can try again with updated credentials.

    Once authenticated and authorised, your web browser will then be redirected back to the AP URL which triggered the authorisation and authentication process.

    At this point you will have an authorised account session cookie in your web browser which means you will no longer be prompted for account credentials until either you have explicitly logged off or closed your web browser.

    If the main URL above was used to open the International AP, you will then see the Dashboard - My Tasks view, and a blue notification box will show in the page header stating "All tasks loaded" (the header notification will automatically close after a brief interval, or you can press the X button in its upper right corner to close it manually).

    If this is the first time you have used the AP (or all your existing tasks have been either promoted or deleted) then you will see an empty Dashboard listing view. This is where your tasks will be listed once created.

    At this point you're in the International AP and ready to author content in your own tasks or review content created in other tasks by other authors.

    The Dashboard My Projects view is presented.

    Provide Feedback

    Work with large concept search results sets

    Steps
    References

    Selected search results can be downloaded for further local/offline processing or importing into other tools.

    Press the Download Selected Results button to the right of the results footer (it will be activated when results are found).

    This will trigger your web browser download file feature, and prompt to save the search results as a .tsv (tab separated values) text file to your local web browser environment.

    Once saved to disk, the results can be viewed in any text editor.

    The first row has header labels for each item in the results rows below it.

    Each row contains the following:

    • id (concept SCTID)

    • fsn (concept Fully Specified Name)

    • effectiveTime (SNOMED CT release in which it was published)

    Act on concept search results

    Steps
    References

    Press More details at the start of a search results row (also the definition status icon).

    This opens the Concept Information pop-up window (as described in ).

    Search for concepts with concrete domain values by ECL query

    Finding concepts with concrete domain values

    Existing concepts containing attributes with concrete domain values can be found by searching with an ECL query containing a concrete domain value refinement:

    For instance, this ECL query returns all concepts that have an attribute with the concrete value 12.5: * : * = #12.5

    Steps
    References

    In the Task - Search - ECL Search context panel tab, enter an ECL expression which includes a concrete value reference into the Search Query box.

    Press the blue Search action button to the right of theSearch Query box.

    The Search Results Panel shows a Searching... notification until the results are collated.

    See tasks submitted for review (by other authors)

    Steps
    References

    EITHER (from anywhere in the application) Open the page header drop down menu and press Review Tasks in the overlaid menu options list.

    OR (from any Dashboard view) Press Review Tasks in the Dashboard view left sidebar menu.

    See all projects

    Steps
    References

    EITHER (from anywhere in the application) Open the page header drop down menu and press All Projects in the overlaid menu options list.

    OR (from any Dashboard view) Press All Projects in the Dashboard view left sidebar menu.

    Remove a report (from the RP report listing)

    Steps
    References

    Find the report to remove, as described in .

    Move your cursor over the report row entry (the row background will change shade when your cursor is in its context). A red “minus” icon will also appear to the right of the label link icon.

    Task - Taxonomy and Concept Search

    How do I... ?

    • Browse the taxonomy to locate concepts

    • View concept details when browsing the taxonomy

    • Search for concepts by text or SCTID query

    • Search for concepts by ECL query

    Reporting Platform

    The SNOMED CT Reporting Platform (RP) is a gateway to reports which can run a range of queries against content created or updated in the active authoring cycle for SNOMED CT.

    Queries are structured into categories for ease of definition, navigation and retrieval, such as Ad-Hoc Queries, Release Validation and Quality Improvement.

    The results of these queries can support pre-release validation of issues not supported by the Authoring Platform (for instance MRCM rules such as attribute cardinality). They can also be used to analyze the structural quality of SNOMED CT, to identify potential issues (for instance attribute usage for a given sub-hierarchy) which can then be addressed via content change projects in the Authoring Platform.

    For the content team it enables iterative work to define complex QA rules that are eventually used for the Release Validation Framework (RVF) assertions (such as case significance). As a content release planning and tracking tool it can show the number and types of changes made during a SNOMED CT release cycle, and from one release to the next.

    How do I... ?

    Modify a General Concept Inclusion (GCI) in a concept

    Steps
    References

    With a GCI present in the concept edit panel (eg via the steps above), use the Add GCI Axiom button in the concept header to add a new GCI to the edit panel. Drag and drop the concept parent Diabetes mellitus (disorder) as the target for the new GCI Is a relationship.

    Using the Add General Concept Inclusion button in the concept header, add another GCI to the concept edit panel.

    Open the Reporting Platform

    Steps
    References

    EITHER

    On any page in the Authoring Platform , press the icon to the left of the word Dashboard in the header. This presents a pop-up navigation menu.

    Press Reporting Platform in the pop-up menu options (last item).

    OR

    Enter the URL https://authoring.ihtsdotools.org/reporting directly into your web browser address bar (save the URL to your web browser bookmarks for easy retrieval if desired).

    Add a General Concept Inclusion (GCI) to a concept

    Steps
    References

    Open a concept for editing, for example: |Secondary diabetes mellitus (disorder)|. The concept header contains the Add GCI Axiom button. The button icon is a solid rounded square containing a "plus" symbol.

    Press the Add GCI Axiom button in the concept header. A new General Concept Inclusion panel will appear below the concept relationships containing a single empty Is a attribute.

    MRCM Maintenance Tool

    The MRCM Maintenance Tool supports browsing, creation, testing, review and publication of MRCM rules used in the SNOMED CT Authoring Platform and included in SNOMED CT releases for conformance checking.

    Key uses include:

    • Browsing the MRCM rules The current release MRCM rule set can be browsed by anyone with a SNOMED International Confluence account. This feature supports and enhances the SNOMED CT Editorial Guide via links to interactive navigation of published rules.

    • Maintain MRCM rules (Version 1.1.0+) The SNOMED International Content Team will use the tool to review, create, modify, inactivate and promote MRCM rule changes.

    • Version and Publish MRCM rules (version 1.1.0+) The SNOMED International Content Team will version and publish MRCM rules in files that conform to the MRCM reference set specifications.

    How do I... ?

    View translated language/dialect extension descriptions

    Steps
    References

    With an International published concept loaded into the editor, view the concept descriptions.

    Translated terms appear as individual descriptions set to be the Preferred Term (PT) for the languages-dialects available in a specific SNOMED CT extension.

    The example shown here is the International published concept which was loaded by searching for the French word "événement" and pressing "événement accidentel" in the search results.

    Note the language-dialect acceptability settings for each description row:

    • The first description is always the Fully Specified Name (FSN). This is always defined as Preferred in the en-US dialect.

    • The second description is the International Edition PT, which is defined as a SYN (synonym) set to Preferred in the en-US dialect.

    • The third description is the

    Find an existing report

    Steps
    References

    Determine which report category is applicable to your query.

    If there are many categories, and yours is not visible in the main content area, press a category heading in the left-hand sidebar Categories menu to only show that category’s reports.

    Pressing the heading again restores the full Categories view.

    Each press toggles between the only the selected category and showing all categories.

    Use context-specific language reference sets for an extension

    Steps
    References

    When working in a task within a Managed Service extension, context-specific language reference set acceptability entries can be enabled in Concept Editor within the Edit Panel, by selecting from a list of those available in the author's Settings and Preferences.

    From the Task View , press the cogwheel icon in the upper right of the page header, to open the Settings and Preferences pop-up dialogue.

    When context-specific language reference sets are available, they are listed above the Page Layout section.

    Each entry has a checkbox to enable display of those entries in the Concept Editor.

    Check the box for the desired entry, then press Save in the Setting and Preferences dialogue.

    Project - Rebase and Promotion

    How do I... ?

    Provide Feedback

    Log in to the Training Authoring Platform

    Steps
    References

    Go to the Training AP in your web browser.

    The Training AP uses the SNOMED International IMS to authenticate and authorise access via a registered account.

    If you're already registered with an existing SNOMED International Jira/Confluence account which has been granted AP access then you can use those credentials.

    If you are not logged in to the AP, your web browser will be redirected to IMS for account authentication and access authorisation. You will see the IMS login screen in your web browser. Enter your account name and password.

    If you check the Automatic log in box before pressing Log In, your credentials will be cached, so that your account name and password are automatically entered in the form when you next need to log in.

    With your credentials entered, press Log In.

    If your credentials cannot be authenticated or your account is not authorised for access to the AP, then IMS will reload the login screen so you can try again with updated credentials.

    Search for tasks

    Steps
    References

    Rebase a project (synchronize content changes from other projects)

    Steps
    References

    Create a new concept

    Steps
    References

    Preview concept changes before saving classification results

    Steps
    References

    View concept details when browsing the taxonomy

    Steps
    References

    Claim a task for review (open task as a Reviewer)

    Steps
    References

    View taxonomy with an extension dialect

    Steps
    References

    Read an existing report

    Steps
    References
    See tasks submitted for review (by other authors)
    Claim a task for review (open task as a Reviewer)
    See my projects
    See all projects
    Create a new project
    Search for tasks
    Search for concepts by ECL query
    Search for concepts with concrete domain values by ECL query
    Search for concepts by Template matching
    Transform template matched concepts using another template
    Work with large concept search results sets
    Act on concept search results
    Modify a General Concept Inclusion (GCI) in a concept
    Validate my task changes
    Promote my (batch) task changes to their parent project (share with other authors)
    Automatically Promote my task changes to their parent project (share with other authors)
    Run an existing report
    Remove a report (from the RP report listing)
    Create a new report and/or report category
    Request a new feature or improvement, or raise an issue for the Reporting Platform
    Search for concepts using Chinese characters
    View extension concept module details
    View taxonomy with an extension dialect
    View translated language/dialect extension descriptions
    Use context-specific language reference sets for an extension
    Resolve upgrade integrity issues (Integrity Report resolution)
    Filter All Projects view by category
    Promote an extension concept to the SNOMED CT International Edition (via CRS request)
    Search for concepts with concrete domain values by ECL query
    Search for concepts by Template matching
    Template transformation (transform template match concepts using another template)
    Work with large concept search results sets
    Act on concept search results
    Provide Feedback
    Open the Reporting Platform
    Find an existing report
    Read an existing report
    Run an existing report
    Remove a report (from the RP report listing)
    Create a new report and/or report category
    Request a new feature or improvement, or raise an issue for the Reporting Platform
    Provide Feedback

    Task Validation

  • Task Rebase

  • Show Task Editing layout

  • Hide the Left Sidebar

  • Hide all concept models

  • Not your Managed Service AP? If you have access permissions to more than one Authoring Platform, it's possible to inadvertently log into one of the others (perhaps via a bookmarked address) when a Managed Service AP was your intention, and they can appear almost identical in style and layout apart from the task names of any previously created tasks.

    Please verify the domain name in your browser's address bar if you're not sure, and if it's not what you intended, simply logout and start over with the appropriate AP URL from the References list in the first step above.

    Not the International AP? If you have access permissions to more than one Authoring Platform, it's possible to inadvertently log into one of the others (perhaps via a bookmarked address) when the International AP was your intention, and they can appear almost identical in style and layout apart from the task names of any previously created tasks.

    Please verify the domain name in your browser's address bar if you're not sure, and if it's not what you intended, simply logout and start over with the International AP URL ( https://authoring.ihtsdotools.org/ ).

  • active (true if active, false if inactive)

  • moduleId (module SCTID)

  • definitionStatus (primitive or fully-defined)

  • Uncheck Select All and press individual row select checkboxes to make ad-hoc selections of search matches.

    Press Load Next 100 in the results footer for large results set to extend the listing with the next 100 results.

    Each time this is done the listing is expanded to include all the previous results, and a vertical scroll bar will appear to the right of the results panel to allow the list to be scrolled.

    Ad-hoc selections are preserved when the next 100 results are loaded, so selections can be added from throughout the entire results set if needed (although a better strategy might be to refine the search query to get a smaller results set).

    Once all desired ad-hoc selections are made, press Download Selected Results to save the results as a .tsv file in your local web browser environment.

    Open the downloaded .tsv file in any text editor to see that it contains only the selected result entries, regardless of the total number of results.

    Provide Feedback
    French language PT
    , which is defined as a
    SYN
    set to
    Preferred
    in the
    fr
    language.
  • The fourth description is the Dutch language PT, which is defined as a SYN set to Preferred in the nl language.

  • Use the More details ellipsis-vertical buttons on the description rows to compare details for the various concept descriptions:

    • The FSN and en-US PT are defined in the SNOMED CT core module with Lang. setting en.

    • The extension translated PTs are defined in the Belgian module, with Lang. settings fr and nl respectively.

    • The SCTID of each translated PT contains the Belgian extension namespace identifier: 1000172.

    Since this is an International Edition published concept the More Details panels include an Eff. Time (Effective Time) value (the release of SNOMED CT in which they were last published).

    The Effective Time for extension descriptions will be the last publication date for their extension, whereas the FSN and en-US PT show International Edition release dates.

    As can be seen in this example, the description Effective Time may differ from that of the concept itself.

    Provide Feedback
    418019003 | Accidental event (event) |
    This query returns all concepts that have an attribute with a concrete value greater than zero: * : * > #0

    The Search Results Panel lists the concepts matching the ECL query.

    Follow up actions can include:

    • Act on concept search results

    • Work with large concept search results sets

    Provide Feedback

    On completion of the search, the panel below the search query is populated with the tasks with names (titles) either partially or fully matching the entered text query (or a single exact match to a task ID).

    Each matching task result row includes a blue Open in new Tab icon button, and the task name which is an active link.

    Additional information for each task is presented in the same format and styling as the My Tasks view listing.

    EITHER Press the Open in new Tab icon button to open the task in a new web browser tab (or window, if set by your personal web browser preferences). This allows the task to be viewed whilst retaining the Task Search dialogue results for further use (to review other task matches, or to modify the query for new search results).

    OR Follow the task name link to open the task in the same web browser tab. This closes the Task Search dialogue and takes you into the task Edit panel view as if the task had been opened from the My Tasks view listing.

    The task Edit panel view is presented (either in a new tab/window, or replacing the search dialogue in the current tab according to which option is used).</p

    Provide Feedback

    Press Search Tasks in any Dashboard view left sidebar menu.

    The Search Tasks pop-up dialogue is presented, containing a single text query field and a Search action button.

    Enter text to match the labels of your tasks, then press Search. You can also search for exact matches to a task ID - but see the note below.

    A blue Searching... prompt box is presented below the search query whilst the server finds matches to the entered text query.

    If the rebase comparison shows that merging can be completed with no content conflicts, the main display panel changes to show a green "Project can be merged with mainline content without issues, pulling changes in from mainline content..." full display panel notice (with an animated timer indication that the merge process is taking place).

    Once the merges are completed, the main display panel changes to show a green a green "Success! Switching to project view in five seconds..." full display panel notice, which closes automatically after five seconds have elapsed (during which the merges are finalized in the project branch content).

    The Project View is reloaded, with the Pull in Mainline Changes (rebase project) button now inactive (greyed out).

    At this point the project branch status has been returned to Forward, and changes made within the project are once again eligible for promotion to the mainline.

    Provide Feedback

    Rebase eligibility is indicated as an active (yellow) Pull in Mainline Changes icon button in the project actions button bar in the upper right corner of the Project View.

    Press Pull in Mainline Changes to initiate the rebase process.

    The main display panel changes to show a blue "Comparing project to mainline content, please wait just a moment..." full display panel notice (with an animated timer indication that the comparison process is taking place).

    Enter a target value for the Axiom Is a relationship, by typing in the target value box - once 3 or more characters are entered, type-ahead searching populates a drop-down selection box with matching concepts.

    Select the desired concept in the options list to be the parent "type" for the new concept.Relationship target values can also be populated by drag and drop from Taxonomy, Search Results or Saved List entries.

    When the form elements are fully populated (and adjusted from defaults if needed), press Save Concept in the Concept Header. This sends the entered details to the Terminology Server and the concept is assigned a new SCTID.

    A Saving new concept notification is presented in the main page header.

    The diagram view is populated with the FSN and SCTID assigned by the save process.

    On completion of the save request, a Concept saved: <fsn-description> page header notification is presented.

    The diagram view at this stage does not show the Axiom Is a relationship. This is because it defaults to the Inferred view, which requires the new concept to be classified to become populated.

    You can use the buttons in the diagram menu bar to switch the diagram to Authoring Form (AF) or Stated view - either of which shows the relationship regardless of the concept classification status.

    Provide Feedback

    Press Create New Concept at the top of the left-hand menu bar.

    A new outline concept is presented in the Edit panel, with a matching outline in the Diagram Panel, containing the following essential elements:

    • Fully Specified Name (FSN)

    • Preferred Term (Synonym)

    • Axiom (containing one Is a relationship)

    All three of these must be populated with content before the concept can be saved.The cursor context is automatically moved to the text box for the Fully Specified Name (FSN), ready to receive its description text.

    Enter the text description for the FSN, which must end with a valid SNOMED CT semantic tag (if not valid, warnings will be displayed when saving).

    The FSN term (without the semantic tag) is automatically copied into the Preferred Term description field.

    The default settings for case sensitivity can be adjusted to suit the content at this point, via the options box to the left of the text term on each description row (if the case sensitivity does not match the content, warnings will be displayed when saving).

    The model diagram can be toggled between Inferred and Stated views.

    The "before" model diagram in the Stated view shows the concept model defined in the task.

    For simple new lead-node concepts defined as children of a high-level SNOMED CT concept, the before/after model diagrams may well be identical, but much depends on the concept ancestors and their inferred relationships.

    For concepts created "deeper" in SNOMED CT there are likely to be additional inferred relationships in the "after" modelling.

    The left-hand side of the Preview Pane presents the Taxonomy View panel, showing the concept's location within the SNOMED CT taxonomy.

    This can also be toggled between Stated View and Inferred View, via the drop-down selector in the top left of the taxonomy view panel.

    In the Inferred view this has no location to show yet, since the classification results are not yet saved.

    The Taxonomy View panel can also be toggled between showing the FSN (in en-US) or the Preferred Term (in en-US), via the drop-down selector in the top right of the taxonomy view panel.

    Provide Feedback

    Press View Classification (completed <em><date-time stamp></em>) in the LH button bar Classification sub-menu.

    The Classification Report is loaded, showing a tabulated list of concepts affected by task classification.

    Press the Preview button to the right of a classification result.

    A "retrieving concept before/after information..." notification panel is presented in the page header whilst the information is being loaded.

    The preview pane then opens below the classification results, showing a before/after Inferred model diagram view of the concept.

    The "before" model diagram in the Inferred view shows an incomplete model since classification results are not yet saved.

    Concept Information - Incoming Relationships

    Incoming Relationships - Filtering by characteristic type (stated/inferred) or by relationship type

    Paging for large lists - page number buttons, page left and page right buttons

    Paging for large lists - items per page

    Concept Information - Incoming Historical Associations

    Concept Information - Details

    Concept Information - Taxonomy

    Provide Feedback

    Press a concept's Definition Status icon.

    The Concept Information pop-up overlay window is opened.

    A loading message is shown until the window contents are available (loading from the Terminology Server).

    OR In the Review Tasks view, press the feedback status icon (if present), on the task you want to open. This opens the Task View to the context of the Feedback activity tab. This option is only available once at least one review comment has been added by either a reviewer or author.

    Whilst loading, the main content panel is cleared, and a blue header notification stating "Loading task details..." is presented. When completed, the header notification changes to "Task details loaded".

    The Task Review and Feedback layout is presented, showing concepts to review, concepts approved, and inferred concept changes within the task. This layout maintains the Activities panel (Left Sidebar), as well as the Options panel menu for navigation back to other task contexts.

    Provide Feedback

    EITHER In the Review Tasks view, press the name link on the task you want to open. This opens the Task View to the context of the Feedback activity tab.

    If task status is Ready for Review and the review status is Available (not yet claimed) this action will claim it for review and assign you to it as a Reviewer. The task will change state to In Review and its review state will become Claimed.

    If task status is In Review and review is Claimed this will re-open the task for review and show any changes made to concepts in the task.

    Whilst loading, the main content panel is cleared, and a blue header notification stating "Loading task details..." is presented. When completed, the header notification changes to "Task details loaded".

    The Task View Review and Feedback layout is presented, showing concepts to review, concepts approved, and inferred concept changes within the task. This layout maintains the Activities panel (Left Sidebar), as well as the Options panel menu for navigation back to other task contexts.

    Claimed for review tasks are only visible in the Review Tasks view to the people named in the Reviewers list. It's possible to add/remove names from the Reviewers list whilst a review is in progress, to support nominating other people deputizing as reviewers, or switching to a replacement reviewer. This means it's also possible that the original claimant will no longer see the task in the Review Tasks list if they have been subsequently removed from the Reviewers list.

    An Author can add people to the Reviewers list after submitting for review, which will have the same effect for each Reviewer as if they had claimed the task for review from the Available state. This allows an author to nominate a particular reviewer (or selected set of reviewers) when submitting for review.

    Provide Feedback

    In the Taxonomy panel, press the Language drop-down selector control in the top right corner of the panel.

    A list of language display options are presented for the Fully Specified Name (FSN) and Preferred Term (PT) for each available language-dialect.

    As an example, these are the options for ms-belgium:

    • FSN in US

    • PT in US

    • PT in FR

    • PT in NL

    Press an option to select that language-dialect for the Taxonomy listing preferred terms.

    The preferred terms in the Taxonomy listing are updated to show the selected language option.

    Since the report itself is a Google Sheet, all the options and services associated with a shared Google Sheet are available for further processing and analysis as needed, such as copying to a personal sheet for further analysis/manipulation, download as a file in various formats for offline review and processing (including exporting to other tools and services).

    Provide Feedback

    Reports for queries that have been run and already available are listed with status Complete. This status links to the completed report which is stored as a Google Sheet in a Google Drive shared folder - press the label or the icon to open the Google Sheet report.

    If you are not already signed in to your Google account in an existing browser session, you’ll be prompted for your Google credentials. Enter these to proceed and view the report sheet.

    An example report is shown in the screenshot for TermContainsXReport 71388002 |Procedure| 20181220_103142_prod_sulrich.

    The sheet name contains the report title followed by the run date-time (in YYYYMMDD_HHMMSS format), a platform identifier (prod), and finally the account name of the originator (ie the account login under which the report query was run).

    Press the search result FSN term (Edit) to open the concept in the Edit Panel.

    For active search results, press View in Taxonomy to open the concept in the Task View - Taxonomy tab.

    The display context changes to Task View - Taxonomy , with the trigger concept as the focus for the taxonomy listing.

    For inactive concepts in search results, the View in Taxonomy button is replaced by an Inactive Concept icon.

    Press Add to Saved List to add the search result concept to the task Saved List.

    Press Clone this concept to create a new unpublished cloned version of the concept in the Edit Panel. This is equivalent to creating a new concept and entering its lexical and logical model content from scratch.

    Provide Feedback
    View concept details when browsing the taxonomy

    The Dashboard Review Tasks view is presented.

    Provide Feedback

    The Dashboard All Projects view is presented.

    Provide Feedback

    Press the red minus sign to remove the report from the list. This presents the Delete Report pop-up dialogue.

    Press the Delete Report button in the lower right-corner of the dialogue box to remove the report entry from the report listing. Press the x in the upper right corner of the dialogue box to close the box without changing the report listing.

    Delete Report removes the list entry - not the report itself

    This action removes the report entry from the Reporting Platform listing but does not remove the Google sheet report saved in Google Drive, which can still be viewed directly from Google Drive if needed.

    Any report removed from the listing can be added back simply by running that report again (although the date-time and account name will be those of the re-run rather than any previously run report).

    Provide Feedback
    Find an existing report

    Press the Add New Relationship "plus" button within the GCI panel to add a new relationship. Use type-ahead search to enter and select Associated with (attribute) as the relationship type.

    Use type-ahead search to enter and select (for instance) Disorder of endocrine system (disorder)as the target value for the new Associated with relationship.

    Save the new GCI via the concept header Save Concept button.

    Modify the original GCI, for example using type-ahead search to find and select Alteration in nutrition (finding) as a new target for the Due to attribute.

    Press Save in the concept header to save the GCI attribute changes.

    Confirm the changes via the Stated view of the concept diagram.

    Provide Feedback

    The Reporting Platform entry view is presented, showing a Categories selection panel to the left, and an associated Query List panel to its right.

    Provide Feedback

    Drag the parent concept (|Diabetes mellitus (disorder)| for this example) as a target for the GCI Is a relationship.

    Press the Add New Relationship "plus" button within the GCI panel. Use type-ahead search to enter and select Due to (attribute) as the relationship type.

    Use type-ahead search to enter and select |Disease (disorder)| as the target value for the new Due to attribute.

    Save the concept.

    Show the stated view of the concept diagram. Diagram shows empty GCI box with reverse subtype indicator.

    Provide Feedback

    Press the header label for your category to show the reports listed under that heading. The screenshot shows the available Semantic Tag Hierarchy reports after pressing its heading.

    Pressing the header label again will collapse the reports listing.

    Each press of the report heading toggles the expansion/collapsing of the reports listing.

    With your category expanded, find the report in the list of those available.

    If a particular report that you need cannot be seen, you can run a new query for that report.

    Provide Feedback

    The Settings and Preferences dialogue closes, and a header notification for "Application preferences updated" is presented.

    With the settings saved, and an appropriate concept loaded into the Edit Panel, the language acceptability entries for each term are updated to include those for the selected context-specific language reference set (abbreviated in the same style as the other language acceptability entries).

    Hovering over one of the newly presented entries presents a tooltip which expands the full name of the context-specific language reference set and the acceptability setting.

    Creating new concept entries

    These entries can be used in the same way as the other acceptability settings which are always present in the Edit Panel.

    If a new concept is created, or a new description is added to an existing concept, and a value is set for one of the context-specific settings, a new entry will be created in the appropriate context-specific language reference set within the task branch, in exactly the same way as those for the other language reference set acceptability settings.

    The default entry for these in the Concept Editor for new concepts is Not Acceptable.

    Editing/saving an existing setting will also update the corresponding existing context-specific language reference set entry.

    cogwheel
    Provide Feedback

    Once authenticated and authorised, your web browser will then be redirected back to the AP URL which triggered the authorisation and authentication process.

    At this point you will have an authorised account session cookie in your web browser which means you will no longer be prompted for account credentials until either you have explicitly logged off or closed your web browser.

    If the main URL above was used to open the AP, you will then see the appropriate Dashboard - My Tasks view, and a blue notification box will show in the page header stating "All tasks loaded" (the header notification will automatically close after a brief interval, or you can press the X button in its upper right corner to close it manually).

    The upper left corner of the site header also shows a diagonal ribbon (green/gold) labelled "TRN" to highlight that this is the Training Authoring Platform.

    If this is the first time you have used the AP (or all your existing tasks have been either promoted or deleted) then you will see an empty Dashboard listing view. This is where your tasks will be listed once created.

    At this point you're in the Training AP and ready to author content in your own tasks or review content created in other tasks by other authors.

    Not the Training AP? If the green and gold "TRN" corner banner is not presented in the upper left corner, please verify the domain name in your browser's address bar, as you may have inadvertently logged into the International AP or a Managed Service AP (perhaps via a bookmarked address) which can look almost identical in style and layout apart from the task names of any previously created tasks.

    If this is the case, simply logout and start over with the Training AP URL ( ).

    Provide Feedback
    https://training-authoring.ihtsdotools.org/

    Further Reading

    SNOMED CT Glossary: MRCM
    SNOMED CT Glossary: Expression Constraint
    Confluence Space: Machine Readable Concept Model
    Confluence Space: Expression Constraint Language
    Provide Feedback

    Transform template matched concepts using another template

    Steps
    References

    When Search by Template results are found (and logical and lexical or logical not lexical is selected), a green Transform button will be presented adjacent to the blue Download Selected Results button at the end of the search results listing.

    Press the Transform button to present the Template Transformation pop-up dialogue.

    Browse the taxonomy to locate concepts

    Steps
    References

    Press the Taxonomy tab in the Task View - Context Panel tabs list.

    The Task View - Context Panel switches to the Taxonomy view with a hierarchical tree-node representation of SNOMED CT concepts, based on their parent-child (Is-a) relationships.

    Each row in this view represents a hierarchy node, and is preceded by one of two icon buttons:

    • (child nodes expanded)

    • (child nodes collapsed)

    Pressing or toggles from one state to the other.

    Browse Domains

    Steps
    References

    EITHER Press MRCM in the Authoring Platform header menu.

    OR Enter the MRCM Maintenance Tool address directly in your web browser (for example from a bookmark).

    The MRCM Maintenance Tool opens in a new tab/window (depending on your web browser options), containing:

    • Branding and identity header

    • Context and actions bar

    • Domain panel

    Search for concepts by ECL query

    Steps
    References

    When in text search mode (default on opening Task View - Search tab), press Switch to ECL.

    If previously switched to template search mode, press Switch to Text, then press Switch to ECL.

    Enter an ECL expression into the search query box.

    Promote an extension concept to the SNOMED CT International Edition (via CRS request)

    Steps
    References

    With a published unchanged source concept from the extension loaded into the Editing panel, press the caret-up button on the right of the concept header panel to open the concept header extended menu.

    Press Request Promotion in the extended menu options list.

    Update content via batch upload

    Steps
    References

    Press Upload a Batch in the left-hand navigation menu. The Upload a Batch dialogue box is overlaid on the screen.

    Download the latest version of the Translation Import Template (Batch Upload) template file using the here link in the text below the dialogue box title.

    The Batch Upload template is a spreadsheet in Microsoft .xslx format, with multiple tabs corresponding to the type of batch change supported.

    Raise an Issue

    Steps
    References

    Press Raise an Issue to report issues or submit change requests related to AP usability and features.

    The Raise an Issue pop-up form is presented. If the form height is larger than your available web browser display height, a vertical scroll bar will appear to allow you to scroll down and see all the form content (the form header title and footer actions remain visible whilst scrolling). The following fields are available:

    • Summary (required, single line text, maximum of 255 characters)

    • Description (multi-line text with markup formatting support for structured text)

    Search for concepts by Template matching

    Steps
    References

    When in text search mode (default on opening Task View - Search tab), first press Switch to ECL.

    When in ECL search mode, press Switch to Template.

    The search tab changes to Template search mode, with a template name query box at the top of the search panel.

    Type a template name (or part of a name) into the search query box - type-ahead searching starts after at least three characters are entered, with matching available template names presented in a drop-down selection box below the query.

    Import extension language or dialect terms (via a batch upload)

    Steps
    References

    From the Dashboard - My Tasks view, press Upload a Batch in the left-hand menu bar.

    Content translation terms are imported via .tsv (tab-separated values) text files, with three format types corresponding to the following actions:

    • Description Additions

    • Description Changes

    • Description Inactivations

    The Upload a Batch pop-up form is presented, centred on the page and overlaying the Dashboard - My Tasks view which is dimmed but still visible "below" the form.

    This form has the following fields and calls to action:

    • Task Title (single line text entry, freely editable)

    • Select Project (drop-down select list of projects available to the authenticated author)

    Promote a project (promote to MAIN)

    Steps
    References

    Project-level SAC are presented in the Project View as two lists within the Acceptance Criteria accordion-style expandable/collapsible content section, located below the Project Details and above the Classification Results section.

    Automated Project-level SAC are listed to the left, with Manual Project-level SAC to the right.

    Automated SAC have a yellow warning triangle icon if not yet met, and a green tick if their automated system checks confirm they are satisfied.

    Manual SAC are presented initially as open checkboxes, each of which can be interactively signed-off (green-ticked) when the user's role-based access permissions match those configured for that SAC control.

    For many projects it may be appropriate to only enable Manual SAC. In this case the Automated Criteria heading is still present, but that list is empty, and the project may then be promoted when all Manual SAC are signed-off.

    Particular manual SAC require a specific role to be able to sign-off, such as PROJECT_LEAD, so more than one person may be needed to get all SAC satisfied, and those without a required role will see the current status of those SAC, but will not be able to change it.

    When all mandatory project-level SAC are satisfied, the project is not diverged, and the project configuration enables promotion, the Promote button will be active for those with the PROJECT_LEAD role.

    Filter All Projects view by category

    Steps
    References

    In the Dashboard - All Projects view, when an author has access roles granted in projects which span more than a single category, a drop-down selector will appear to the right of the Search All Projects query slot in the view header.

    The default selection is All (to search all projects).

    Entering a query will trigger a type-ahead search of all projects after each character is entered.

    Keep typing to narrow down the results set as the query becomes more defined.

    Add a saved concept to the Project Favorites list and act on the listed concepts

    US spelling

    The international Authoring Platform user interface uses en-US spelling for its labels, hence the spelling of words such as "favorite" in this guide.

    Steps
    References

    In a Task View - Saved List entry, press Add to Project Favorites to extend the Project Favorites list with that concept.

    If no project favorites have yet been added then the Task View - Saved List content panel only shows the task saved concepts.

    After adding at least one saved list item to the Project Favorites, the content panel updates to show the Project Favorites list below the task Saved List.

    If any concepts have been saved as a project favorite in any task within the project, then all tasks in that project will show the Project Favorites list in their Task View - Saved List.

    The Task View web page automatically picks up changes when first loaded, but it may need to be refreshed to pick up any changes made by others whilst it remains open in the web browser.

    Each item in the Project Favorites list has the following:

    • Primitive or Fully Defined button (status definition icon)

    • Preferred Term

    Classify my task changes (to generate inferred relationships)

    Steps
    References

    Edit a concept

    Steps
    References

    Promote my (non-complex) task changes to their parent project (share with other authors)

    Steps
    References

    Create a new task

    Steps
    References

    Add a concept to my task Saved List and act on saved concepts

    Steps
    References

    Automatically Promote my task changes to their parent project (share with other authors)

    Steps
    References

    Browse the Applicable Attributes/Ranges for a selected Domain

    Steps
    References
    https://training-authoring.ihtsdotools.org/

    Reviewers list

    Assigning reviewers (nominating for review)

    Preferred terms that are not yet translated

    If no translated term is available in a selected extension language-dialect, the terms will fall back to the en-US PT (required for all concepts), so a mix of the selected language-dialect and en-US terms should be expected until full coverage of PT translations is available for a given extension.

    The initial view shows
    138875005 |SNOMED CT Concept (SNOMED RT+CTV3)|
    at the top of the listing, in its expanded presentation, revealing the SNOMED CT top level concepts.

    Each taxonomy row also has the following:

    • Primitive or Fully Defined definition status icon

    • Text label showing either the concept FSN or Preferred Term (PT) in the en-US dialect

    Press Primitive or Fully Defined to open a Concept Details pop-up box as described in View concept details when browsing the taxonomy.

    Single-press a node label to load that concept into the edit panel.

    Double-press a node label to change the focus of the taxonomy tree to that concept.

    This presents the same view as opening a concept in the taxonomy from a Task View - Search result (see Act on concept search results) or Task View - Saved List entry (see Add a concept to my task Saved List and act on saved concepts).

    Above the taxonomy listing are two presentation controls:

    • Switch between Inferred View (default) and Stated View

    • Switch between FSN in US (default) and PT in US for the node label text

    Navigate down the taxonomy nodes by successively expanding selective child nodes.

    When a concept is reached that has no child concepts (ie it is a taxonomy "leaf" node), the row entry is preceded with a icon, indicating that no further expansion is possible.

    Any taxonomy node that is visible can be expanded or collapsed independently of the others. Changing one node does not affect others previously expanded or collapsed at that level or above - only direct descendants are affected.

    Provide Feedback
    Applicable Attributes
    panel
  • Attribute Range panel

  • Copyright notice, help and contact us footer

  • The header contains site branding and an MRCM version selector to its left (the default selection is the current authoring cycle content, ie the MRCM content for the next SNOMED CT release). To its right is the the authenticated account name, which when pressed expands the header downwards to reveal a Logout square-up-right link (pressing the account name toggles the link visibility). Follow that link to log out and exit the application (this returns you to the IMS screen).

    Below the header, the context and actions bar runs across the three main content panels. Currently selected items appear to the left of this bar (initially empty when nothing is selected), and a RESET button is available to its right (this clears any selections and initialises the content panels).

    The Domain panel shows a nested tree-view listing of SNOMED CT domains. Navigate the tree-view listing to browse the domains.

    By default the Applicable Attributes panel shows all available attributes. When an applicable attribute is selected, the Attribute Range panel shows that attribute's range details.

    The footer contains a copyright notice, help link (which opens the MRCM Maintenance Tool section of this use guide), and a contact us link (identical to that in the Authoring Platform footer).

    The domain names are active - pressing one will change the context of the Applicable Attributes panel to those matching the domain, and also expand the Domain Details sub-panel at the base of the Domain panel.

    The Domain Details sub-panel can be toggled closed/open when a domain name is selected.

    When open, press square-caret-down on the right of the sub-panel title bar to close the Domain Details sub-panel.

    When closed, press square-caret-up in the sub-panel title bar to open it.

    The listed domains can be filtered by typing match text into the Filter Domains... text box above the list.

    Clear the Filter Domains... box by deleting the text or pressing the X button at the right of the text box, to remove the filtering and re-show all domains.

    Alternatively, press RESET to the right of the context and actions bar (upper right corner above the three main content panels). This clears all three content panels back to their initial view state.

    Login needed

    If you are not logged in to the Authoring Platform and enter the MRCM Maintenance Tool address directly in your web browser, or follow a bookmark link, you will first be prompted to log in. Once logged in with an authenticated account you will be automatically be directed back to the MRCM Maintenance Tool address.

    Provide Feedback
    https://authoring.ihtsdotools.org/mrcm

    Browse older versions of the MRCM

    Use the header Version drop-down selector to set the version of MRCM to be browsed.

    Attach file (browser's local file selector)
  • Priority (single choice option list selector)

  • Name (single line text, maximum of 255 characters)

  • Email (single line text, maximum of 255 characters)

  • Include data about your current environment, like the browser and page URL (opt-in checkbox)

  • The form footer has a Submit action button and a Close link.

    Enter the desired details. The more information included the better, but also try to be as concise as possible and ideally keep to one identifiable issue per submission - this will simplify subsequent processing and hence make it quicker to assess, prioritise and investigate further if needed.

    The minimum needed is a brief one-line Summary of the issue. Everything below that on the form is optional.

    The Description field supports formatting options for structured text. Press the small question mark icon to open a Text Formatting Notation Help pop-up window with guidelines on including advanced formatting (wiki) markup.

    You can use the Attach file (Choose Files) field to include a file attachment such as a screenshot.

    An indication of the issue impact or urgency can be included using the Priority drop-down selector options. This will be taken into account when assessing the submitted issue but it will be treated as advisory and considered with additional contexts, including capacity and release scheduling.

    Please elaborate any critical dependencies in the Description to help with follow-up prioritisation.

    Including your Name and Email will help in identification, tracking and follow-up notifications/discussions.

    The opt-in checkbox enables the form to capture details about your current web browser environment. You can press the What is included in the data about my current environment? link to preview those details and help decide whether or not to include them if unsure. Including them can help the technical support teams when troubleshooting defect reports, particularly anything related to screen presentation/layout, but of course it's entirely optional.

    Press Submit in the form footer to submit your entered feedback details. A Thank you for your feedback! message will appear for 5 seconds and then the pop-up form will automatically close, returning you to whatever AP context you were in when the Raise an Issue button was pressed.

    For the International Authoring Platform this creates a Devops Support (INFRA) ticket, which the Technical Team will assess, prioritise and respond to with appropriate notifications and follow-up actions (your patience is appreciated!).

    Alternatively, if you have decided not to raise an issue since opening the form, simply press Close in the form footer to immediately close the pop-up dialogue and return to your AP context.

    Close has no second chance!

    Be wary there is no guard on the Close action - as soon at it is pressed, any entered information is lost. If you want to preserve anything for a later submission please use your local environment cut/paste tools to capture anything essential first!

    Provide Feedback
    See Import extension language/dialect batch file formats for some examples of these files, including sample download .tsv files.

    Select Assignee (drop-down select list of all registered AP accounts)

  • Select Reviewer (drop-down select list of all registered AP accounts)

  • Number of Concepts Per Task (drop-down select list)

  • Select Import Type (drop-down select list; must match the upload file format)

  • Select Batch File (opens the browser's local file selector dialogue to specify a batch file for upload)

  • Create Tasks (inactive until a batch .tsv file is uploaded)

  • Cancel (closes the pop-up form without making any changes)

  • When all fields are defined, the Create Tasks button is enabled - press the button to upload the batch file start the import process.The imported changes are allocated to new tasks according to the number of change rows and the maximum number of concepts per task defined on the form, which has the following options: _5, 10, 15, 20, 15, 50, 100 (default), 200, 500.

    So, for instance if the source file contains 41 rows, and the number of concepts per task is set to 15, then 3 new tasks will be created, with the last one containing 11 changes, and the others 15 each.

    The default option of 100 is chosen so that most use cases only need one new task, but a smaller number may make it easier to review changes.

    If multiple tasks are created they are identified by reference numbers which are automatically suffixed to the Task Title.

    Following upload and processing of the batch file, successful complete of processing is indicated via a header notification for "All tasks loaded", newly created task(s) in the My Tasks listing, and a browser download .tsv file which contains the import result for each processed row from the uploaded batch source file.

    The example below shows a success result file for 3 description additions to existing published International concepts, adding Maori language translations in the New Zealand (NZ) extension:

    Following successful import, the changes made can be seen in the Authoring Platform by opening each related import task.

    On first opening the task, the edit panel will be empty, since no manual editing has occurred.

    Use the Switch to Feedback View context tab to see each modified concept in the To Review list.

    Loading the modified concepts into the Review Panel highlights their changes, in exactly the same way as those made manually via regular editing.

    The example shown here shows two NZ extension description changes made via batch import.

    Another example showing two NZ extension description inactivations made via batch import.

    Another example showing three Maori translated terms added to existing International published concepts, with the new descriptions added to the NZ extension module.

    (Google translations of en-US terms into Maori are for illustration purposes only!)

    Provide Feedback
    View in Taxonomy
    button
  • Clone this concept button

  • Remove from Project Favourites button

  • Project Favorites actions function in exactly the same way as their Saved List counterparts described in Add a concept to my task Saved List and act on saved concepts, with the notable exception of Remove from Project Favorites which does exactly as it says, as soon as it is pressed.

    Removing a concept from the Project Favorites list by mistake

    If a concept is removed by mistake and it is not in the Task View - Saved List then it is probably wise to go back to Search, add it into the Task View - Saved List, and then add it back into Project Favorites (in case another task within the project still needs to use it).

    Provide Feedback

    A "Classification is RUNNING" notification follows once the Classification Service has received the task details.

    In the initial stage of classification, the task content branch is locked to prevent any further changes, and a warning notification is presented above the Classify action button in the Task Details panel.

    Whilst this warning is present, changes cannot be made to the content saved in the task branch, and action buttons other than Edit Task Details become inactive.

    Whilst classification is running, a status icon is presented in the page header, to the right of the task identifier.

    When the task classification is completed, a header notification is presented which includes a link to the Classification Report containing the classification results.

    EITHER

    Follow the link in the header notification to open the Classification Report.

    OR

    Press View Classification (completed <em>< date-time-stamp></em>) in the left-hand button bar Classification sub-menu.

    The Classification Report is presented in place of the Edit Panel, Concept Diagram, and left-hand context panels.

    This contains the following:

    • Header bar with

      • Report label showing "Classification finished at < date-time-stamp>".

      • Download Classification Results

    Each result can be previewed to confirm/review the changes prior to saving the classification results.

    See for details.

    Classification results can be downloaded to your local machine in .tsv format.

    The download file contains each classification result on a new line (line 1 is a header line with field labels) with tab-delimited field values for changeNature, sourceId, sourceFsn, typeId, typeFsn, destinationId, destinationNegated, characteristicTypeId, group, id, unionGroup and modifier.

    Press Accept Classification Results to save the classification changes to the task.

    A "Saving classification" header notification is presented whilst the results are saved to the task branch on the Terminology Server.

    A "Classification saved" header notification indicates changes are now in the task branch contents, and the Accept Classification Results button becomes deactivated with the label changed to Classification saved.

    From this point the report can still be retrieved (via the left-hand button bar Classification sub-menu) for viewing and downloading of results, but no further changes are possible with this set of results.

    If further changes are made in the editor, another classification must be run to pick up those changes.

    Provide Feedback

    Either

    Press Classify in the Task View - Task Details panel actions button list.

    Or

    Press Run New Classification from the left-hand button bar Classification sub-menu.

    A "Starting classification for task <task-id>" notification is presented in the page header.

    Provide Feedback

    EITHER

    Load a concept from the Taxonomy listing: Single-Press a node label to load that concept into the Edit panel.

    OR

    Load a concept from Search results :Press the search result FSN term (Edit) to open the concept in the Edit panel.

    New concepts created in the task

    New concepts created in the task may be tricky to get back into the Edit Panel if removed but not added to the task Saved List for later easy retrieval.

    If removed unintentionally before adding to the Saved List, concepts created in the task can be found in the To Review list in the Feedback View (even if not yet submitted for review).

    From the Feedback View - Preview Panel, each concept's FSN and/or SCTID can be retrieved and used to copy/paste into the text search query box to list it in search results.

    The concept loaded in the Edit panel shows two distinct content panels:

    • Concept Diagram view of the concept in various forms of logical modelling.

    • Concept Editor with its active descriptions and axiom details, and various options for editing/modifying the concept, either via action icon buttons in the concept header (which act on the entire concept) or via controls associated with each description and axiom.

    Concept Diagram actions are:

    A "Promoting task..." notification is presented in the page header whilst branch content changes are merged to the project level.

    During promotion, the task content branch is locked to prevent any further changes, and a warning notification is presented below the Edit Task Details action button in the Task Details panel.

    Whilst this is present, changes cannot be made to the content saved in the task branch, and action buttons other than Edit Task Details and Submit for Review become inactive.

    Once task promotion is completed, a "Task successfully promoted for <task-identifier>" notification is presented in the page header.

    Following promotion no further changes are allowed on the task content branch, all action buttons in the Task Details panel become inactive, and a warning notification is presented below the now inactive Edit Task Details action button.

    Provide Feedback

    Press Promote This Task to the Project in the Task View - Task Details panel actions button list.

    A "Preparing for task promotion" notification is presented in the page header, and the Promote This Task to the Project button is disabled.

    Task promotion has implicit checks for the following conditions:

    • No content changes made in the task.

    • Classification has been run in the task.

    • Classification was started but either failed to complete or has not completed.

    When the form fields are ready:

    EITHER Press Create Task

    OR Press Create and Open Task

    A full-width "Creating task..." notification banner appears above the call to action buttons (which are greyed out) whilst the task is being set-up - this typically takes a few seconds.

    On completion, a "Task initialization complete" notification banner is presented in the page header.

    If Create Task was used, then the pop-up form will close and the original underlying Dashboard My Tasks view will be restored. The new task title will appear in the task list.If Create and Open Task was used, then the pop-up form will close and the task will be opened as if its listing entry link had been followed from the Dashboard - My Tasks view, allowing authoring to start immediately within the task.

    Provide Feedback

    From the Dashboard - My Tasks view:

    EITHER Press New Task in the left-hand menu bar.

    OR Press the blue circular + button in the upper right corner of the Dashboard - My Tasks content panel.

    The Create New Task pop-up form is presented, centred on the page and overlaying the Dashboard - My Tasks view which is dimmed but still visible "below" the form.

    This form has three content entry fields, and three calls to action at the bottom of the form:

    • Task title field (required).

    • Select project drop-down list selector (required).

    • Task Details optional multi-line rich text field, with a sub-menu for formatting selected contents as bold font, italic font, button list, and numbered sequential list.

    • Create Task button.

    • Create and Open Task button.

    • Cancel button.

    The pop-up form also has a small X button in its top right corner. This has the same effect as the Cancel button.

    Enter a single line Task title for identification of this task in the Authoring Platform.

    Press Select project to see an overlaid list of all available projects on the Authoring Platform. Pick one from the list by moving the cursor to its title and pressing it, or using the keyboard up-arrow / down-arrow buttons to scroll the list and then press Enter on the desired selection.

    Enter some further descriptive text in Task Details and use the text formatting options menu to enhance readability if desired (select some text within the field, then press the desired option button in the menu). This field is optional and can be left blank but some additional background information on the task can often be useful, particularly if many tasks end up with similar titles.

    Press Primitive or Fully-defined to see the Concept Information (as described in ).

    Press the Preferred Term to open the concept in the Edit Panel.

    Press View in Taxonomy to open the Taxonomy view focused on that concept.

    Press Add to Project Favorites to extend the Project Favorites List with that concept.

    Project favourites are immediately available for all tasks within the same project.

    If any concepts have been saved as a project favorite in any task within the project, then all tasks int hat project will show the Project Favorites list in their Task View - Saved List (the Task View web page may need to be refreshed to pick up any changes made by others whilst it remains open in the web browser, but it automatically picks up changes when first loaded).

    Press Clone this concept to create a new unpublished concept with the same lexical model and logical model content as the search result.

    This is equivalent to creating a new unpublished concept and entering all of its terms and relationships via search/lookup, so can be quite a time-saver.

    Press Remove from saved list to do just that!

    Provide Feedback

    Press Add to Saved List in a search result.

    This extends the current Task View - Saved List to include the search result concept, but does not move away from the search results (in case other actions are needed on other results).

    Once a concept has been added then Add to Saved List is no longer active for that search result (so it can only be added once).

    Press Saved List in the Task View header tabs.

    This opens the Task View - Saved List , showing the concept that was added.

    Each item in the list has the following:

    • Primitive or Fully Defined button (status definition icon)

    • Preferred Term

    • View in Taxonomy button

    • Add to Project Favorites button

    • Clone this concept button

    • Remove from Saved List button

    Following the review check, the task is then placed in a promotion automation queue.

    A notification panel showing "Automated promotion in progress: Status Queued" is presented between Edit Task Details and Classify in the Task View - Task Details panel actions button list.

    An "Automated promotion: Queued" status icon is also presented in the page header bar.

    When picked up from the queue, the task is checked to see if needs to be rebased.

    If the task content is diverged from its parent project content, the process initiates a task rebase, and the notification panel changes to "Automated promotion in progress: Status: Rebasing".

    If rebase completes with no conflicts, the auto-promotion process continues.

    After confirming that the task does not have any rebase conflicts, classification is invoked to ensure all content changes are classified prior to promotion.

    The process notification panel changes to "Automated promotion in progress: Status Classifying"

    The page header bar icon changes to "Classification Running".

    Once the promotion automation invokes the classification process, the My Tasks view task Status column entry changes to Auto Classifying.

    If classification detects results (unclassified task content), a header notification states that classification completed successfully with changes found.

    If classification does not detect any changes, a header notification states that classification completed successfully with no changes found.

    The automation process proceeds with task promotion, following which a header notification states that automated promotion completed for the task.

    At this point task actions become inactive, and the process notification panel changes to inform that the task has been promoted and no further changes are allowed.

    Promoted tasks are hidden by default in the My Tasks view, however they can be brought into the view listing by checking the Show Promoted checkbox.

    Their task status shows Promoted, with a blue background.

    All historical promoted tasks are shown when the box is checked, not just the most recently promoted.

    Provide Feedback

    After making the desired content changes, press Begin Promotion Automation in the Task View - Task Details panel actions button list.

    A "Preparing for task promotion automation..." notification is presented in the page header bar.

    Unmet SAC items block automatic promotion

    If the task has any Service Acceptance Criteria (SAC) items, task promotion will be blocked and the Begin Promotion Automation action button will not be enabled until all mandatory task-level SAC are met.

    Role-based access controls apply to automatic promotion

    If the user's authenticated account session roles do not include permissions for task promotion (such as when viewing another author's task), the Begin Promotion Automation action button will not be enabled.

    The automated promotion process first checks to see if the task has been reviewed.

    If a review has not yet been completed the Promote Task dialogue presents a warning message with calls to action to either continue or return to task editing and cancel the promotion.

    Press Promote Anyway to continue the promotion process.

    Press Return To Task to close the dialogue and stop the promotion process.

    Task review check

    The warning is only presented if a review has not been completed.

    Task status

    After pressing Begin Promotion Automation, the My Tasks view task Status column remains In Progress until the review check is completed.

    Find the desired applicable attribute name in the Applicable Attributes panel listing.

    Press the name to change the context of the Attribute Range panel to those matching the attribute, and also show the Attribute Details sub-panel at the base of the Applicable Attributes panel. The selected attribute name is highlighted.

    The Attribute Details sub-panel shows values for:

    • Grouped

    • Attribute Cardinality

    The Attribute Details sub-panel can be toggled closed/open when an attribute is selected.

    When open, press on the right of the sub-panel title bar to close the Attribute Details sub-panel.

    When closed, press in the sub-panel title bar to open it.

    Provide Feedback

    Find the desired domain name in the Domain panel of the MRCM Maintenance Tool.

    Press the name to change the context of the Applicable Attributes panel to those matching the domain, and also expand the Domain Details sub-panel at the base of the Domain panel. The selected domain name is highlighted.

    The Domain Details sub-panel contains:

    • Domain Constraint

    • Parent Domain (sub-domains only)

    • Proximal Primitive Constraint

    • Guide URL

    • Precoordination Domain Template

    • Postcoordination Domain Template

    The Applicable Attributes list can be filtered by typing a text pattern into the Filter Attributes... box. As soon as text is entered, the attributes list will update to only show those matching the filter text.

    If a sub-domain is selected, the Applicable Attributes results will show all those applicable to its parent domain, however only those applicable to the selected sub-domain will be active in the list.

    Any attributes not applicable to the selected sub-domain will be inactive, and moving the cursor onto them will show a symbol, indicating they cannot be viewed for the selected sub-domain.

    Enter a target template name in the Select Transformation Target field.

    Type-ahead search results will show name matches after three characters are entered.

    Pick a template from the available list.

    The Transform button in the bottom right corner of the dialogue will become active (its background colour changes from grey to blue).

    Choose a reason from those presented in the Select Description Inactivation Reason options:

    • Non-conformance to editorial policy (default selected)

    • Outdated component

    • Erroneous component

    Press Transform to start the transformation, or Cancel to close the dialogue with no changes saved.

    The Transforming Concepts notification will occupy the pop-up window.

    Wait for the transformation to complete.

    On completion, the pop-up dialogue will close automatically, and view context will change to the Batch Processing tab, showing the selected transformed concept(s), in the same manner as for batch creation from a template.

    Use the Edit Full Concept button on the batch entry row to present a "before/after" side-by-side view of the concept transformation.

    At this point the transformation is only a preview - no changes have been saved.

    If changes are not what was expected/required, then the previewed concept can be removed from the batch listing using the button at the start of its row entry in the batch list.

    After previewing (and if necessary removing unwanted concept transformations from the batch), press Save All in the upper right corner of the batch view.

    The Saving Batch pop-up notification will be presented - please wait while the transformation batch is saved, and do not navigate away or refresh the page (as it instructs).

    Alternatively, should the entire transformation batch need to be abandoned, press the Discard All button in the batch view.

    This will cancel the batch transformation and no changes will be made to the concepts.

    After the transformation batch has been saved, press the blue Return to Task button to close the Saving Batch pop-up notification.

    At this point the template transformations are complete, and the selected concepts are changed in the task.

    The view context remains on the Batch Processing tab - from here proceed as needed to other AP features (for instance to task review for approval of the concept transformations - the transformed concepts will appear in the feedback tab To Review list).

    Provide Feedback

    Press the <i class""fa-magnifying-glass">:magnifying-glass: Search button to the right of the query box, or press Enter on the keyboard.

    Whilst the search is running, the results panel shows "Searching...".

    Complex ECL queries

    Complex ECL expressions which require analysis of many hundreds or even thousands of nodes may take some time to execute - from a few seconds to a minute or perhaps longer for extreme cases (for instance searching for all leaf nodes in SNOMED CT can take up to a minute).

    Working with ECL search results

    ECL search results are formatted and presented in the same way as text search results.

    See and for more information.

    After obtaining ECL expression search results, the results set can be refined by entering an additional term filter in the query box below the expression.

    For example the ECL expression >!* returns all concepts that are leaf nodes.

    By adding an additional term filter a particular set of matching leaf nodes can be found, such as all leaf nodes containing the word "limb" in their FSN.

    Changing ECL search parameters triggers the search

    Whenever the ECL expression or additional term filter is modified, or the Inferred / Fully Defined / All or All / Primitive / Fully Defined options are changed, a new search will be triggered.

    ECL search results can be switched between the Inferred (default) and Stated view.

    ECL search results can also be filtered by their Definition Status:

    • All (Primitive and Fully Defined)

    • Primitive

    • Fully Defined

    Provide Feedback

    The Promote concept pop-up dialogue box is then presented, with the concept SCTID and FSN noted in the dialogue header, and a notification that dependencies are being checked against this concept.There are two possible check outcomes:

    • No dependencies found

    • Dependencies are found

    If no dependencies are found, the Promote concept notification box is updated accordingly, and option buttons to Cancel or Continue are presented.

    Press Cancel to return to concept editing without requesting promotion.

    Press Continue to make the promotion request.

    If dependencies are found, a tabulated list of the dependencies are shown in the dialogue box, followed by option buttons to Cancel, Continue without Dependencies, or Continue with Dependencies are presented.

    Press Cancel to return to concept editing without requesting promotion.

    Press Continue without Dependencies to make the promotion request for just the request concept itself.

    Press Continue with Dependencies to make the promotion request including all the listed dependency concepts as well as the request concept.

    Stated dependencies only

    Listed dependencies in the promotion popover dialogue are Stated only (not Inferred).

    The form processing triggers a new content request in the International CRS platform, with a related AP header notification.

    Following creation of a linked International CRS request, the AP header notification is updated to include the CRS ticket reference.

    A CRS Request section with the reference link is added to the Task Details (the CRS ticket number is the link text).

    Follow the link to open the International CRS request ticket.

    International CRS access

    The CRS link expects the requisite group memberships are already granted to the AP Author's account for the International CRS platform to view the linked CRS request details.

    Additional permissions may need to be requested via Technical Support if this is not the case.

    At this point the promotion request is completed in the Authoring Platform, and fulfilment of the request moves to the International CRS platform process flow.

    The linked CRS ticket includes the extension promotion request concept details.

    If Continue with Dependencies was followed, the linked CRS ticket includes the extension promotion request concept and its dependencies details.

    caret-up

    Published unedited concepts only

    The Request Promotion option only appears if the concept has been published in an extension release.

    Previously published concepts modified in the extension since publication cannot be promoted to the International Edition until after re-publication in the extension.

    Pressing Request Promotion on a previously published concept that has subsequently been changed but not yet re-published will present an error notification in the concept header, with the related change(s) highlighted in the editing panel:

    If this concept needs to be promoted to the International Edition before the next local extension release, the concept can be reverted to its published version to allow the promotion request to proceed.

    Of course any local extension changes made since publication are then discarded, so that may have to be considered when the International CRS promotion request is reviewed.

    Provide Feedback

    Follow the instructions in the first tab to define a set of changes in the appropriate sheet tab, then download that tab as a local file in .tsv (tab separated values) format.

    Once the desired changes are specified and available in a local .tsv file, return to the Upload a Batch dialogue to specify the upload with:

    • Task Title

    • Select Assignee (type-ahead search for names list)

    • Number of Concepts per Task (select from preset list, default is 100)

    • Enable Drools Validation (optional)

    • Select Project (from available projects list)

    • Select Reviewer (type-ahead search for names list)

    • Select Import Type (from available list matching the Batch Upload template change type tabs)

    • Select Batch File (invokes your local machine's file selection dialogue to pick the relevant .tsv file)

    When all required parameters are defined, the Create Tasks button will be enabled.

    Press Create Tasks to start the batch upload process.

    On successful completion of the batch upload, the Batch Upload Complete header notification will appear, and a local machine file save dialogue box will be presented to allow local saving of a batch results .tsv file with the outcome of the upload process.

    Opening the batch result .tsv file on your local machine will show tab separated values with a row corresponding to each change row in the upload file. The final column of the results data indicates the outcome of the upload for that row (true for success).

    The My Tasks dashboard view will also be updated to show the task(s) created by the batch upload, which carry the related content changes.

    If an error is encountered during batch processing of particular rows, whilst other changes are successful, the Batch Upload Completed With Errors header banner will be presented.

    In either of these failure cases, a batch result .tsv file is generated.The local operating system file download dialogue is invoked to allow saving of the batch result file.

    Inspecting the batch result file shows further information to help understand the failure cause(s) for the rows which could not be processed successfully.

    If the batch upload process fails during parsing of the upload file, the Batch Upload Failed header notification will be presented.

    The header notification includes additional diagnostic information, but a results file is not generated.

    Out of date batch template format

    This scenario may be caused by trying to upload batch changes using an earlier version of the template file rather than the latest version expected by the Authoring Platform. The screenshot shows an example of the error message when this occurs.

    To resolve this error condition, download the latest version of the template (described above), and enter and save the required change data using the updated specification format, and then repeat the upload process with the updated format file.

    Provide Feedback

    Select a template from the drop-down selection box.

    The selected full template name is placed into the query box and a search commences for matching concepts.

    The phrase "Searching..." shows in the results panel until results are available.

    When matches are found the search results list all concepts that match the selected template, with the default options of:

    • Stated view

    • All definition statuses ( Primitive and Fully defined )

    • Logical model matches

    The default Template search finds matches in the Stated view, however this can be switched to Inferred view matches using the drop-down view mode selector.

    The Def. (definition status) results filter option defaults to All ( Primitive and Fully Defined ) but also allows Primitive only and Fully Defined only matches to be listed in the search results.

    A third results filter supports matching different aspects of the concept modelling defined by the selected template:

    • Logical (default) - concepts which match the logical model regardless of their lexical content.

    • Logical and Lexical - concepts which match both the logical and lexical models.

    • Logical not Lexical - concepts with the same logical model but which do not conform to the lexical model.

    • /ul>

    Provide Feedback

    Press Promote to promote the project contents to the mainline branch.

    A "Preparing for project promotion..." notification is presented in the page header.

    On completion of the promotion process, a "Project successfully promoted for " notification is presented in the page header, and the Project-level SAC are reset (if so configured in their definition - see the info panel), ready for the next cycle of project content updates.

    SAC Definitions and Acceptance Roles

    Usual configuration practice is to set Project-level SAC to automatically reset to the "unsatisfied" state when project content is promoted to the parent mainline branch. This is in anticipation of subsequent, often repeated, project content updates from its authoring tasks, within each mainline release version authoring cycle. Such resetting ensures that these checks are re-confirmed before promoting project content, and hence reduces the risk of unexpected content changes reaching the project mainline.

    However, since this is a configuration option, there may be scenarios in which the "satisfied" status is maintained across project promotions once it has been set. Such authoring process decisions are the remit of those with the PROJECT_MANAGER and/or PROJECT_LEAD role(s) to identify and confirm for the relevant content releases.

    SAC Definitions and Acceptance Roles

    With more frequent delivery of SNOMED CT releases, project-level SAC are an essential aspect of the International Edition content quality control process. However, it is technically feasible for projects not to have project-level SAC defined, and some may have Manual SAC but no Automated SAC or vice versa.

    Project-level (and task-level) SAC definitions can be set by those who have the PROJECT_MANAGER role, usually in close consultation with those in the PROJECT_LEAD and RELEASE_LEAD roles.Individual user accounts may also be granted more than one access control role (via membership of the appropriate access control groups).

    Provide Feedback

    Press the caret-down caret-down icon button to the right-hand side of the category selector to show a drop-down list of project categories.

    Select a category.

    The search results are filtered to only show projects matching the search query which are also in the selected category.

    If more than one category is available, select another to filter the same query on a different category.

    The results then only show those matching the query which are also in the new selected category.

    Project search queries and matches

    The All Projects search query will return any project that matches the query string in any of the following project details, not just the project name:

    • key (project key)

    • title (project name)

    • project lead (account name)

    • project lead (display name)

    Provide Feedback

    Task title

    As well as searching for task names (either partially or fully entered in the search query), you can also enter a specific task ID if known. If a task is matched to an ID then only that task is presented in the results panel. Note searching via ID cannot find partial matches - a result will only be found if the entered ID is an exact match to an existing task ID.

    Task title

    There is no second chance if you press a task name link. When the task opens in the Edit panel, the task search results are gone, so the previous search would need to be repeated should you need to get back to them. If this is not desired, please use the Open in new Tab option!

    Project rebase issues

    Project merges generally complete without issues, however some conditions such as a component integrity issue may occur, for instance where a dependent concept is missing or inactivated unintentionally.

    These situations may trigger a red alert box overlay in the page header with an indication that technical support should be sought to resolve the problem. The message below shows an example of a missing or inactive referenced concept in an axiom triggering a rebase problem:

    If the terminology server encounters such an issue when trying to merge project and mainline content, it may roll back changes to restore the pre-rebase branch states to avoid leaving them in an unusable condition. As the message states, please contact technical support if such an alert occurs.

    Promote my (complex) task changes to their parent project (share with other authors)

    Steps
    References

    The Complex slider control in the upper-right of the Task View - Task Details panel defines whether or not a task is Complex.

    Move the Complex slider to the right to set the task as Complex.

    This activates any task-level >Service Acceptance Criteria (SAC)> which are defined within the parent project SAC configuration.

    Task-level SAC are presented in two lists, between the Task Details section and the Edit Task Details button in the Task View - Task Details panel, and are common to all Complex tasks within the project.

    Automatic Task-level SAC are listed to the left, with >Manual Task-level SAC to the right.

    Automatic SAC have a yellow warning triangle icon if not yet met, and a green tick if their automated system checks confirm they are satisfied.

    Manual SAC are presented initially as open checkboxes, each of which can be interactively checked (green-ticked) when the user's role-based access permissions match those configured for that SAC control.

    Once task promotion is enabled, follow the non-complex task steps (included below) to complete promotion of the task.Although the screenshots show simple tasks without task-level SAC, the steps to promote once it is enabled are the same for all tasks.

    Steps
    References

    Promote my (batch) task changes to their parent project (share with other authors)

    Steps
    References

    Batch upload tasks are identified as such during the upload and task creation process.

    When identified as a batch task, the Batch label appears in the upper-right of the Task View - Task Details panel.

    The batch task identification activates the task-level Service Acceptance Criteria (SAC) item Validation Report Clean which is defined within the parent project SAC configuration, as a mandatory manual acceptance item.

    Manual SAC are presented initially as open checkboxes, each of which can be interactively checked (green-ticked) when the user's role-based access permissions match those configured for that SAC control.

    Once task promotion is enabled, follow the non-complex task steps (included below) to complete promotion of the task. Although the screenshots show simple tasks without theBatch label or task-level SAC, the steps to promote once it is enabled are the same for all tasks.

    Steps
    References

    Search using an extension language or dialect

    Steps
    References

    When searching, the search query will match against any content, including translated terms, and the default search results presents the matched concepts using the Preferred Term in the first available extension language or dialect.

    The search results panel is initially empty, awaiting entry of a search query (type at least three characters to trigger type-ahead searching).

    Extension authoring search has two additional filtering options (not available in International authoring), to focus the results based on:

    • Language Reference Set membership (multiple combination options).

    • Extension language or dialect Preferred Terms (single selection option).

    These are available below the Active Only

    To constrain the search to a specific language reference set, press the Language Refsets multi-option selector, and make a selection of any combination from those available.

    The search results will only show matches to content found in the selected language reference sets.

    The screenshot example shows the options available in the ms-belgium extension, which are:

    • US English

    • Belgian French language reference set

    Run an existing report

    Steps
    References

    Press Run New Query in the right-hand top corner of the report description panel. This opens the Report Details form in a pop-up dialogue box.

    Each report type has a relevant set of query parameters which may be specified.

    Example Report Details form: Term Contains X

    This query takes the following values:

    • Subhierarchy - a constraining sub-hierarchy of SNOMED CT to limit the query scope.

    • Starts With - if this is checked the Words value must occur at the start of a term.

    Resolve upgrade integrity issues (Integrity Report resolution)

    Steps
    References

    Import extension language/dialect batch file formats

    Here are some example .tsv translations (New Zealand) batch upload files:

    Concept ID
    GB/US FSN Term (For reference only)
    Translated Term
    Language Code
    Case significance
    Type
    Language reference set

    Rebase my task from the project (synchronize changes in its parent project since task creation)

    Steps
    References