RedmineCustomFields » History » Version 4

Version 3 (Tharuka Pathirana, 2010-08-09 11:52) → Version 4/29 (Mischa The Evil, 2010-10-12 03:53)

h1. Custom fields

{{>toc}}

Custom fields allow you to add additional information to several types of data used in Redmine. See '[[RedmineCustomFields#Custom-field-types|custom field types]]' for all types of data which come with support for custom fields.
Each custom field can be defined to be of a [[RedmineCustomFields#Custom-field-supporting-data-types|certain type]].

h2. Custom field types

on Projects, Issues or Users. A custom field can be of one the following types:

* *Integer*: positive or negative number
* *String*: one single line of input
* *Text*: multiple lines text
* *Date*: date
* *Boolean*: checkbox
* *List*: drop down list

Some validations can be defined for each custom field:

* *Min - max length* : minimum and maximum length for the field (0 means that there is no restriction)
* *Regular Expression* : a regular expression can be used to validate the field content

Examples:

^\[A-Z]{4}\d+$ : 4 capital letters followed by one or several digits

^[^0-9]*$ : characters only - no digits

* *Possible values*: possible values for the "List" fields. One line for each value.

h2. Custom field supporting data types

h3.
Fields for Issues

* *Trackers*: TBD
*
*Required*: field which is required in order to create/save an the issue
* *For all projects*: if checked, this field is used for the issues of all the projects. If unchecked, each project can choose whether or not to use the field for its issues (see [[RedmineProjectSettings|Project settings]]).
* *Used as a filter*: TBD
* *Searchable*: TBD


h3. h2. Fields for Spent time Spent-time entries

* *Required*: field which is required in order to create/save a spent time the spent-time entry

h3. h2. Fields for Projects

* *Required*: field which is required in order to create/save a the project

h3. Fields h2. Field for Versions

* *Required*: field which is required in order to create/save a version

h3. Fields for
Users

* *Required*: field which is required in order to create/save a the user
* *Editable*: field which is editable by [[RedmineAccounts|Redmine users]]

h3. Fields for Groups

* *Required*: field which is required in order to create/save a group

h3. Fields for Activities (time tracking)

* *Required*: field which is required in order to create/save an activity

h3. Fields for Issue priorities

*Note*: issue priority custom fields are not (yet) used in the Redmine core, though other plugins or themes _can_ use them

* *Required*: field which is required in order to create/save an issue priority

h3. Fields for Document categories

*Note*: document category custom fields are not (yet) used in the Redmine core, though other plugins or themes _can_ use them

* *Required*: field which is required in order to create/save a document category