Custom Fields

Custom Fields are extra fields that can be added to your entities to help gather, store, and organize data. You can create Custom Fields for almost any entity. There are static fields that you set manually and calculated ones that are automatically updated by Targetprocess.

Examples of Custom Fields are Text, Rich Text, Drop Down List, Multiple Selection List, Number, URL. Full list of types can be find below. Custom Fields allow you to expand Targetprocess business model in many, many ways.

Custom Fields and saved Custom Values are displayed on details page for a Targetprocess Entity, in the right column below Info and Lead Cycle Time panels. To modify the saved value click on a field row.

Custom Fields Panel

Should you want to Add / Edit / Remove a Custom Field, read the following article for the online help. Most Custom Fields are configured per process.

Custom fields on Views

It is possible to include Custom Field values on cards using Customize Cards feature:

Custom Fields on Cards

You can select, hide or highlight data in Views and Visual Reports by almost any Custom Field value using Advanced Filters by Custom Field values.

Custom Fields on cards may be highlighted according to manually set conditions. Activate Custom Unit Colored Custom Fields mashup for this purpose.

Cards on Board views can be distributed by Lanes according to their selected values in Custom Fields of Dropdown type.

Custom Fields as Lanes

Custom Fields in Reports

Custom Fields can be included to a Tabular report when the report is based on single process. In reports based on "All Processes" custom fields are not supported.

A process is set of rules, terms and custom fields that your project follows. Name of the process is displayed in Info panel on detailed view of your Project.

Custom Fields are supported in Visual reports: your entities may be grouped, colored and labelled by Custom Field values.

cf-labels

Supported field types are Text, Drop Down List, Multiple Selection List, Number, Money, Date, Check Box, Calculated.

Calculated Custom Fields

It is possible to create your own metrics with a Custom Field based on a specified formula. To do so, create a Custom Field with a Calculated field type and specify calculation formula.

Calculated Custom Field

Calculated Custom Fields are not supported in Tabular reports. Metrics are recommended as an alternative solution when reporting is required.

Improperly defined Calculated custom fields may badly affect performance of your system. We recommend to use Custom Units and Metrics instead when possible.

Entities that can have Custom Fields

The following Entities can have their own Custom Fields:

You can have up to 60 different Custom Fields per Entity type within each Process.

The length of any text stored in a Custom Field is limited to 4000 characters. This limit is also applied to total length of all values in Drop Down Lists.

What types of Custom Fields can I have?

There are more than 11 types of Custom Fields to choose from:

Text

Text

Text-type fields are free-form, single-line text boxes. They are not intended to hold large amounts of text data. You can apply filtering by these fields, and they can be displayed on Cards and in Lists.

Rich Text

Rich Text

Rich Text-type fields are free-form, multi-line text boxes. Such a field can contain images and hyperlinks, and allows some basic formatting such as bold, italic, underline, superscript, etc. You can apply filtering by these fields. These fields cannot be displayed on Cards and in Lists. There is also no way to mark a Rich Text-type custom field as required.

Drop Down List

Drop Down List

A Drop Down List-type field is ideal if users are restricted to a single choice out of multiple options. They are not free-form and require you to add each available option manually before such an option can be selected. Enter each of your available options in the Values box, putting each option on its own line. You can go back and edit these values at any time. Drop Down List fields are available on Cards and in Lists and can be filtered.

Multiple Selection List

Multiple Selection List

Multiple Selection List fields are used if multiple options are available. Options are selected exactly as in Drop Down lists. These fields are available on Cards and in Lists, and they can be filtered by exact match.

Check Box

Check Box

Check box-type fields are simple fields intended to hold a boolean (true/false) answer to a particular question. They are the simplest of all custom fields, as there are only two values available, and these values cannot be edited. However, their simplicity makes them ideal for classifying and filtering. These fields are available on Cards and in Lists.

URL

URL

URL-type fields are very similar to Text ones. URL custom values are broken up into two parts: a label and a URL. The URL is a standard Uniform Record Locator to a particular web page or document, and the label is a short free-form text. When these fields are displayed, the free-form text is displayed as a hyperlink to the web page or document. These fields are available on Cards and in Lists.

Template URL

You can find this field useful if you need to specify similar links. A good example is your external application: instead of specifying almost the same link every time, you can save the common part as a template and just add the ID of an external item.

Template URL Settings

You can add multiple links at a time - just use the comma when adding the data:

Template URL

Date

Date

Date-type fields hold a date value and display a date picker when entering or updating their values. Date fields are particularly useful for holding information such as due dates or other important dates, especially since they can be filtered on. These fields are available on Cards and in Lists.

Number

Number

Number-type fields are almost identical to Text fields, except for the fact that their input is restricted to numeric values. Decimals with up to 2 decimal places can be used as well. Number fields can be used in Filters and can also be shown on Cards and in Lists.

Money

The Money Custom Field handles a currency type. You might want using it for storing monetary values.

Money Custom Field

