# 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-b46da546a04c79a83610536e409052da1a706a3c%2F137237974.png?alt=media" alt=""><figcaption></figcaption></figure></div> |
| <p>Move the <code>Complex</code> slider to the right to set the task as <em>Complex</em>.<br></p><p>This activates any task-level <strong>>Service Acceptance Criteria (SAC)</strong>> which are defined within the parent project SAC configuration.<br></p><p><strong>Task-level SAC</strong> are presented in two lists, between the <em>Task Details</em> section and the <code>Edit Task Details</code> button in the <em>Task View - Task Details</em> panel, and are common to all <em>Complex</em> tasks within the project.<br></p><p><strong>Automatic Task-level SAC</strong> are listed to the left, with <strong>>Manual Task-level SAC</strong> to the right.<br></p><p>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.<br></p><p>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.</p> | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-aad9252d03b06d47abd84cff52c0033c93ed98b1%2F137237975.png?alt=media" alt=""><figcaption></figcaption></figure></div> |
| <p>Until <strong>all mandatory task-level SAC</strong> are met, task promotion will be blocked and <code>Promote This Task to the Project</code> in the <em>Task View - Task Details</em> panel actions button list will not be enabled.<br></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Role-based access controls apply to manual task-level SAC</strong><br></p><ul><li>Early Visibility Notice if Required</li><li>Manual spell check</li><li>Review complete</li><li>RVF Report Clean</li></ul></div><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>International Authoring - Task SAC - Examples</strong><br></p><p>If the user's authenticated account session roles do not include edit permissions for the task (such as when viewing another author's task), the current manual SAC status will be shown, but cannot be set.</p></div>                                                                                                            | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-3ec5b5593bb69bbf387587ba96bbfc7f33e27f3f%2F137237977.png?alt=media" alt=""><figcaption></figcaption></figure></div> |
| <p>Press a manual SAC checkbox to toggle its status.<br></p><p>It will show a green ticked box when checked, indicating its condition is met.<br></p><p>When all mandatory task-level SAC conditions are met for a Complex task then promotion is enabled and <code>Promote This Task to the Project</code> in the <em>Task View - Task Details</em> will become active.<br></p><p>The example shown in the screenshot shows a <em>Complex</em> task which requires a review to be completed ("Review complete" mandatory automated Task-level SAC) and also for the author to confirm that the task validation report has no task-level RVF assertion failures ("RVF Report Clean" mandatory manual Task-level SAC).</p>                                                                                                                                                                                                                                                                                                                                       | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-3794b0d21f6a4e7ec003d5fa389af0c1b00a6a4f%2F137237978.png?alt=media" alt=""><figcaption></figcaption></figure></div> |

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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Press `Promote This Task to the Project` in the *Task View - Task Details* panel actions button list                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-5f41ab19fb2572dafa34e7aee0e43fcdec5337b6%2F137237989.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| A "Preparing for task promotion" notification is presented in the page header, and the `Promote This Task to the Project` button is disabled.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-c8a3670b732ce31ce6ae993481fa6503b45b3d7e%2F137237987.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p>Task promotion has implicit checks for the following conditions:<br></p><ul><li>No content changes made in the task.</li><li>Classification has been run in the task.</li><li>Classification was started but either failed to complete or has not completed.</li><li>Classification is current.</li><li>Classification has no results to accept.</li><li>Classification results have been accepted.</li><li>Review has been completed.</li></ul><p>If no content has been changed on the task when promotion is initiated, a <em>Promote Task</em> pop-up notification states the there are no changes to promote.<br></p><p>Press <code>Return to Task</code> (or press the <code>X</code> in the upper right corner) to close the pop-up.<br></p><p>If content changes have been made but any of the other conditions are not yet satisfied when promotion is initiated, a <em>Promote Task</em> pop-up notification 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.<br></p><p>Press <code>Return to Task</code> (or press the <code>X</code> in the upper right corner) to close the pop-up and cancel the promotion without changing project content or the task status.<br></p><p>Press <code>Promote Anyway</code> to continue promotion.<br></p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Promoting tasks with warnings</strong><br></p><p>Pressing <code>Promote Anyway</code> 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.<br></p><p>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).<br></p><p>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.<br></p><p>By-passing review may also be acceptable under particular circumstances, for instance if the author is also the project manager / project lead.<br></p><p>This scenario can be prevented by setting the task as <em>Complex</em> and also having <em>Review Completed</em> 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.</p></div> | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-5fc25779ddf2ec79feeda3adeee9713716f14f87%2F137237957.png?alt=media" alt=""><figcaption></figcaption></figure></div><div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-6fa58edfab7ad080ee520a329eceb410c2e16fe6%2F137237958.png?alt=media" alt=""><figcaption></figcaption></figure></div><div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-72828cc85f7e15df97346c43b24294d1b69db8ec%2F137237948.png?alt=media" alt=""><figcaption></figcaption></figure></div><div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-2b55d588423db936540f6c46d43842ad5f9dddac%2F137237951.png?alt=media" alt=""><figcaption></figcaption></figure></div><div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-74216526fc93ef72e11158884b5b1fb46ccbce38%2F137237949.png?alt=media" alt=""><figcaption></figcaption></figure></div><div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-078a24166d42ea8d785bf7342679518ba8c64e0f%2F137237952.png?alt=media" alt=""><figcaption></figcaption></figure></div> |
| <p>A "Promoting task..." notification is presented in the page header whilst branch content changes are merged to the project level.<br></p><p>During promotion, the task content branch is locked to prevent any further changes, and a warning notification is presented below the <code>Edit Task Details</code> action button in the <em>Task Details</em> panel.<br></p><p>Whilst this is present, changes cannot be made to the content saved in the task branch, and action buttons other than <code>Edit Task Details</code> and <code>Submit for Review</code> become inactive.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-b30d4aa21b729fea0d222070aaa62597f28a0b9b%2F137237953.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p>Once task promotion is completed, a "Task successfully promoted for <em>\<task-identifer></em>" notification is presented in the page header.<br></p><p>Following promotion no further changes are allowed on the task content branch, all action buttons in the <em>Task Details</em> panel become inactive, and a warning notification is presented below the now inactive <code>Edit Task Details</code> action button.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-a57336e347bf6f5072f0f5e6783bf99d5d9a8744%2F137237954.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

<a href="https://docs.google.com/forms/d/e/1FAIpQLScTmbZIf0UEQwYDkY27EEWBkaiYkHSbR0_9DmFrMLXoQLyL7Q/viewform?usp=pp_url&#x26;entry.1767247133=AP+UG&#x26;entry.670899847=Promote%20my%20%28complex%29%20task%20changes%20to%20their%20parent%20project%20%28share%20with%20other%20authors%29" class="button primary">Provide Feedback</a>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.snomed.org/snomed-ct-user-guides/authoring-user-guide/how-to/task-rebase-and-promotion/promote-my-complex-task-changes-to-their-parent-project-share-with-other-authors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
