Configuration and Features

The behaviour of the Jenkins Integration for Jira app can be customized through configuration and features. Features are essential on or off configuration settings, whereas other configuration settings can contain other bit of information as well.

The Configuration dialog can be accessed on the main administration page of the app in Jira by going to Settings > Apps > Jenkins Integration > Configuration. Once the configuration dialog is open you can access the Features dialog by clicking on the Features button.

Configuration

The Configuration dialog allows you to configure the following:

Maximum Builds per Page

This configuration setting allows you to limit the number of builds that are shown on a CI Builds panel, defaults to 100.

User Id vs Display Name

Some feature of the integration require user information, like triggering a build send who triggered the build to the Jenkins site. This setting allows you to choose whether the user’s display name or id is used.

Data Retention Period

Retention period, in months, how long jobs and builds that are marked as deleted will be kept in the build cache, defaults to 12.

Jobs are only cleaned up from the build cache if the job itself is marked as deleted, and the latest build in the cache is older than the retention period. Builds are cleaned up from the build cache if the build is marked as deleted, and the timestamp of the build is older than the retention period.

Date Format

This configuration setting allows you to configure the format used to make date and time strings human readable. Documentation on date / time formats can be found online.

Features

There are two types of features, system and site, System features are features that are either enabled or disabled by the app itself and cannot be customized. Site features however are features that administrators of a Jira site can enable or disable to customize the behaviour of the app.

System Features

Feature Flag Lite Data Center/Server Cloud Description
data-migration Migrate data from Jira Data Center/Server to Jira Cloud.
jira-jenkins-automation Share synchronization events with the Jenkins Integration Automation for Jira add-on to trigger rule executions.
build-info-provider Push build data to Jira when a build is synchronized and has links to valid issues. This data is then made available in the Development Panel.
deployment-info-provider Push build data to Jira when a build is synchronized that represents a deployment to an environment and has links to valid issues. This data is then made available in the Development Panel.

Site Features

Feature Flag Lite Data Center/Server Cloud Description
dynamic-ui-elements When enabled only show UI elements, CI Build Panels, Triggering Builds, Release Report, when the viewing issue or project has one or more builds linked to it. This can be useful in case you have multiple Jira Software projects in Jira but only a subset of them use the Jenkins integration.
disable-issue-indexing Enabling this feature will cause the app to stop automatically updating issue indexes after a build is synchronized and will instead rely on Jira to perform the indexing.