Page Comparison

Follow the below step-by-step guide if you need to import only parts of an email configuration into your system and override the existing ones with them.
This could be the case when you need to check another Jira instance's configuration or use templates, field rules etc. of another environment.

In this tutorial, we will import the mail handler, mail account and templates into an already existing configuration (which could be useful in case of a service desk support channel where you need to see another test environment's settings).

It is a prerequisite that you have all projects, issue types, fields etc. already created in Jira before starting the Email This Issue Restore process. Everything you would like to set in Email This Issue has to be present before starting the backup, please make sure to check these beforehand.

Jira related dependencies:

• In case of Projects, the name and the project key have to match
• In case of Issue Type/Request type, the names have to match and they have to be available within the project
• In case of (custom) Fields, the name and the field type have to match
• In case of Project roles the names have to match
• In case of Issue Link Types the names have to match
• In case of Groups the names have to match
• In case of a User, the user key has to match

Email This Issue related dependencies:

• Template: either imported or found by name
• SMTP connection: either imported or found by name
• Mail Account: either imported or found by name

On this page

Detailed documentation

Backup and Restore Administration

In case of importing Mail Accounts please note that we do not import passwords. They need to be entered again or the account needs to be changed in order for the setup to work.

Image Removed

The import can have four results:

• Success: all data has been imported successfully.
• Warning: there were items during the import that could not be identified, therefore no action has been taken on those items.
• Error: there was an error during the process such as a faulty JSON file. It does not mean that the restore has failed, it can still be successful, however, you need to check the configuration.
• Failed: a fatal error has occurred, the import is failed, no action has been taken on any of the items.
  • In the case of "New entity", the new entity is NOT created.
  • In the case of "Overwrite existing", the existing entity will not be modified in any way.

• On the results page a link is displayed next to the entity which takes you to the edit page of the entity.

If all the above steps are carried out properly, you should now have all the imported configurations of the backup file in your system.

Backup / Restore only parts of a configuration

Backup / Restore every setting in the same instance