Document toolboxDocument toolbox

(8.11.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 choicemultiple 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.

(warning) 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 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
  • Link to script field examples

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

Formula

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