Skip to main content

Customizing Display Names for Custom Fields and Columns - File Based

This article explains how to customize the display names for custom fields and columns in Agility.

Refer to the Localization article for more information on customizing display names.

Beginning in Winter 2020, 19.3.9.40, and 19.2.15.71 you can customize Custom Field Names from the Terminology page. Refer to the current help topic for more information.

To make custom fields visible, you must first publish the them, and then assign them to a custom column. To change the display name of a custom field, you must localize its custom column, as follows:

  1. Edit your en.company.txt file (or create one if not already there) in the Strings directory under the Digital.ai Agility application on your webserver.
  2. To localize a column currently named OriginalColumnName to display as Shoe Size, add an entry such as example below:
ColumnHeading'Custom'OriginalColumnName=Shoe Size
ColumnTitle'Custom'OriginalColumnName=Shoe Size
ColumnDescription'Custom'OriginalColumnName=The member's shoe size

The ColumnHeading entry sets the label for the field in the details pages and the column header in grids. The ColumnTitle entry sets the title of the column in the grid's customize page. The ColumnDescription entry sets the description of the column in the grid's customize page.

Custom Field Enhancements

The following enhancements were made for Custom Fields in Agility:

Hover-to-View Descriptions

Users can now view descriptions for custom list type values simply by hovering over the field value. This functionality provides instant access to additional context and information, improving understanding and reducing the need for separate documentation.

Question Mark Icon for Custom Fields

For custom fields with descriptions, Agility now displays a? question mark icon. When users hover their mouse over this icon, a tool tip appears, showing the custom field’s description. This feature ensures that important information is always accessible without cluttering the interface.

Procedure to add description to a Custom Field

  1. From the main menu navigate to Admin > Terminology
  2. Under Configured Languages, select en
  3. In the Custom Column tables select the custom label for Browser Test
  4. Copy the label and paste it in Add an Override in Other Labels section.
  5. Add Description to the Custom Column label and click the + sign
  6. Enter the required description, in this case we have included Testing.
  7. Click Save.

How to view the description for the Custom Column

  1. From the main menu, navigate to Product > Backlog
  2. Click any Backlog Item
  3. Click More in the Backlog grid.
  4. Browser Tested column is visible, hover over the ? icon to see the description.