/
๐Ÿ› ๏ธ Administratorโ€™s Guide

๐Ÿ› ๏ธ Administratorโ€™s Guide

Configure with confidence. Empower your teams.

๐Ÿ“ฆ Installation

Dynamic Score is a Forge-based app for Jira Cloud. To install it:

  1. Go to Apps โ†’ Find new apps

  2. Search for Dynamic Score

  3. Click Try it free

  4. Grant the requested permissions

Once installed, the app becomes available in:

  • Space Settings โ†’ Apps โ†’ Dynamic Score (for configuration)

  • Issue panel of every issue in that space (for scoring)

๐Ÿ” Permissions

Dynamic Score requires only the scopes necessary to load configuration and save results:

Required scopes

  • read:jira-work โ€“ load issue details and issue properties

  • write:jira-work โ€“ save scoring selections into issue properties

  • read:jira-project โ€“ load space-level scoring configuration

  • write:jira-project โ€“ save scoring configurations in space properties

  • read:jira-user โ€“ display user-friendly labels when saving comments (optional)

Why they matter

  • The app stores scoring configuration in the space property
    dynamic-scoring-config

  • Issue results are saved inside
    dynamic-scoring-values

If these scopes are not approved, the app will not be able to load or save data.

๐Ÿงฉ Configuration (Admin Setup)

All scoring logic lives in Space Settings โ†’ Apps โ†’ Dynamic Score.
Admins can create any number of scoring configurations:

  • Basic scoring (simple sum + rules)

  • Weighted scoring

  • Impact/Effort

  • Risk Matrix

  • Financial scoring

Inside each configuration, you can customize:

  • Dropdowns

  • Options and Base Scores

  • Formulas

  • Weights

  • Thresholds for Low/Medium/High

  • Rules (Basic type only)

Who can edit configurations?

Any user with permission to modify project (space) settings.

Where is configuration stored?

In the project property:
dynamic-scoring-config

The active configuration is marked with activeConfigId.

๐Ÿ”„ Updates

Dynamic Score updates automatically through Atlassian Forge.
There is no action required from admins.

If a new version includes UI or formula improvements, they will appear in all spaces immediately after deployment.

๐Ÿ‘ฅ Who Should Use It?

Dynamic Score is designed for any team that needs structured, transparent scoring:

  • Product Managers

  • Engineering Leads

  • Delivery Teams

  • Operations Teams

  • Finance & Monetization

  • Support / Compliance / Risk functions

Each team can maintain its own scoring configuration or share one across the space.

๐Ÿงช Want to test it first?

We recommend installing Dynamic Score in:

  • A sandbox site, or

  • A single test project

โ€ฆbefore rolling out to all teams.
This helps validate formulas, dropdowns, and thresholds before linking them to live processes.

๐Ÿงผ Uninstalling

To uninstall Dynamic Score:

  1. Go to Manage Apps

  2. Search Dynamic Score

  3. Click Uninstall

What happens to stored data?

  • Issue-level scoring results (dynamic-scoring-values) remain in Jira

  • Space configurations (dynamic-scoring-config) remain stored

You may delete them manually via the Jira REST API if needed.

๐Ÿง  Admin Tips

โœ” Keep configurations short and clear โ€” too many dropdowns slow adoption
โœ” Use thresholds to create easy visual risk/priority indicators
โœ” Educate teams on the differences between scoring models
โœ” Review configurations quarterly to ensure they still match team workflows
โœ” Encourage teams to save scoring as comments for transparency and auditability