Quick Start Guide for SST Cloud

Owned by James Madden (Inactive) (Deactivated)
Last updated: Aug 23, 2022
3 min read

Features:

  • Better visualize the hierarchy of issue links

  • Configure with any fields you want to view

  • Click on an issue to expand for a detailed view of your issue’s data

  • Clean and intuitive interface

Installation

  1. Follow Atlassian’s instructions for installing an app from the marketplace here: Installing Marketplace Apps.

  2. On Jira, click the “Dashboard” menu dropdown and select the name of the project dashboard you want to install the dashboard item on.

  3. Click “add a new gadget”.

  4. Search for “Simple Status Tracker” and click “Add gadget”.

Configuration

  1. Select either Use JQL query or Use saved filter in order to select the method of filtering issues.

    • If “Use JQL query” is selected: enter a JQL search into the Enter JQL Search.

      • Examples: (key = “SST-1”, IssueType = Epic, IssueSummary = “Title”)

    • If “Use saved filter” is selected: choose a saved filter from the dropdown.

    • Please Note: The saved filters referred to are created using the issue search screen in Jira. If none are set the user can go to the issue search screen and save a JQL search in order to use with Simple Status Tracker.

  2. Select which Issue fields you want to view for your issues with the Columns to Display dropdown.

    • The default fields are Issue Summary (Issue type, Issue Key, then Issue Title all merged into one).

  3. If you want to render certain Links (Implemented by, blocked by) you can select those from the Links to Display dropdown.

  4. Refresh Rate allows you to control how often the form is refreshed automatically

  5. Max Depth defaults to 4. Changing this number allows you to set how deep you want to render issues. Anything deeper than 4 may cause performance issues.

  6. Max Issues allows you to control how many issues are pulled in from the Jira API call. Default is 50

    1. *Issues linked by Epic Link are rendered by default.

  7. After you are finished setting up the dashboard item, click Save to save your configuration. You will be taken automatically to the main view of the dashboard item.

  8. Click the “…” ellipsis in the upper right-hand corner of the dashboard item, then click “edit” to return to the settings view to make any changes or updates to the dashboard item.

  9. Upon returning to the configuration screen after the initial setup: Click Cancel if you want to discard changes made to the configuration.

 

App Usage

Usage Tips:

  • The app will display the first 5 issues from the query.

    • The rest of the issues that were rendered can be accessed by clicking through the pages with the arrow buttons at the bottom right. You can also select how many issues per page (default is 5).

  • All of the custom fields we offer within Simple Status Tracker are as follows

    • The Story points (sum) field displays the story points of that issue. If the issue is of the selected Parent type it displays a summation of all linked issues story points.

    • The Progress Bar field displays the amount of story points belonging to linked issues with a status of “done“ if the parent issue is of the Parent type.

    • The Relation to Parent filed displays the relationship a child issue has to its parent.

Displayed Data Overview:

  • From the main, view you are met with a list of all of the issues pulled using either the JQL search or Filter set on the config screen.

  • The table will always show an Issue Summary column

    • The Issue Summary column contains the issue type icon, Issue key and summary