Managing user-defined fields

About user-defined fields

User-defined fields (UDFs) are custom fields for data that cannot be mapped to the standard Autotask field set. They are created in two ways:

  • Autotask administrators can set them up for various entities. This type of user-defined field can be created, edited, and deleted with few restrictions. Refer to Adding a User-Defined Field.
  • They are generated automatically when a remote monitoring extension is enabled. This type of user-defined field cannot be deleted. Refer to System UDFs for remote monitoring extensions.

Managing UDFs

User-defined fields for all entities are managed from Left Navigation Menu > Admin > Admin Categories > Features & Settings > Application-Wide (Shared) Features > User-Defined Fields. Each tab represents one of the Autotask entity types that support UDFs. To open the page, use the path(s) in the Security and navigation section above.

A right-click menu includes the following options:

Menu option Description

Edit

For system UDFs for remote monitoring extensions, only the Required check box and the Sort Order field are editable.

Convert to Site Configuration / Convert to Organization

 Organization UDFs and site configuration UDFs are both associated with the Organization entity. Organization UDFs are intended for sales information, and Site Configuration UDFs, for technical information. One type can be converted into the other. Refer to Converting Organization UDFs to Site Configuration UDFs.

Inactivate

When you inactivate a user-defined field, the data is still available to search and report on. Its visibility on entities that use categories (ticket, task, opportunity, and device) will be controlled by the category. If you no longer want the UDF to appear on those entities, you will need to modify the categories it is associated with. If it appears on the entity category, it will be editable.

On other entities that do not use categories, the UDF will no longer appear. For example, an inactive organization UDF does not appear on the New Organization, Edit Organization, or Organization page.

The field remains visible if it was selected for display as a column in a table when the UDF was inactivated. It is still available for selection in column choosers on tables.

Inactive UDFs remain available for dashboard tab widgets (as a Report On, Also Report On, Group By, Filter, Table columns) and widget tables, notification and invoice templates, contact action templates, and contact groups.

Inactive UDFs are not available to select as conditions or updates in workflow rules. They are not available in the import templates for the organization/contact, device, or product importers. You will not be able to populate or update inactive UDFs via the importers.

Delete

User-defined fields created by someone in your company can be deleted.

IMPORTANT  When you delete a UDF, all of its associated data will be deleted, as well. You will get a warning dialog, but once you click OK, this deletion is permanent and cannot be undone.

The following limitations apply:

  • The UDF is associated with a workflow rule. In this case, you must edit the workflow rule and disassociate the UDF so it can be deleted.
  • The UDF is associated with a widget. In this case, you must edit the widget and disassociate the UDF so it can be deleted.
  • User-defined fields that are generated automatically when a remote monitoring extension is enabled cannot be deleted. Refer to System UDFs for remote monitoring extensions.
  • If the UDF is assigned as an IsDisplayAlwaysFields for any webhook configurations, you will receive a warning dialog that the webhook will be inactivated if you proceed with the deletion.

NOTE  If a UDF list option is associated with an entity, form template, widget, or workflow rule, it cannot be deleted until it is disassociated from the entity.