Copy Project Settings
QTM4J allows admins to copy configurations of one space to another space or import configurations into the current space. This saves time in manually duplicating existing settings.
Jira System Admin can select and copy Configurations, Permissions, and Space Settings from a source space to multiple target spaces in a single operation. This feature allows them to duplicate existing settings from the template space whenever a new space is created.
Project Admin can select and import Configurations, Permissions, and Space Settings from a Source Space to their Current Space.
The Space Settings can be copied or imported from the following places in the application:
Feature Availability | Purpose |
|---|---|
Apps > Manage Apps > QTM4J > Global Settings > Copy Space Settings | For the Jira Admin to copy configuration settings to multiple spaces |
Apps > QMetry > Configuration > Import Space Settings | For the Project Admin to import configuration settings to the current space |
Note
Required Permissions
The following permissions are required to perform the copy and import Configuration operations.
For Copy from QTM4J Global Settings:
Users should have the Jira Admin role.
Users performing the copy operation must be part of the Group mentioned in the Manage QTM4J Space Settings under General Configuration, Global Settings.
Users performing the copy operation must have the “Configuration View” permission of the source space and “Configuration Modify” permissions of the target spaces.
For Import from Configuration:
Users performing the copy operation must be part of the Group mentioned in the Manage QTM4J Space Settings under General Configuration, Global Settings.
Users performing the import operation must have Space Jira Administrator permission for the target space or Product Administrator permission, the “Configuration View” permission of the source space, and the “Configuration View” and “Configuration Modify” permissions of the target space.
Business Rules
Only spaces that have the QMetry For Jira settings enabled will appear on the Source Space and Target Spaces list.
To copy permissions, the QMetry permissions should be enabled in the source space.
When copying configurations from Global Settings, the Admin can select a maximum of five target spaces at a time.
The copied permissions replace the existing permissions in the target space.
For Labels, Components, Priority, and Status, the new values will be merged with existing values in the target spaces.
System Fields: Mandatory settings will be copied.
Execution Result Settings: Sequence will not be copied, and the existing Custom Execution Status will be retained.
Custom fields and values: Fields and values will be copied along with the default and required settings to the target spaces only if they do not exist in the target space.
Archived values of system fields will not get copied.
Parameters: Parameters and values will be copied to the target spaces only if they do not exist in the target space. If a parameter already exists in the target space, the new values will be merged.
The Page Limit setting will not be copied to the target space as it is a user-specific setting.
Copy Settings from Global Settings
Follow the steps mentioned below to copy the Space Settings that exist in one space to multiple spaces.
Go to Settings, click Marketplace Apps, and click Global Settings under QMetry.
Click Copy Space Settings and select the Copy Settings tab.
Select Source Space: The list shows only QMetry-enabled spaces. Select the space whose settings you want to copy to the target space(s).
Select Target Space: The list shows only QMetry-enabled spaces. You can select multiple spaces up to five spaces to copy the settings from the source space.
Select Configurations to Copy: Select the settings to copy the existing settings in the selected Source Space to the selected Target Space(s).
Note
Automation API API Settings will copy the settings for JUnit and TestNG.
The BDD settings are currently unavailable for copying from the source space. Since these repositories are specific to individual spaces, they may not be applicable across different spaces.
Copy Permissions: Selecting the Copy Permissions option under the QMetry Space Settings section will replace the target space's permissions with a copy of the source space's permissions. This may cause the target space to lose its existing permissions. The option only works when the source space has QMetry Permissions enabled.
If you copy permissions, it is recommended that you review the permissions in the target spaces after you copy the settings.
Click Copy adjacent to the space selection list.
The confirmation message appears.
Click Proceed to start copying the space settings from the source space to the selected target space(s).
The success message appears.
View Request Status
Once you initiate the process of copying configuration, you can view all the requests in the Request Status tab in the Copy Space Settings section. The tab shows details of Request Id, Source Space, Target Space, Requester, Processed On, and Status.
To view details of a request, hover over the record and click on the View Details icon.
You can view the elaborated status of the individual settings that have been copied from the source space to the target space(s) and the reason for failure or error.
The following table depicts which Status will be shown in which scenario.
Status | Scenario |
|---|---|
Queued | When the copy tasks are lined up to be performed. |
In Progress | When the copy operation is still in process. |
Completed | When all the settings are copied successfully. |
Failed | When all the settings fail to be copied. |
Partially Completed | When some of the settings are copied successfully, and some fail to be copied. |
Audit Log of Copy Settings
To view the audit log of the Copy Space Settings operation:
Go to Configuration.
Select Audit Log.
Select the Configuration Logs tab of the target space.
Import Space Settings from Configuration
Refer to Import Project Settings from Configuration for more details.