Project

General

Profile

RedmineCustomFields » History » Revision 4

Revision 3 (Tharuka Pathirana, 2010-08-09 11:52) → Revision 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