Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.
Versions
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store
Close

Use domain selection menus

Use domain selection menus

The instance offers domain selection via two menu formats.

  • Domain selector: Provides a list of available domains.
  • Domain reference picker: Enables a reference field that offers filtering and an auto-complete, type-ahead entry feature. Use this format for longer lists.

The placement of these pickers and the procedure to show or hide them differ depending on the user interface version.

Enable domain selection menus in UI16

Displaying the domain picker in UI16 enables the domain selector by default. After enabling the domain selector, you can add a system property to enable the domain reference picker.

Before you begin

Role required: admin

About this task

Procedure

  1. Click the gear icon in the header.
  2. On the General tab, click the Show domain picker in header switch.
    The domain selector appears in the UI16 header.
  3. (Optional) Enable the domain reference picker.
    Note: Enabling the domain reference picker removes the global option from the list. To return to your home domain, click the return arrow next to the reference field. Admin users can click the return arrow to return to the global domain.
    1. Enter sys_properties.list in the application navigator.
    2. If not already present, add the glide.ui.domain_reference_picker.enabled property and set the value to true.
    3. Refresh the browser.
    The domain reference picker appears in the UI16 header.

Enable domain selection menus in UI15

Enable the domain selector or the domain reference picker. Use the domain reference picker with auto-complete for long lists that require excessive scrolling.

Before you begin

Role required: admin

About this task

On UI15, you must enable a UI macro.

Procedure

  1. Navigate to System UI > UI Macros.
  2. Select a macro depending on the type of menu you want to enable.
    OptionDescription
    domain_select Enables the domain selector
    domain_reference_picker Enables the domain reference picker
  3. Select the Active check box, and click Update.
    Note: If using the domain reference picker, the domain_select macro must be set to false. If using the domain selector, the domain_reference_picker macro must be set to false.
  4. Refresh the browser.
  5. Click the gear icon in the banner frame to show the Domain field (UI15).

Result

Figure 1. The domain selector for UI15
Domain selector
Figure 2. The domain reference picker for UI15
Domain reference picker for UI15

Restrict access to the domain picker

Use a system property to restrict access to the domain picker in UI16.

Before you begin

Role required: admin

About this task

By default, users with the ITIL role, and roles that include the ITIL role (such as the administrator), can access the domain picker in UI16. You can grant other roles access by adding them to the property or restrict roles by removing them.

Procedure

  1. Open the System Properties [sys_properties] table.
  2. Add this property: glide.ui.domain_picker.role
  3. Configure the property value as a comma-separated list of roles that you want to access the domain picker.

Restrict access to domain selection by role (UI15)

You can include a comma-separated list of roles in domain-related UI macros to restrict access to domain selection by user role.

Before you begin

Role required: admin

About this task

This procedure is valid for the pre-UI16 interface. Starting with UI16, you must use a system property to control access to the domain picker. See Restrict access to the domain picker.

Procedure

  1. Navigate to System UI > UI Macros.
  2. Select either of the two domain-related UI macros: domain_select ordomain_reference_picker.
  3. Locate one of the following lines of code:
    • domain_select:
      var ds =new DomainSelectControl("gsft_domain","itil","Domain","Domain");
    • domain_reference_picker:
      var dp =new DomainPicker("${jvar_id}","itil","DomainReference","Domain");
  4. Replace the parameter itil with a comma-separated list of roles to control who sees the domain selection menu.