Identity Manager v15 Environment Import Error with ReportTypeSelectionScreen

Products

• CA Identity Manager

Issue/Introduction

When importing an Identity Manager (IM) v14.5 environment zip file (including roles/tasks definitions) into an IM v15 build, the following error is encountered:

Error: The screen definition "ReportTypeSelectionScreen" referenced on the screen "Account Details Report Search Screen" is not defined

This typically occurs because the imported v14.5 role definitions use an outdated screen definition (ReportTypeSelectionScreen) for reporting tasks that is not recognized in IM v15.

Environment

Source: Identity Manager v14.5 environment.
Target: Identity Manager v15 (e.g., iga-suite version 15.0.0 build 21).

Resolution

The solution involves updating the outdated screen definition in the source environment's role XML file before re-attempting the import.

1. Locate the Role Definition File: Open the IM v14.5 environment's role definition XML file (e.g., IdentityEnv_environment_roles.xml from the customer's package).
   
   
2. Perform Global Replacement: Globally replace all occurrences of the old screen definition attribute with the new, v15-compatible one:
   • Replace: screendefinition="ReportTypeSelectionScreen"
   • With: screendefinition="JasperReportTypeSelectionScreen"
     
     
3. Re-attempt Import: Save the modified XML file and re-attempt the environment import into IM v15.

Additional Information

The recommended approach for creating a new IM v15 environment is to use the default roles provided with the v15 installation, rather than importing old v14.5 role definitions.
When using the mogrify process to migrate from source to destination you will not have this issue. It's the recommended approach. During the mogrify one step is to copy source databases to destination that will prevent the role definition export/import from 14.5 to v15.