Document toolboxDocument toolbox

(8.1.7) 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

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.

(warning)Ā The Work ratioĀ does not make a cumulative, it calculates an average.

For theĀ cumulativeĀ type you have to fill:

  • Name
  • Description
  • The Jira number field to aggregate

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 when the project field tab (on project overview) is loaded 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

Field actions

Option

Details

Available for
Map into a Jira issue custom field

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.

(warning)Ā If you map a field into JiraĀ you will not be able to restrict visibility.

List

Text

Number

Date

Duration

Status

Priority

User

Project

Group

Restrict visibility

Select the project role that will be able to view this field. Project administrators are always able to view and edit the value of fields

List

Text

Number

Date

Duration

Status

Priority

User

Project

Group

Cumulative

Script

Depends on another list

Select another list that the value will depend on, e.g. Planet ā†’ Region

List
Option id is different than the value

You can specify different values and id's for theĀ listĀ options.

List

Advanced