Overview

This feature supports easy migrations between different Jira environments and ensures seamless data transfer for templates. This enhances data portability and ensures efficient migration processes, providing a seamless experience for administrators managing ARNR templates.

Supported migrations include:

• Cloud to Cloud

• Cloud to Data Center (DC)

• Data Center (DC) to Cloud

Admin Privileges

Only users with Jira Admin privileges can perform import and export operations for templates.

Configuration Changes

A new "Import/Export Data" tab has been added to the ARNR Settings configuration. Initially, this feature supports template import/export but is designed to accommodate rules and triggers in future updates.

Navigation for cloud app

• Navigate to Jira settings ( ) >> ‘Manage apps’ >> Configurations option for ARNR under the menu which is accessible for Jira admins >> Import/Export data tab.

Open

Navigation for DC/Server app

• Navigate to Jira settings ( ) >> Click on Manage apps >> Click on Automated release notes & reports settings from the left navigation >> Click on Import/Export data tab.

Open

When users select the "Template" data type, three additional sub-tabs will appear :

• Import

• Export

• Logs

Importing Templates

• Navigate to the Import tab

• Click on Choose file

• Select whether to import templates in a single project (for in-project screen template) or cross-project templates

• If importing from a single project, select the relevant project from the Select project dropdown

• Click on Import

Error Handling for Imports

Import may fail under the following conditions:

• Duplicate Template Name: If a template with the same name exists in the destination project.

• Empty Template Body: If the template body is not populated.

• Mandatory Fields Missing: If required fields are missing in the template.

• Invalid Template Level: When importing templates for cross-project screens, it may result in an error if importing templates designated with global or local levels, as these types are unsupported in cross-project screens.

Exporting Templates

• Navigate to the Export.

• Select Export Scope, i.e:

  • Specific project

  • All projects

  • Cross-project export (includes all cross-project templates).

• Select a project and click on Export button.

Templates will be exported as a single HTML file. Each template will be separated by a distinct delimiter. Export progress will be logged in the Logs tab with the relevant progress statuses.

Error Handling for Exports

Export may fail under the following conditions:

• Data Fetch Failure: If the system cannot fetch the data for the specified project.

Logs

The Logs tab records all import and export activities. The logs include:

• File name, Template name, Project, Action, Triggered by, Date, Status (Success, In Progress, or Failure).

Click on Failure status to understand why did action fail.

Template Visibility

• When the import is for a single project, templates will appear in the selected project's ARNR Template tab.

• If the import is for Cross-project, templates will be displayed in the Cross-Project Templates tab.

Admins can edit, modify, and apply imported templates to their desired rules.

Upcoming enhancements

• Future updates will support the import/export of rules and triggers.