Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

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) 

single-or-multi.png

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

001-list-single.png

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.

text-single-or-multi.png

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

002-text.png


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.

003-number.png

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.

004-date.png

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…)

005-duration.png

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

006-status.png

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.

007-priority.png

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

users-single-or-multi.png

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

008-user-multi.png

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.

project-single-or-multi.png

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

009-project-multi.png

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.

group-single-or-multi.png

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

010-group-single.png

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.

011-formula.png

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:

  • formula-pn.png

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.

012-script.png

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

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

005-Editor-permission.png

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

006-Viewer-permission.png

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.

(warning) If you map a field into Jira, anyone who accesses the issues will see the project value.

001-map-into-jira.png

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

003-Depend-on-another-list.png

List

Set value ID different than name

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

004-Option-id-different.png

List

Advanced

  • No labels