Public Pages
Public Pages

🛠️ Administrator’s Guide

ghj

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