<title>5. Custom fields</title><linkrel="stylesheet"href="html.css"type="text/css"><metaname="generator"content="DocBook XSL Stylesheets V1.70.1"><linkrel="start"href="index.html"title="Documentation"><linkrel="up"href="ch01.html"title="Chapter 1. Administration"><linkrel="prev"href="ch01s04.html"title="4. Trackers"><linkrel="next"href="ch01s06.html"title="6. Issue status"></head><body><ahref="http://redmine.rubyforge.org/"><imgsrc="../redmine.png"alt="redmine"></a><divclass="navheader"><tablewidth="100%"summary="Navigation header"><tr><thcolspan="3"align="center">5. Custom fields</th></tr><tr><tdwidth="20%"align="left"><aaccesskey="p"href="ch01s04.html">Prev</a> </td><thwidth="60%"align="center">Chapter 1. Administration</th><tdwidth="20%"align="right"> <aaccesskey="n"href="ch01s06.html">Next</a></td></tr></table><hr></div><divclass="section"lang="en"><divclass="titlepage"><div><div><h2class="title"style="clear: both"><aname="d0e83"></a>5. Custom fields</h2></div></div></div><p>Custom fields allow you to add additional information in Projects, Issues or Users. A custom field can be of one the following types:</p><divclass="itemizedlist"><ultype="disc"><li><p><spanclass="guilabel">Integer</span> : positive or negative number</p></li><li><p><spanclass="guilabel">String</span> : a string of characters - one single line of input.</p></li><li><p><spanclass="guilabel">Text</span> : a string of characters with multiple lines of input. Differs from String Format by providing multiple lines of input instead of a single line.</p></li><li><p><spanclass="guilabel">Date</span> : date</p></li><li><p><spanclass="guilabel">Boolean</span> : true or false (check if necessary)</p></li><li><p><spanclass="guilabel">List</span> : value to select from a predefined list (aka: scroll list or select box)</p></li></ul></div><p>Validation elements can be defined:</p><divclass="itemizedlist"><ultype="disc"><li><p><spanclass="guilabel">Required</span> : A required field must have input in the forms</p></li><li><p><spanclass="guilabel">For all the projects</span> : field automatically associated to all of the projects</p></li><li><p><spanclass="guilabel">Min - max length</span> : minimum and maximum length for the input fields (0 means that there is no restriction)</p></li><li><p><spanclass="guilabel">Regular Expression</span> : regular expressions may provide validation of the input value</p><p>Examples:</p><p><codeclass="code">^\[A-Z]{4}\d+$</code> : 4 capital letters followed by one or several digits</p><p><codeclass="code">^[^0-9]*$</code> : characters only - no digits</p></li><li><p><spanclass="guilabel">Possible values</span> : possible values for the fields of "List" type. Values are separated by the character |</p></li></ul></div><p></p><divclass="section"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="d0e158"></a>5.1. Fields for Projects</h3></div></div></div><p></p><divclass="itemizedlist"><ultype="disc"><li><p><spanclass="guilabel">Required</span> : required field</p></li></ul></div><p></p></div><divclass="section"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="d0e169"></a>5.2. Fields for Issues</h3></div></div></div><p></p><divclass="itemizedlist"><ultype="disc"><li><p><spanclass="guilabel">For all projects</span> : field automatically associated to all project Issues</p><p>If this option is not activated, each project could choose whether or not to use the field for its Issues (please see the project configuration).</p></li></ul></div><p></p></div><divclass="section"lang="en"><divclass="titlepage"><div><div><h3class="title"><aname="d0e182"></a>5.3. Field for Users</h3></div></div></div><p></p><divclass="itemizedlist"><ultype="disc"><li><p><spanclass="guilabel">Required</span> : required field</p></li></ul></div><p></p></div></div><divclass="navfooter"><hr><tablewidth="100%"summary="Navigation footer"><tr><tdwidth="40%"align="left"><aaccesske
