jira-analyzer-projects

Config Analyzer & Migration Helper for Jira Cloud

Documentation for the Atlassian Marketplace app.


What the app does

The app adds a Config Analyzer page to the settings of any Jira Cloud project. From there you can:

  1. generate a configuration report of the project;
  2. export the custom fields used by the project;
  3. compare a Data Center workflow with its Cloud counterpart.

It is read-only: it requests read scopes only and never modifies your configuration.


Requirements


Where to find it

Open a Jira project → Project settings → in the left menu, under Apps, select Config Analyzer.


1. Project configuration report

Press Analyze project. The app reads the instance configuration and produces a Word document containing:

Note on large instances. To know which schemes are shared, the app has to scan the projects of the instance: there is no endpoint that answers “which projects use scheme X”. The scan runs in batches and shows progress. On an instance with hundreds of projects it takes a while; it is not stuck.


2. Custom field export

Press Custom fields (CSV). You get a CSV with three columns:

column meaning
id the field id, e.g. customfield_10050
name the field name
source screen, workflow, or screen+workflow

source tells you where the field was found: on a screen used by the project, referenced by a workflow rule, or both.

Limitation to be aware of. Fields referenced inside an app script by name instead of by id cannot be detected — there is no id to extract. Fields referenced by id are found.


3. Data Center to Cloud workflow comparison

Getting the XML out of Data Center

In your Data Center instance: Administration → Issues → Workflows, find the workflow, and use the export as XML action. Save the file.

The app never connects to your Data Center instance. You export the file yourself and upload it; it is parsed locally in your browser and is not sent anywhere.

Running the comparison

  1. Press Read Cloud workflows. The app lists the workflows used by the current project.
  2. For each workflow you want to compare, upload its Data Center XML. Matching is manual: you decide which file goes with which workflow. The app does not guess.
  3. Press Review comparison, check the summary, then download the document (Word) or the spreadsheet (Excel, one sheet per section).

Workflows left without an XML are not included in the document.

How results are reported

The comparison is deterministic. It reports what is in the two files and marks anything it cannot prove as to verify, showing the raw values side by side. It never guesses a cause and never pairs items that do not match exactly.

result meaning
OK present on both sides, matching
INFO a difference that is expected, e.g. a different status id (ids are regenerated by the migration)
TO VERIFY no exact match — look at it yourself
MISSING IN CLOUD present in Data Center, not found in Cloud
EXTRA IN CLOUD present in Cloud, not found in Data Center
STANDARD standard OSWorkflow post-function, handled internally by Cloud — not a gap

Rules are matched by canonical identity. The same rule is often named differently in the two worlds — a ScriptRunner script, a JSU function, a role condition. The app maps the known equivalences so that one rule counts as one, instead of appearing as one “missing” plus one “extra”. Equivalences that are not confirmed are left as to verify rather than guessed.

A MISSING and an EXTRA on the same transition usually mean the same rule under two names. If you find such a pair and confirm they are the same rule, report it to support and the equivalence will be added.

Wrong file check

If the uploaded XML does not look like the workflow it was assigned to, the app says so before generating the document, and shows how many transition ids the two sides have in common. Transition ids are preserved by migration, so no ids in common is a strong sign the files are different workflows. Nothing is blocked: you confirm or upload again.

Note that the workflow name often differs legitimately after a migration, so a different name alone is not a problem — what matters is the structure.


Languages

Interface and generated documents are available in English and Italian. Switch language from the bottom of the panel; the choice is remembered.


Privacy and security

See the privacy policy for details.


Limitations


Support

Questions, bug reports, or a rule equivalence to add: official.fdnf@gmail.com