Documentation

Report

Allow add-ons to define a new report, which is linked from a project page.

Example

{
  "modules": {
    "jiraReports": [
      {
        "url": "/report?projectKey={project.key}",
        "description": {
          "value": "This is an example report"
        },
        "reportCategory": "agile",
        "thumbnailUrl": "http://example.com/images/report-example-thumbnail.png",
        "name": {
          "value": "Example Report"
        },
        "key": "report-example"
      }
    ]
  }
}

Properties

description

Required
Yes
Description

A human-readable description of this report module. This description is displayed on the reports list.

key

Type
string
Required
Yes
Description

A key to identify this module.

This key must be unique relative to the add on, with the exception of Confluence macros: Their keys need to be globally unique.

Keys must only contain alphanumeric characters and dashes.

The key is used to generate the url to your add-on's module. The url is generated as a combination of your add-on key and module key. For example, an add-on which looks like:

{
    "key": "my-addon",
    "modules": {
        "configurePage": {
            "key": "configure-me",
        }
    }
}

Will have a configuration page module with a URL of /plugins/servlet/ac/my-addon/configure-me.

name

Required
Yes
Description

A human readable name.

url

Type
string

uri-template
Required
Yes
Description

Specifies the URL targeted by the report. The URL is relative to the add-on's base URL.

reportCategory

Type
string
Defaults to
other
Allowed values
  • agile
  • AGILE
  • issue_analysis
  • ISSUE_ANALYSIS
  • forecast_management
  • FORECAST_MANAGEMENT
  • other
  • OTHER
  • Description

    The category of the report. The default category is other.

    thumbnailUrl

    Type
    string

    uri-template
    Description

    Specifies the URL of the report thumbnail. The URL is relative to the add-on's base URL.