View choice list definitions

The Choice Set [sys_choice_set] table contains a record for every field that uses a choice list.

Avant de commencer

Role required: personalize_choices

Remarque :

The personalize_choices role must be explicitly granted to the user; it cannot be an ACL.

Pourquoi et quand exécuter cette tâche

The choice set record is associated with an application file, which allows update sets and team development to track and transfer all choices for a field in a single update record.

Choice list values allow a maximum length of 40 characters. The range of allowable numerical values is [-999, 999].

Procédure

1. Right-click the choice list field label and select Show Choice List.
   To view other choice list values, modify the filter at the top of the list.

   Remarque :

   When you use an ACL to grant personalize_choices on a particular field, Show Choice List is not available. It is only available if you explicitly grant the role to the user. Configure Choices continues to appear regardless of whether it is an ACL or an explicitly granted user role.
2. Review the items in the list.
   Avertissement :

   Do not add new choices to the list. To add new choices to a choice list field, use the Configure Choices option.

Define an option for a choice list

You can personalize the options that are available in a choice list.

Avant de commencer

Role required: personalize_choices

Procédure

1. Navigate to a form where the field appears.
2. If the choice list is dependent on another field, enter the choice value that the options depend on.

   For example, on the incident table, the Subcategory is dependent on the Category. To customize which subcategory choices are available for the hardware category, select Hardware in the Category field.

3. Right-click the field label and select Configure Choices.
4. Use the slushbucket to rearrange the order, add, or remove items or to create new items.
5. Click Save.

   To dynamically add items to a choice list, use the addOption GlideForm method .

   Remarque :

   Some business rules may be affected by changes to choice list options (for example, default Incident states).

Reuse a choice list

After defining a set of choice list values, you can reuse the values for another field in a different table.

Avant de commencer

Role required: personalize_choices

Procédure

1. Right-click an existing choice field (Field A) and select Configure Choices.
2. Add the desired choice list values in the Choices related list.
3. To reuse the choice list values for another field (Field B) in a different table, right-click the label for Field B and select Configure Dictionary.
4. In the Choice table field, select the table where Field A resides.
5. In the Choice field field, select Field A.

   

6. Click Update.

   The choice list values defined on Field A are displayed on Field B. When you add or remove choice list values on Field A, those changes are also reflected on Field B. After you specify a choice table and a choice field, the field no longer uses the defined choice list.

Remove the None option from a choice list

You can remove the None option from a choice list if it is not necessary.

Avant de commencer

Role required: personalize_dictionary

Procédure

1. Navigate to a form where the field appears.
2. Right-click the field label and select Configure Dictionary.
3. Change the Choice field value to Dropdown without -- None -- (must specify a default value).

   

4. Ensure that the Default field is populated to determine which choice is displayed by default.
   Remarque :

   If the field is dependent on another field, the -- None -- option remains available.

Change the None display value for a choice list

You can change the default display label of the None option for a choice field.

Avant de commencer

Role required: personalize_choices

Remarque :

The personalize_choices role must be explicitly granted to the user; it cannot be an ACL.

Procédure

1. Navigate to a form on which the field appears.
2. Right-click the field label and select Show Choice List.
3. Click New.
4. Complete the form.

   Tableau 1. Choice form fields

   Field	Value
   Table	Select the table.
   Element	Leave the name of the field that is automatically populated.
   Language	Enter ISO language code for the label.
   Sequence	Leave empty. This field determines the order.
   Inactive	Leave cleared.
   Label	Enter the label to appear in the choice list. You can use JavaScript, including calls to script includes, to define the label. For example, the JavaScript label in the following example changes the -- None -- value of the Time zone choice list in a user record to use the time zone value of the instance.
   Value	Enter NULL_OVERRIDE. Remarque : You must enter NULL_OVERRIDE as the value, or the new label appears in addition to the -- None -- option.
   Dependent value	Leave blank.
   Hint	Leave blank. Remarque : When field type is set to List (Glide List) the hint won't display.

5. Click Submit.

Delete all choice list options

You can delete all choices for a choice field from the Choice Set record.

Avant de commencer

Role required: personalize

Pourquoi et quand exécuter cette tâche

You may want to use this method when you are developing a new application and the business requirements change. If you are updating a choice list that is already in use, consider deactivating the options you no longer use to avoid conflicts with existing data or scripts that may rely on the previous options.

Procédure

1. In the navigation filter, enter sys_choice_set.list and press Enter.
2. Open the choice set record for the field.

   For example, to locate the choice set for the incident subcategory, filter by [Table] [is] [incident] AND [Element] [is] [subcategory].

3. Check the box beside the choice set record to delete and select Delete from the Actions choice list below the list.
4. Click Delete in the confirmation window.
   All choices for the field are deleted.

Create a choice list for another field type

You can create a choice list for a field with another type, such as an integer, string, or reference field.

Avant de commencer

Role required: personalize_dictionary

Pourquoi et quand exécuter cette tâche

You can use this configuration to standardize data entry and limit available options for a field while still maintaining the original field type.

Procédure

1. Navigate to All > System Definition > Dictionary.
2. Open the dictionary entry for the field.
   Remarque :

   Reference fields with a large number of records in the reference table cannot be converted to look like choice fields. A reference field with too many records reverts to looking like a reference field.
3. Change the Choice value to Dropdown with --- None --- or Dropdown without --- None --- (must specify a default value).
4. Right-click the form header and select Save.
5. Click Create Choice List.
   • The Choices related list appears on the dictionary entry form.
   • If records on the table contains data for the field, a choice list value for each unique field value is created. For example, if three records exist on the table and each record has a unique value in the field, then three choices are created.
   • If no data exists in the field, a choice list value of -- New choice -- is created.

Display invalid choice list values

By default, inactive or invalid choice list values appear in blue text instead of black. You can disable the color indicator for invalid choices.

Avant de commencer

Role required: admin

Pourquoi et quand exécuter cette tâche

In the following example, the Network category has been deactivated, so it appears in blue for records that still contain the inactive value.

Procédure

1. Navigate to All > System Properties > UI Properties.
2. Clear the check box for the Display missing choice list entries property.

Add search option to a choice field

Add a search field to choice fields that have a long list of options.

Avant de commencer

Role required: admin

Procédure

1. Navigate to a form that contains choice fields.
   For example, incident.
2. From a choice field on the form, for example State, right-click the field and select Configure Dictionary.
3. Switch to the advanced view for the dictionary entry form using the context menu by navigating to View > Advanced.
4. In the Attributes field, type is_searchable_choice=true.
   If there are other entries in the attributes field, use a comma to separate the entries.
5. Update the Dictionary Entry form and reload the page containing the choice list.

Résultats

The choice list contains a search field that users can use to filter the list of choices.

Figure 1. Choice field search