Mantis Logo
Mantis Manual
Manual
Page Descriptions
System Management Pages

Manage Users
Manage Projects Page
Manage Custom Fields
Manage Global Profiles
Manage Configuration


Partner Links


Manage Custom Fields
Last Modified: April 17, 2005 17:04PM
(Any)
Description

This page is the base point for managing custom fields. It lists the custom fields defined in the system. There is also a place to enter a new field name to create a new field.

The "Edit" links take you to a page where you can define the details of a custom field. These include it's name, type, value, and display information. On the edit page, the following information is defined to control the custom field:
  • name
  • type. Possible values are listed below.
  • Value constraints (Possible values, default value, regular expression, minimum length, maximum length).
  • Access (who can read and write the field based on their access level).
  • Display control (where the field will show up and must be filled in
All fields are compared in length to be greater than or equal to the minimum length, and less than or equal to the manimum length, unless these values are 0. If the values are 0, the check is skipped. All fields are also compared against the regular expression. If the value matches the expression, then the value is stored. For example, the expression "/^-?([0-9])*$/" can be used to constrain an integer.

The table below describes the field types and the value constraints.




Type Field Contents Value Constraints
String text string up to 255 characters
Numeric an integer
Float a floating point number
Enumeration one of a list of text strings Enter the list of text strings separated by "|" (pipe character) in the Possible Values field. The Default value should match one of these strings as well. This will be displayed as a dropdown menu.
Email an email address string up to 255 characters When displayed, the value will also be encapsulated in a mailto: reference.
Checkbox zero or more of a list of text strings Enter the list of text strings separated by "|" (pipe character) in the Possible Values field. The Default value should match one of these strings as well. This will be displayed as a list of text strings with a checkbox beside them.
List one of a list of text strings Enter the list of text strings separated by "|" (pipe character) in the Possible Values field. The Default value should match one of these strings as well. This will be displayed as a multi-line dropdown menu.
Multiselection List zero or more of a list of text strings Enter the list of text strings separated by "|" (pipe character) in the Possible Values field. The Default value should match one of these strings as well. This will be displayed as a multi-line dropdown menu.
Date text string defining a date This is displayed as a set of dropdown menus for day, month, and year. Defaults should be defined in yyyy-mm-dd format.


The display entries are used as follows:



Entry Meaning
Display Only On Advanced Page If checked, the field will NOT be shown on the simple bug displays
Display When Reporting Issues If checked, the field will be shown on the report issues displays
Display When Updating Issues If checked, the field will NOT be shown on the update issue and change status displays
Display When Resolving Issues If checked, the field will NOT be shown on the update issue displays and change status displays, if the new status is resolved.
Display When Closing Issues If checked, the field will NOT be shown on the update issue displays and change status displays, if the new status is closed.
Required On Report If checked, the field must be filled in on the issue reports.
Required On Update If checked, the field must be filled in on the update issue and change status displays.
Required On Resolve If checked, the field must be filled in on the update issue and change status displays, if the new status is resolved.
Required On Close If checked, the field must be filled in on the update issue and change status displays, if the new status is closed.


Notes on Display
  • Be careful not to set both a required attribute and show only on advanced display. It may be possible to trigger a validation error that the user cannot recover from (i.e., field is not filled in).


User Contributed Notes
Manage Custom Fields
Add Notes About Notes
haseeb_qadir _at_the_rate_ hotmail.com
27-Apr-2005 18:33
#423
Does anyone know how to add custom textareas? Like the 'Description' area of a bug.
tleriche@icare-france.com
08-Jul-2005 9:16
#511
How Custom fields are supposed to work ?

I tried to create one, setting :
name: test1
Type: List
Possible Values: dog|cat|fish
Default Value: dog
Max. Length: 10

Others are default values.

It says "operations succefull" but it doesn't appear in the list of custom fields (the list stays empty). It is even not present in the "report issue" page :(

Does anyone have an idea ?

Titi.
quaak@home.nl
13-Jul-2005 15:19
#520
Can't see custom fields?
Using version 1.00a3?
Check the note from tryweb@ichiayi.com in the "Manage Custom field chapter" at "http://manual.mantisbt.org/manual.customizing.mantis.custom.fields.php"

This helped me!
Gr
joost

adeb58@hotmail.com
27-Jul-2005 11:23
#543
Does anyone know how to extend the allowable maximum size of the custom field entry -seems to be a set amount of characters allowed when creating a custom list/multi selection list
test@riambsoft.com
06-Sep-2005 2:57
#593
How can i define date's default value? My date format like 'yyyy-mm-dd'
James
06-Oct-2005 8:57
#636
I had the same problem for the date. I tried to set a default value but it never worked. Finally, I found out the solution: you must set the timestamp of the date you want to show. For instance, today (october the 6th) you have to set 1128603096

If someone have the solution to correct this bug, I would be very pleased.

Thanks
nm9mjdu02@REM0VEsneakemail.com
13-Feb-2006 3:08
#889
I'm thinking an enhancement would help here: the field name should not be the same as the Description text used as the label in the report entry. That is, one of the properties of the custom field should be an alternate description. If I have multiple projects that required a "Language" field, some projects will have different languages than others. If I call the custom field "Language2" or give it a longer name it will look silly.

I might add this myself if I can get my brain around it.
gael.demonneron@NOSPAMvitecmm.com
21-Mar-2006 5:02
#955
Could it be possible to have a custom field management specific to each project. That is to say : possibility to have same name for many custom field, with different value within.
For example :

MyProject_1; Techno family = "blabla_1 | blabla_2 | blabla_3"
MyProject_2; Techno family = "blabla_2 | blabla_4 | blabla_5"
Joe Wilkinson
12-Apr-2006 8:54
#995
Is it possible to add a custom field which behaves the same as the standard "version" field?
I.e. it should give a list of all versions for that project as set in the manage project options.
franklin.haut@bol.com.br
09-May-2006 20:30
#1062
Does anyone know how to add custom textareas? Like the 'Description' area of a bug ??

lnarayanan@americanhealthnet.com
29-Jul-2006 14:41
#1203
in mantis 1.0.0a2.

I made customizable field required on resolve. But this field is not displayed at the time of resolving issue.
yaregy12@hotmail.com
05-Jan-2007 11:36
#1339
when I create the field the bug report it tells me that it has been created and the bug report it does noe appear.
Why? Do you have an idea?
Add Notes About Notes
Last updated: Wed, 20 Aug 2008 - 5:30:29

Mantis @ SourceForge