Money fields can be used in Filters and can also be shown on Cards and in Lists.

2016-03-12_1328

Targetprocess Entity

Targetprocess Entity is one of the most powerful custom fields. Targetprocess Entity field contains the pointer to another entity (User Story, Bug, Task, etc.) within Targetprocess. You can limit the types of entities that can be selected for this field. For example, you can add fields like "Found In" and "Resolved In" and limit the selection to Builds only. You can easily fill in the field using the look-up that opens once you hit the empty field.

Targetprocess Entity

When looking for a target item, you can search for the item ID, name (or its part), or use an advanced filter, similar to the View setup.

These fields are available on Cards and in Lists.

Multiple Targetprocess Entities

This type is similar to Targetprocess Entity, but you can specify several related items at a time.The main difference is that items will be displayed in a special tab, not in the default Custom Fields section:

Multiple Targetprocess Entities

There is another possible way to specify dependencies between items - using Relations Management that provide some additional functionality.

Mandatory Custom Fields

It is possible to enforce a Custom Field to require a non-empty input from a user. Required Custom Fields are displayed on the Quick Add forms. You cannot save the new Entity until all required values are provided.

Required Custom Field

Edit the settings of Custom Fields to make a field Required.

The Custom Field Constraints mashup makes a custom field required (non-blank) in either of the following cases:

  • Entity State Constraints: when an entity is moved to a specific workflow state;
  • Custom Field Constraints: when a specific value is selected in another custom field which can be Text, Drop-Down List, or Multiple Selection List.

Visibility in lists and ability to sort columns by Custom Field values

custom-fields-list-sort

Manage Custom Field settings

Should you want to Add / Edit / Remove a Custom Field, read the following article for the online help.

Cross-process Custom Fields for Projects

Instead of updating project custom fields in each Process separately, you can create a cross-process custom field for the Project entity. When you add a custom field for the Project entity, you can now choose the related processes. In this case, all the projects which run selected processes will use the same custom field, and you can edit it for all the projects in one place.

Cross-process custom fields for Projects

  • RMalick

    Is there a way to create a custom field where Field Type behaves the same way Tags do? So for example, I create a custom field called ‘Clients’. John edits UserStory-1 and edits the custom field to add his client ‘Alpha Tech’. Then John goes to UserStory-2 and edits the client field again. This time, as he types ‘Alp’, Target Process autofills/suggests ‘Alpha Tech’ similar to how it does it for Tags.

  • Alex

    Hi! No it is not possible. Please use field of type ‘Multiple selection list’ instead – it is the closest replacement to what you would like to achieve.

  • Ruchi Bhatia

    Can I move my custom field labels around so that I can have certain ones on the top and others at the bottom? Looks like they are showing up in the order they were created.

  • Sergey Gnedin

    @ruchi_bhatia:disqus It is not possible in the current version, but it should be added soon – correspondent improvement is already in development.

  • Matthew

    How can I use custom fields in visual encoding. I’m trying to set a color filter based on a custom field that’s a date but it’s not working. I’ve tried things like ?QANextTest == Today, but that gives an error. The field is called QA Next Test. I’ve also tried CustomField6.

  • Natalia

    Hi Matthew,
    The format of the color filter is correct. Most likely it shows the error because there are several types of entities are selected as cards (Stories, Bugs, Features), while not all the entities have ‘QA Next Test’ custom field. You can either leave only one type of entities as cards or create the same custom field for other entities.

  • Jesse

    Is it possible to add a custom field whose type is of User? For example: I want a custom field to track who peer reviewed a developer task, and I want people to be able to pick from the list of other developers on their team.

  • Sergey Gnedin

    @disqus_Y76zj2RENJ:disqus it is not possible to implement it via custom fields, I am afraid. You could, however, add a new role to Assignments sections, for example, “Reviewer” and assign people to that role as you wold do for developer. See https://www.targetprocess.com/

  • Jesse

    That would work except for the fact that, as far as I can tell, a user can only be assigned to one role per team. So I cannot be a developer and a reviewer. Correct me if I am wrong.

    In the meantime, I have simply added a custom text field, where people can just enter their initials.

  • Julia Pastushenko

    Hi Jesse,

    Actually project or team role only specify your permissions within this Team or Project.
    However, it does not limit you in what would be your role while working on tasks.

    So you can easily be a developer on a project and be assigned as a reviewer to some tasks in this project. Did you had a chance to look into the link Sergey has mentioned? It looks like it should cover your use case.

    It’s worth mentioning that using Assignment is a more natural approach to handling working on tasks under different roles than using custom fields. There would be a number of advantages, such as ability to use various filters. e.g. ?Assignments.Where(Role is ‘Reviewer’ and GeneralUser is Me)

    Hope this helps,
    Julia.

  • Jesse

    That worked, THANKS!

Still have a question?

We're here to help! Just contact our friendly support team

Find out more about our APIs, Plugins, Mashups and custom extensions. Join our community of passionate users and even discuss directly with our developers.