SynapseWorks
Documentation

Decision Register for Jira — Documentation & Support

Decision Register for Jira is a Jira Cloud global/admin page app for generating and exporting project decision registers. It is not an issue-view panel.

Marketplace: coming soon.

Contact Support

Overview

  • Access the app from Jira global navigation under Apps.
  • Load projects, choose a project, and generate a decision register.
  • Filter with decision-type toggles and export results to CSV.

Installation

  1. Sign in to Jira Cloud with a site admin account.
  2. Open the Decision Register for Jira listing in Atlassian Marketplace.
  3. Select Get it now.
  4. Choose the Jira Cloud site where you want to install the app.
  5. Review and approve the requested permissions.
  6. After installation, confirm the app is enabled under Apps > Manage apps.
  7. Open the app from the Jira Apps menu to verify access.

First-use Steps

  1. Select Load projects to fetch available Jira projects.
  2. Select a project from the project selector.
  3. Review default decision-type toggles and settings.
  4. Select Generate register to build the initial result set.

How to Use

  1. Decision type toggles: Enable or disable decision categories before generating.
  2. Settings: Adjust available register settings for the selected project scope.
  3. Generate register: Re-run generation after changing toggles or settings.
  4. Review output: Validate rows in the generated register view.
  5. Export CSV: Download the current generated register as a CSV file.

Permissions & Visibility

  • read:jira-work is used to read Jira project and issue data needed for register generation.
  • storage:app is used to persist app settings and generated register state.
  • Jira API calls are executed in Forge asApp() context.
  • Result visibility is constrained by Jira data available to the app in your site configuration.

Data Handling

Architecture: Forge-only app running on Atlassian infrastructure.

External backend: None.

External network egress: None.

Storage: Forge storage:app is used for key groups including selected project, decision type toggles, register settings, generated register snapshot, and generation timestamp metadata.

Troubleshooting

  • Load projects returns empty: Confirm project browse access and that app permissions were approved at install time.
  • Generate register not available: Select a project first.
  • Generated register is empty: Verify decision-type toggles and project data contain matching decisions.
  • CSV export unavailable: Generate a register before exporting.
  • Settings or selections reset: Reopen the app and verify storage:app permission is present in app configuration.

If the issue persists, contact [email protected].

Support

Support email: [email protected]

Typical response time: 1-2 business days.

Include the following in your support email:

  • Jira Cloud site URL.
  • Affected project key and action performed (Load projects, Generate register, or Export CSV).
  • Step-by-step reproduction steps.
  • Timestamp of the latest occurrence (with timezone).
  • Expected vs actual result and any screenshots.