Configuring Custom Fields

Overview

Custom fields allow you to capture and display additional data on various system elements (accounts, packages, usage records, etc.) for reference/reporting purposes or in order to expose the information externally (e.g. displaying the data on an invoice or presenting the data in a web portal via API). The order and presentation of custom fields is configured on the layout screen.

Prerequisites

Custom fields can be setup immediately, there are no requirements to setup other system elements.

Custom Fields Panel

The Custom Fields panel on the left of this screen allows you to select existing custom fields to view and edit on the Edit Custom Field panel to the right. Actions are also available in this panel which are shown as icons above the Filter text box. The available actions are described below.

Actions

Icon	Description
	Deletes the custom field if not in use (added to an entity or layout)
	Adds a new custom field

Edit Custom Field Panel

The information in this panel reflects the currently selected custom field. From here you can change custom field details (fields will display a red left border if a value is required and purple text if the field is read-only and cannot be modified).

Custom Field Fields:

• Name: a name for the custom field (e.g. the data it holds)

• Column Name: the database field name

• Description: additional details that describe what data is contained in the field

• Hint: hint text that will appear in the field to indicate what the user should input

• Required: if enabled the user will be required to populate the custom field in order to add/update the entity that the custom field is attached to

• Default Value: sets a default value in the custom field when adding an entity which contains the custom field

Value tab

This tab appears when the custom field has been configured to provide a list of values to select from. On this tab you can add, edit or remove values presented in the custom field list and adjust the order that the list items appear in.

Validation tab

This tab allows you to set the format that the data typed into the custom field by the user must conform to. This tab will not appear if the value is selected vs. inputted (e.g. if the 'Field Type' setup when adding the custom field is 'Date' this tab will not appear as dates are selected not typed in by the user). You can select a 'Custom' validation on this tab if you wish to supply your own Regex that the data entered must match.

Lookup tab

This tab appears when the custom field has been added with the 'Lookup' option enabled. Lookup custom fields are configured to pull data from the system in order to automatically populate the custom field.

References tab

This section displays where the selected custom field is used in the system. By default the reference data is displayed in a summary format to indicate where the field is in use, however the Entity drop down field can be used to view the exact system objects that the custom field is configured on.