Authoring Platform Version 6+ User Guide

Page tree

Versions Compared

Old Version 11

changes.mady.by.user Steve Archbold

Saved on

compared with

New Version 12

changes.mady.by.user Steve Archbold

Saved on

Key

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


Info
titleIn this page:

How to promote a non-complex task (one without SAC / AAG controls) to include its changes in the parent project. This process updates the project level with concepts created or modified in the task, which can then be taken into other tasks via their rebase from the project, and also promoted to MAIN via the project, for inclusion in the next SNOMED CT release.



Advanced Tables - Table Plus
classuser-guide-steps-references


Excerpt


StepsReferences
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.

Task promotion has implicit warning 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.
  • Classification is current.
  • Classification has no results to accept.
  • Classification results have been accepted.
  • Review has been completed.

If

any of these

no content has been changed on the task when promotion is initiated, a Promote Task pop-up notification states the there are no changes to promote. Press Return to Task (or press the X in the upper right corner) to close the pop-up.

If content changes have been made but any of the other conditions are not yet satisfied

, then preparing for promotion checks trigger a

when promotion is initiated, a Promote Task pop-up

warning

notification

showing

shows their statuses, with action options to cancel the promotion, or to continue if task changes are considered sufficiently safe to update the project level content without satisfying these conditions.

Press  Return to Task (or press the X in the upper right corner) to close the pop-up and cancel the promotion without changing project content or the task status.

Press Promote Anyway  to continue promotion.

Note
titlePromoting despite warnings

Promote Anyway  is tacit acceptance of any warning statuses, with implied responsibility for by-passing these safeguards and the consequent content changes that will be promoted from the task to the project level.

Promoting unclassified content changes is a quality assurance risk that can be avoided relatively easily, since it typically takes less than ten minutes to run classification (if only to confirm no results). However there are occasions when it is clear that inferred classification results won't change, such as a description-only content change, in which case this option may save a little time if needed. 

By-passing review is another scenario where this option can save time, for instance if the author is also implicitly the reviewer or perhaps the project manager / project lead.


Image Added Image Added

 

 

A "Promoting task..." notification is presented in the 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 PROJECT-##" notification (where PROJECT-## is the task identifier) 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.