Overview
Goal: Provide an utility to Migrate and/or Merge Herzum Approval data from one instance to another.
Description: A new administration screen allows the Jira administrator to perform the following operations:
- Run a Dependencies Analyzer on the Source Jira Instance
Export Approval Data in xml format on the Source Jira Instance
- Delete Approval Data on the Target Jira Instance before to perform the import (Optional)
New administration screen: Export Import Data
Dependencies Analyzer Tab
The Dependencies Analyzer Tab allows to identify the Jira entities (Projects, Issue Types, workflow statuses, transitions, Users, Groups, Project roles etc) used or referenced by the Approval Configurations in the local instance.
This information allow the Administrator to check if the target Jira instance have the needed entities allowing to achieve a successful import.
The form allows to
- export a dependencies analysis report
- display the result of the dependencies analysis
On clicking Launch, the app identifies, for each Approval table that stores the Configurations applied on the source instance, the Jira entities that are referenced by this table.
It is strongly recommended to run the Dependency Analyzer after that you have performed an Approval Recovery in order to ensure that data on the Source instance are consistent.
The app will delete any dirty data (tuples having Export status = Draft) before to start the Dependencies Analysis.
Dependencies Analyzer Output
After that the dependency analysis complete, you will be able to display the Jira entities referenced by any Approval table and Download the Dependencies Report.
The Download Dependencies Report button allows to download a file that lists for each entity the dependency analysis result.
The Report will include any message displayed on the form.
Dependencies Analyzer messages
By following a dependency analysis there are three type of messages that can be displayed:
- Info: these messages report information that doesn't require any action by the sys admin.
- Warnings: these messages report relevant information that the sys admin must use in order to prepare the target instance with all the Jira entities referenced by the Approval Tables.
Notice that on performing the Approval Data import, the app will search referenced entities by usernames (for user key data) and by Name (for other entities, e.g. Project Name, custom field Name, etc.).
- Error: these messages report the missing Jira entities referenced by the Approval Tables. Such errors must be fixed before to perform the Approval Data export in order to allow the operation to succeed. The Approval recovery is able to fix the inconsistencies automatically.
Export Tab
Import Conflicts Analyzer Tab
Import Tab
Delete Tab
