Domain selection menus

The instance offers domain selection via two menu formats.

The available menu formats are:
  • Simple domain picker: provides a simple drop-down list of available domains.
  • Domain reference picker: enables a reference field that offers filtering and an auto-complete, type-ahead, entry feature. This format is suitable for longer lists.

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

Enable the domain reference picker in UI16

A property is available to enable the domain reference picker on UI16.

Before you begin

Role required: admin

About this task

This property is available with the domain separation plugin starting with Geneva Patch 4 and is set to true by default.

Procedure

  1. Enter sys_properties.list in the application navigator.
  2. Set the following property to true: glide.ui.domain_reference_picker.enabled.
    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.

  3. Refresh the browser.

Result

The domain reference picker appears in the UI16 header.

Enable the simple domain picker on UI11 and UI15

The simple domain picker is a drop-down list of available domains.

Before you begin

Role required: admin

About this task

On UI11 and UI15, you must enable a UI macro. On UI16 prior to Geneva patch 4, you can use the General tab on the System Settings page of the banner frame. Starting with Geneva patch 4, you must enable a property.

Procedure

  1. Navigate to System UI > UI Macros.
  2. Select the domain_select macro.
  3. Select the Active check box and click Update.
  4. Refresh the browser.
  5. Click the gear icon in the banner frame (UI15) or the Domain choice list (UI11).
    Figure 1. The Domain simple picker for UI15
    Simple domain picker

Enable the domain reference picker for UI11 and UI15

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 UI11 and UI15, you must enable a UI macro. On UI16, use the General tab on the System Settings page of the banner frame to enable only the simple domain picker. Starting with Geneva patch 4, you can enable a property to enable this domain reference picker.

Procedure

  1. Navigate to System UI > UI Macros.
  2. Select the domain_reference_picker macro.
  3. Select the Active check box, and click Update.
    Note: The domain_select 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). The Domain field appears by default on the banner in UI11.
    Figure 2. The domain reference picker for UI15
    Domain reference picker for UI15
  6. Click the magnifier icon in this field to open a list of domains that can be filtered for easy selection.
    List of domains
  7. To use the auto-complete feature, type a letter in the field. The menu displays all domains beginning with that letter.
    Figure 3. Autocomplete in UI15
    Display the domains

Restrict access to the domain picker (UI16)

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 and UI11)

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 (UI16).

Procedure

  1. Navigate to System UI > UI Macros.
  2. Select any of the four domain-related UI macros: two named domain_select and two named domain_reference_picker.
    There are two of each type two support different UIs. The UI macros with the Media Type field empty are for UI11, and the other two are for UI15.
  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.