The upgrade analysis collects all the changes to the resource that are triggered by the upgrade to a new domain version.
If you don't tick the Generate analysis report in the upgrade wizard, you will still be navigated to the upgrade dashboard, but it will be an empty one without the analysis bits.
The different types of changes that can occur during an upgrade process apply to both single resource upgrades and Collection upgrades as well.
This widget displays information related to the domain, i.e. which Code System is being upgraded including the from and to versions.
This widget is only displayed on Collection upgrade dashboards as it provides a summary of the included Reference Sets. Information such as the number of open feedback, the upgrade severity, and the upgrade status is collected here.
Clicking on the resource title will navigate you to the Content tab of the resource on an upgrade branch. You can edit content here, which will only affect the upgrade, but not the resource directly.
The Inclusions and Exclusions tabs collect changes to the Value Set clauses.
Clicking on a row will reveal additional information as well as options related to the selected clause.
| Clause issue type | Description |
|---|---|
Inactive reference | Clause references an inactive concept |
Syntax error | Clause contains an incorrect ECL query |
Clauses referencing inactive members are marked with an Inactive reference status in the report. In terms of potential replacements the following three scenarios can happen:
Multiple replacements
Single replacement
No replacement
In all three cases, users have the option to ignore the inactive references, replace them, or remove them, which are revealed by clicking on the rows of the affected clauses.
Clauses containing incorrectly constructed ECL queries are marked with a Syntax error status in the report.
In such cases, users have the option to fix the incorrect query, which is revealed by clicking on the rows of the affected clauses.
The Members tab collects changes to the Value Set members.
Clicking on a row will reveal additional information as well as options related to the selected member.
| Member change type | Description |
|---|---|
Inactivated | Member will be inactivated as a result of the upgrade process Note: By clicking on the row, an option to keep the member as inactive will be revealed |
Added | Member will be added as a result of the upgrade process Note: By clicking on the row, an option to exclude the member will be revealed |
Deleted | Member will be deleted as a result of the upgrade process Note: By clicking on the row, an option to include the member will be revealed |
Description change | Member will have a description or property change as a result of the upgrade process |
Hovering over the severity pills on the Collection upgrade dashboard reveals a summary of the Resource changes. This includes the number of added, removed, and changed concepts - with description and modeling changes in brackets, and inactivations separately -, as well as the number of warnings and errors.
This information popup is available regardless you are reviewing the clause or the member changes.
The timeline collects and displays all the changes related to the resource that happened during the upgrade process in chronological order.
Hovering over the icon reveals a summary of the Code System changes.
This widget displays whether the analysis is up-to-date , or is out-of-sync . In case of the latter, pressing the button will update the upgrade with the latest changes.
If you are viewing on a smaller screen, an icon will be displayed in place of the button.
To amend the inactive references, press. This will suggest replacements where applicable, or you can also select the one you see suitable.
