(8.1.1) 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.
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. 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 |