🆕Comparison & Snapshots

Comparing Jira project configurations, and creating Snapshot milestones

Comparing Jira project configuration feature is designed to help users understand differences between configurations on the project level, without administrator access.

The new Comparison menu is available in Glass menu next to Export:

Opening the comparison menu

Compare

While comparing two configurations, all information that is available in Glass will be taken in account. Information currently not supported by Glass will not be part of the comparison.

In comparison, multiple options are available as Baseline (left side):

• This project's any saved previous version (see more in Snapshots)

• Any other project's any Snapshot (where you have both Browse & View Glass permission)

• Any uploaded Snapshot (see more in Download Snapshot)

Baseline can be compared to (right side):

• This project's Current Version

• This project's any previous version (see more in Snapshots)

Project Comparison possibilities

High level comparison

The purpose of high level comparison is to quickly validate if there is any difference, point out where the differences are, or just to confirm the configuration is untouched as expected. To deep dive into details we implemented low level comparison as well.

After pressing the compare button a high level comparison will be shown, where all the important project details are highlighted. Result is shown in the middle line on the object level. For example, if everything is the same, all markers are going to be green.

No differences detected, all green

When there is any difference detected, there will be a red indicator in the middle for that:

A new component added, so there is a difference in basic settins

On the high level view you can only detect significant changes - like using a different scheme or a removed a workflow. For more details you can dig deep with the low level comparison when needed.

High level comparison actually does a complete analysis, which means we deep dive into the lower levels, while showing only the final verdict and main objects.

What is ananlyzed during evaluation

• Basic Summary - Project main values (from General tab)

  • key, type, instance name, category, url, components, versions

• Issue Type Scheme - Issue Types

• Issue Type Screen Scheme - Screen Schemes

  • Screen Scheme - Issue Type assignments

  • Screens in Screen Schemes

  • Fields in Screens

• Field Configuration - Field Confiruation Scheme

  • Field Configurations

• Workflow Scheme - Workflows

  • Workflow - Issue Type assignments

  • Workflow statuses, transitions, actions

  • Custom actions are highlighted in order of Conditions, Validators, Post Functions

  • Any changes in workflow actions

• People - People in the project

  • All people, number of groups, project roles and people in roles

• Security Scheme - Security Scheme

  • Levels and Actors in the scheme

• Permission Scheme - Permission Scheme

  • Permissions in the scheme

• Notification Scheme - Notification Scheme

  • Notifications in the scheme

Low level comparison

The purpose of low level comparison is to deep dive and understand project settings on the lowest possible level, when a difference has been identified, in a textual diff view.

This Low level comparison view can help understand even the smallest differences between project configurations, like

• a workflow post function has been added or edited

A new post function has been added

• a new component or version has been added

A New Component has been added to the project

• fields have been added to screens

A new field has been added to a screen

• the permission scheme has been modified

Glass View permission has been granted for jira-administrators

• and more...

When the low level analysis ends up with findings, you can use Glass's overview feature to analyze and visually better understand the configuration details, still without administrator access.

A New Component has been added to the project

A new post function has been added

When you see on the High Level that the 2 configration are radically different, the Low Level Comparison usually adds low/no value. In this case pressing Low Level a warning will be shown, and load time can take several minutes. Although when there is only a small change in every section, the pop up will shown, but there will be no extra load time.

Snapshots

The Snapshot feature is an powerful extension for project configuration comparison. The purpose of Snapshots is to be able to save configuration checkpoints which can be used for comparison baseline, while files can be stored in Jira securely.

Snapshot possibilities

Create Snapshot

Only project admins can Create snapshots. 20 snapshots can be created per project for now.

New snapshots have the following inputs:

• Name - which will appear in the comparison list

• Description - note to self, to be able to summarize changes in the project settings

Create project configuration snapshot

Compare 2 snapshot

When selecting 2 snapshots, the Compare Selected button become available to be able to quickly compare snapshots.

Compare 2 selected snapshot

Download current

Current configuration can be downloaded, to be able to move the file to another instance (especially useful when moving from server to cloud, or from sandbox to live instance)

Current configuration can be downloaded

Snapshot actions

Snapshots can be

• Edited (for Admins only)

• Downloaded

• Deleted (for Admins only)

• Compared to Current configuration

Popular use cases

Project configuration - recent changes

Check what has changed since your last Snapshot.

Select an old snapshot for comparison

1. Search for your latest Snapshot (on top), and press Compare to current

2. Compare 2 configuration and analyize recent changes

Note that this comparison may take some time, since Current Version will be downloaded real-time with the latest project configuration.

Project configuration - historical

Validate what has changed in your project by time.

Compare 2 versions of the same project

1. Create Snapshots regularly when you do major changes in project configuration

2. Select any 2 snapshots and press Compare Selected

3. Compare 2 configuration and analyze changes by time

2 different projects

Validate if project A has the same configuration as project B within the same instance. Can be useful when projects created with shared configurations, or looking for resued schemes.

Comparing different projects

1. Create a new Snapshot for project A

2. Open project B, Select project A and the new Snapshot you just created

3. Press compare

Note that it is usually creates no value of comparing totally different projects, especially on the lower level.

Differences between platforms

Validate if cloud migration was complete and look for differences.

Comparing Uploaded Server config with the Cloud config

1. Do cloud migration

2. Open your Server/Data Center project

3. Download current Snapshot from Snapshot menu

4. Open the same project on Cloud instance

5. Upload the old downloaded snapshot and press compare

Note that Atlassian migration tool renames most configuration elements, so don't expect to have a complete green result. Although High Level comparison can be really useful to overview differences.

Differences between the dev and prod

Compare dev and prod instances before and after going live with it.

1. Export a snapshot from your project on the prod instance

2. Navigate to the dev instance, open your project

3. Upload the downloaded snapshot from your project and press compare

4. All the changes become visible which are not live on your prod