Field properties

The Fields tab displays the fields for the record type selected in the drop-down list at the top of the page.

Note A field marked with a lock is a locked system field that you may not edit (except for the Multilingual label property).

  • To view only the custom fields for the record, click Custom.

  • To view only the calculated fields, click Calculated. For more information on calculated fields, see Calculated fields.

  • To view all the fields for the record, click All.

The first column of the fields table displays indicator tags for the fields:

Analytic field. Can be added to analytic reports.

Operational field. Can be added to operational reports.

When you select a field, its properties appear in the right pane.

Property Description
Name

The name of the field. This field is required.

Caution  

  • The name of out-of-the-box fields is always in upper camel case. For example: ChangeCausedByRequest. You must follow this naming style.
  • The names of all custom fields must end with _c. This suffix is added automatically. You do not need to enter it manually.
Domain This property is read-only.
System

If selected, the field is a system field. You may not edit a system field.

Note You may not select this for a custom field.

Multilingual label

The label of the field which Service Management displays in the user interface.

This field is required.

Logical type

The field type. This field is required. For more information, see Logical type details.

Enable sort If selected, a user may sort the field when it appears in a record list by clicking the column header.
Enable search

If selected, a user may filter and report using this field.

Note A maximum of 2 fields per record may be defined as searchable.

Encrypted

If selected, the field is encrypted and can only be viewed by members of the selected encryption domain. Only relevant for fields of type MEDIUM_TEXT, LARGE_TEXT, and RICH_TEXT.

Encryption domain

Select the encryption domain used for this field. Only appears when Encrypted is selected. For more information on encryption domains, see Encryption domains.

Enforce uniqueness If selected, the value entered in the field must be unique.
Required If selected, this is a required field for the record.
Read only If selected, a user may not change the value of the field.
Hidden If selected, the field is visible only in the Fields Editor.
Tooltip The text that appears when you move the pointer over the field.
Placeholder The text that appears when the field is empty. You can use this to give instructions or reminders to users.

Logical type details

Type Description Maximum length Search5 Sort6 Maximum number of fields per record1
SMALL_TEXT Text 140 Yes Yes 40 (SMALL_TEXT, MEDIUM_TEXT, EMAIL, and URL combined)
MEDIUM_TEXT Text 5009 No Yes
EMAIL Text 254 No Yes
URL Text 2,048 No No
BOOLEAN Boolean - Yes Yes 19
LARGE_TEXT Text Up to 1,000,0009, 10 No No 15 (LARGE_TEXT, RICH_TEXT, and COMPLEX_TYPE combined)
RICH_TEXT1 Text Up to 1,000,0009, 10 No No
COMPLEX_TYPE2 Text 1,000,000 No No
IMAGE2 Text 2,048 No No 40
INTEGER Numeric - integer - Yes Yes 8
DOUBLE Numeric - double - Yes Yes 8 (DOUBLE and PERCENTAGE combined)
PERCENTAGE Numeric - double - Yes Yes
DATE Date - Yes Yes 8 (DATE and DATE_TIME combined)
DATE_TIME Date and time - Yes Yes
ENUM3 Enumeration value - Yes Yes 10
ENUM_SET8 Enumeration values - Yes Yes 0
ENTITY_LINK4 Record reference - Yes Yes 12

Note  

1 RICH_TEXT fields include the capability to copy and paste images.

2 You may not add this type of field for a custom field.

3 The values for ENUM fields are defined in the Lists module. For more information, see Lists.

4 You may only select an ENTITY_LINK of Person, Group, or customized records for a custom field by default. If you want to set up record references to other record types, select On in Enable custom entity link to support OOTB entities field in Application settings.

5 If the entry in this column is "Yes", you can filter the record using this property.

6 If the entry in this column is "Yes", you can sort the record using this property.

7 The number of new fields of that type that you can add to out-of-the-box records.

8 Used only for Data Domains fields. Allows you to add up to 250 values. You cannot use this to create a custom list. For more information, see Lists.

9 The maximum length of encrypted fields is lower than the limit for unencrypted fields of the same type.

10 The maximum size of a record containing such fields is 1,000,000.

Non customizable record types

The fields of the following record types are not customizable:

  • Agreement

  • Entitlement rule

  • Fulfillment plan

  • Group target sets

  • Record Category

  • Record Target Status

  • Service Level Target

  • Stockroom

  • Target Definition

  • Target Measurement

  • Target Set

  • Task

  • Task delegation configuration

  • Time Period

Related topics