Authoring Platform Version 6+ User Guide

Page tree

Versions Compared

Old Version 8

changes.mady.by.user Steve Archbold

Saved on

compared with

New Version Current

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 automatically promote a task to include its changes in the parent project. This process simplifies the interaction steps needed to promote task changes to the parent project.



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


StepsReferences

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.

Note
titleUnmet 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.


Note
titleRole-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.

Info
titleTask review check

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


Info
titleTask status

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


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.


Warning
titleRebase merge conflicts block auto-promotion

If merge conflicts are found during rebase, the automatic promotion process is stopped, and the process notification changes to state that rebase conflicts must be resolved before restarting automatic promotion.



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.



Warning
titleUnclassified content blocks auto-promotion

If classification results are found, the auto-promotion process is stopped, and the process notification panel changes to inform that classification results were detected, with an instruction to review and accept classification results before restarting the auto-promotion process.


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. Note that all historical promoted tasks are then shown, not just the most recently promoted.