Custom Properties for Versions and Packages

Topics

Notion of Properties

We now support Custom Properties (aka Custom Fields in Jira) for your versions and packages.

How to define?

Go to Board Settings and select Properties section of configuration.

Type the name of you first custom property, select whether you want to apply it to Version or Package and pick up the Data Type you want to use. At this stage the following types are available:

  • String

  • Paragraph (so, you can create alternative Descriptions)

  • Number

  • Date

  • Datetime (so, you can create additional trackable dates to start/release date and milestones)

  • User (Jira users lookup)

  • Multi-user

  • Single Select

  • Multi Select

To complete your action click “Add“.

To remove it click on “x“ on the right. A confirmation pop-up will appear to confirm you want to remove the field from all the versions/packages.

Mandatory Properties

You can mark properties as mandatory. In this case:

  • they will show up on creation screen for version and packages

  • also for creation from package template

  • will be marked as required on version/package summary tab

  • an API call will fail as an attempt to create / update version/package w/o mandatory fields specified

How to view and edit?

Once you configured your customer properties for versions and packages you can now see/edit them on version/package summary page.

Defining the order

If you want to change the order of your properties outlined you can do it in configuration. Just drag and drop lines with properties to setup the order. The order for version and package properties are defined separately.

Multiple use-cases

Advanced filtering

On all the views (Board, Roadmap, Calendar and List) you can filter by custom properties defined.

To do so click “More” and select property you wanna add to filter.

Selected properties will be added to filtering panel.

You can now specify the value/range of your custom property to filter out.

The clear the filters please use ”Reset filters” icon.

To remove specific filter by properties please on “More“ again to un-check it.

Release notes

You can inject custom properties into Release Notes as any other standard release properties.

Web hooks

You can inject custom properties into Web Hooks as any other standard release properties.

You can also use JS-like string functions to your string properties to finetune values to be used in the hooks. More details here https://releasemanagement.atlassian.net/wiki/spaces/RMC/pages/2430074881/Outcoming+WebHooks#JS-like-functions-for-injectable-variables.

Card layout

You can adjust card layout by including up to 3 custom properties to the card. This applies to both - versions and packages.

To do so click on Settings and scroll to Card layout.

Alternative descriptions

Paragraph properties (as alternative Descriptions) are shown under Description field in Release details and are also collapsed by default

Datetime properties on timeline

Once you define datetime properties and setup it for versions/packages it will be shown automatically on Timeline.

The use case is alternative trackable dates. Alternative to start/release dates and milestones (thata are also on a timeline).