(8.17.X) Fields

In this section, you will be able to learn about Projectrak field types. How to configure and set them up and what you can do with each one.

List

List fields are used to create a list of values. The values can be added manually or imported from an external data source.

You can select between a single choice, multiple choice , or external source (External source is explained here)

Once you select the option you will have to complete the field creation form.

For the list type of field you have to fill the following fields:

Name
Description
Options: You can order the options alphabetically, delete them, or change the order in which they are displayed.

Text

This is a text-type field that can hold up to 255 alphanumeric characters.

It can be a single line or multiple lines.

Once you select the option you will have to complete the field creation form.

For the text type you have to fill the following fields:

Name
Description

Number

This is a number field that can only store (floating point) numbers.

For the number type you have to fill the following fields:

Name
Description

Date

This field can be used to store a date in the format selected in the Jira configuration. The date can be entered directly or selected using a date picker.

For the date type you have to fill the following fields:

Name
Description

Duration

This field can be used to store time estimates (2w 5d 3h…)

For the duration type you have to fill:

Name
Description

Status

This field stores Jira status-type values that can be used to reflect the status of a project

For the status type you have to fill the following fields:

Name
Description
Options: you can select text and a color for each status.

Priority

This field stores priority values that can be used to reflect the priority of a project.

For the priority type you have to fill the following fields:

Name
Description
Options: select the text and icon for each priority.

User

This field type can be used to select a Jira user from an auto-complete list

You can choose between a single user or multiple users

Once you select the option you will have to complete the field creation form.

For the User type you have to fill:

Name
Description

Project

This field type can be used to select a Jira project from an auto-complete list.

You can choose between a single project or multiple projects.

Once you select the option you will have to complete the field creation form.

For the project type you have to fill:

Name
Description

Group

This field type can be used to select a JIRA group from an auto-complete list.

You can choose between single and multiple group selection.

Once you select the option you will have to complete the field creation form.

For the group type you have to fill:

Name
Description

Formula (Formerly Cumulative)

This field type shows the result of the addition result for the selected field. This field can be any existing number custom field or one of the following fields: original estimate, remaining estimate, and time spent.

The Work ratio does not make a cumulative, it calculates an average.

For the Formula type you have to fill:

Name
Description
The Jira numeric field with which the operation will be performed.

Formula fields will calculate every hour automatically (please check Jira Services).

Users will see the last calculation time next to the value field in the Project data tab and the Project navigator:

Script

Script field is a Projectrak's field type that allows you to store and run a Groovy script code that has been typed directly into its properties or from a file located in the Jira Server. The script code will be executed in the background, and you can show the result in the project field tab and the project is shown in the Project Navigator.

Script type fields may generate unexpected results due to their execution time or poor development.

For the script type you have to fill:

Name
Description
The Groovy script
Link to script field examples

Script fields will calculate every hour automatically (please check Jira Services).

Users will see the last calculation time next to the value field in the Project data tab and the Project navigator:

Advanced settings

Option	Details	Available for

Option	Details	Available for
Editors of the field values	Select the project role that will be able to edit this field. Additionally, you can choose from: Any logged in user Nobody
Viewers of the field values	Select the project role that will be able to view this field. Additionally, you can choose from: Any logged in user Only editors Note: To activate this option, you must restrict the 'Editors of the field values'.
Create a Jira custom field based on this field and its values	It allows you to have a Jira custom field associated with this project field. This value will be automatically updated with the information of the project field. If you map a field into Jira, anyone who accesses the issues will see the project value.	List Text Number Date Duration Status Priority User Project Group
Depends on another list	Select another list that the value will depend on, e.g. Planet → Region	List
Set value ID different than name	You can specify different values and id's for the list options.	List