# Resolve upgrade integrity issues (Integrity Report resolution)

| Steps                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | References                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p>On first opening a task which has upgraded content, an <em>Integrity Report</em> check is triggered which scans the content for issues.<br></p><p>Whilst this is proceeding, the task content area shows the <code>Integrity Report check is running. Please Wait...</code> notice.<br></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Closing and re-opening a task with integrity issues</strong><br></p><p>After running an <em>Integrity Report</em> and detecting items with issues, any time the task is subsequently closed and re-opened (perhaps in a new session), the <em>Integrity Report</em> check will trigger.<br></p><p>Further task editing is not possible until all integrity check issues have been resolved.</p></div><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Automated integrity issue resolution</strong><br></p><p>Running the <em>Integrity Report</em> automatically resolves issues due to an inactive concept having an active description which is missing an "inactive concept" indicator, and also when an inactive description is referenced in a language reference 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-c31d3128086809b00612a64393cc2755aa6b65fd%2F110340597.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>On completion of the checks, if integrity issues have been found the <em>Integrity Report</em> view is presented.<br></p><p>This contains the following:<br></p><ul><li><p>Left-hand context tab panel, containing:</p><ul><li><em>Issues List</em> - all concepts with integrity issues, with select and preview actions</li><li><em>Search</em></li><li><em>Taxonomy View</em></li></ul></li><li><p>Right-hand concept preview/edit panel, showing:</p><ul><li><em>Prior Version</em> of the concept with issues</li><li>Suggested <em>Resolution</em> for the issue</li></ul><p><br></p></li></ul><p>The <a href="../task-taxonomy-and-concept-search/search-for-concepts-by-text-or-sctid-query">Search</a> and <a href="../task-taxonomy-and-concept-search/browse-the-taxonomy-to-locate-concepts">Taxonomy</a> tab views are the same as those available in the <a href="../dashboard/open-one-of-my-tasks-open-task-as-an-author">usual task view</a>, and are provided here to support investigation and location of alternative target concepts to resolve the integrity issue.<br></p><p>When first presented, this view automatically previews the first concept in the list (as indicated by the inactive status of its preview icon in the <em>Issues List</em>.<br></p><p>List paging controls and visible list size options are presented below the list.<br></p><p>Each concept in the list can be individually previewed and resolved via editing in the <em>Resolution</em> panel, but the platform can also apply the suggested resolutions automatically if they do not cause validation errors.</p> | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-7c075c975d4ae540b7ab68da5461fc093d3c1c52%2F110340598.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| To apply a suggested resolution to an individual concept, press the `Save and next` icon button in the Resolution panel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-58ea5b3b17037d379a8c7ca5969c47ff801bf47b%2F110340601.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| A header notification indicates that the concept is being saved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-81eca5d74cdda30c0d945a19e2e7dc4f50ece02e%2F110340602.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>Drools Rules warnings may appear briefly when saving the concept, but do not prevent saving.<br></p><p>Saved concepts can be reviewed later via the usual feedback and review process, so integrity resolution save warnings can be followed-up as needed.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-564ce323f7148d20f52b5bc2548854fc62babf57%2F110340603.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>After manually saving a concept, the next concept in the <em>Issues List</em> is automatically previewed for issue resolution.<br></p><p>The saved concept is removed from the list, and the Total Items count is decremented.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-68f5628131628d73e634f6322d02ee6501913861%2F110340604.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Once loaded, the new first item on the *Issues List* is previewed, ready to repeat the process for this next concept.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-c3fe47db64eaec4b9a825c579c522a28b65c2be0%2F110340605.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>As well as resolving each suggested resolution manually on a concept-by-concept basis, a number of concepts can be selected and processed automatically as a batch.<br></p><p>To do this, press the checkboxes alongside each desired <em>Issues List</em> item to define a batch list.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-67a82da751bb8edb8b273639d47a681f6722b6b8%2F110340606.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| With the desired concepts selected via their check-boxes, press the `Auto-fix` icon button to the upper-right corner of the *Issues List*.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-8b60a0d5e910a44723b79656958d17c8e5e9ef90%2F110340607.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| A header notification shows that the selected concept resolution suggestions are being saved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-65df52c9f83ed0834d73543de5e3c04ecba06546%2F110340608.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| A header notification shows the number of concepts which were successfully saved, and the *Issues List* updates to preview the new first item, with the Total Items count decremented by the number of saved concepts.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-4092a1f0d64204e907a07296c9f9da26b1afe622%2F110340609.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| For rapid processing of the entire list, press the `Select all` checkbox in the *Issues List* header.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-be09357116a4e49520caf2d618a19fa26cdf093a%2F110340611.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| With all *Issues List* concepts selected, press the `Auto-fix` icon button to processing the entire list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-77438ff33f20e927becf32e61d9b606f53710554%2F110340612.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>Whilst most integrity check suggestions will likely save without manual intervention, with a long <em>Issues List</em> , it's also quite probable that some suggested resolutions will trigger Drools Rules errors that prevent saving.<br></p><p>Once the automated process has saved all the items that don't need manual resolution, a header notification shows the number saved successfully, and also the number that failed to validate on attempting to save.<br></p><p>The items that were unable to be saved due to validation errors remain on the <em>Issues List</em> , with the new first item automatically previewed, and the item count is updated to show the total remaining.<br></p><p>These items must be manually fixed concept-by-concept by editing in the <em>Resolution</em> preview panel.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-7e365ae0fd40c2c51d53abc120343420cccf0eba%2F110340613.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>To see the errors that prevented automated saving, press <code>Save and next</code> in the <em>Resolution</em> preview panel.<br></p><p>The header and concept panel notifications are the same as those that would be obtained through normal editing.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-aff000dbb16766101fea7963f807df2b0b2ea57c%2F110340615.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Use the *Resolution* panel editor details information and the *Search* and *Taxonomy View* context tabs to identify alternative solutions to resolve the issue.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-040c4a01566483464f817412294c2e88400a38ca%2F110340616.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-9612dfe038a8b82f287354939beabb45565b6f89%2F110340617.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-3dcad9f420988ed869b363bbc62452e60f962269%2F110340619.png?alt=media" alt=""><figcaption></figcaption></figure></div> |
| When the last item on the list has been successfully saved, the *Integrity Report* automatically runs again to confirm the changes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-9717b6f18fc84872781c730674ca519b6039a7eb%2F110340620.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>When the <em>Integrity Report</em> completes with no issues, the usual <em>Task Details</em> view is presented.<br></p><p>From this point onwards the <em>Integrity Report</em> check will no longer be triggered when opening the task.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-66d1bbfe594e7614f0439d02063b47313b2aca79%2F110340622.png?alt=media" alt=""><figcaption></figcaption></figure></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>All concepts saved from <em>Integrity Report</em> issue resolutions are available in the task <em>Feedback</em> context tab, in the same way that manually authored content is listed (any other concepts edited in the task will also be in this list).<br></p><p>Load a list concept in the <em>Feedback Preview</em> panel to see its change details.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <div><figure><img src="https://956592758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO8kNzHFIgz2UFgwrcB08%2Fuploads%2Fgit-blob-be250f5057d48cd94bd3d116916f3901220ef771%2F110340624.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-e34ed2ec23e004a5f23709561b82b6f36e040b12%2F110340625.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=Resolve%20upgrade%20integrity%20issues%20%28Integrity%20Report%20resolution%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/work-in-an-extension/resolve-upgrade-integrity-issues-integrity-report-resolution.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.
