Page History

excerpt

Info

title	In this page:

How to promote a task to to 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

class	user-guide-steps-references

When a task is flagged as Complex (via the control slider control in the upper-right of the Task View - Task Details panel), it will activate any task-level Service Acceptance Criteria (SAC) defined for the parent project.

Confirm that all mandatory task-level SAC conditions are met.

Until these are met, task promotion will be blocked and Promote This Task to the Project in the Task View - Task Details panel actions button list will not be enabled.

Task View - Task Details

Excerpt

When all mandatory task-level SAC conditions are met for a Complex task then

Steps	References

Task promotion is enabled when certain content checks have been satisfied.

The most basic and perhaps obvious of these is that the task branch content must be ahead of the project parent branch, in other words it contains content changes to promote. This test is implicit in the AP user interface in that project promotion controls remain inactive until there is something to promote from the task.

For non-complex tasks (those for which the Complex slider control is not set to enabled), this is the only pre-requisite to enabling task promotion.

Info

title	International Authoring - Task SAC - Examples

Excerpt Include

Service Acceptance Criteria (SAC) and Authoring Acceptance Gateway (AAG) controls Service Acceptance Criteria (SAC) and Authoring Acceptance Gateway (AAG) controls

nopanel true

Press Promote This Task to the Project in the Task View - Task Details

will be enabled.When promotion is enabled, press Promote This Task to the Project in the

panel actions button list	Image Added
A "Preparing for task promotion" notification is presented in the page header, and the `Promote This Task to the Project` button is disabled.	Image Added
Task promotion

also

has implicit

warning

checks for the following conditions

(in addition to the task branch content pre-requisites and mandatory task-level SAC defined for the project):

Task changes have been classified.

:

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 are current (no content changes since last classified)

.
Classification results have been accepted.
Review has been completed.

If 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

these

the other conditions are not yet satisfied

, then attempting promotion will trigger a warning notification, with the option to Return to Task without promoting

when promotion is initiated, a Promote Task pop-up notification shows their statuses, with action options to cancel the promotion, or to continue if task changes are considered sufficiently safe to

go 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

title	Promoting tasks with warnings

Pressing Promote Anyway is tacit acceptance of any warning statuses, with implied responsibility for by-passing these safeguards and the consequent unclassified and/or unreviewed 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 be acceptable.

By-passing review may also be acceptable under particular circumstances, for instance if the author is also the project manager / project lead. Note that this scenario can be prevented by setting the task as Complex and also having Review Completed set as a mandatory task-level SAC requirement within its parent project configuration, since task promotion in this case will not be enabled without a completed review.

Image Added

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.

Image Added

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.

Image Added

Page tree

Versions Compared

Old Version 4

New Version Current

Key