Create or modify Dependency Views menu actions

Best practices dictates that you modify a copy of the original menu action.

About this task

To modify an existing menu option, first you create a copy of the original menu action record, and then you modify the copy. This ensures that ServiceNow can update the record normally during the upgrade process and allows you to quickly restore the original menu option, if necessary.

Procedure

  1. To create a new menu option, navigate to Dependency Views > Map Menu Actions and click New.
    Fill in the fields on the form, as appropriate. See the Menu Action form table.
  2. To modify an existing menu option, navigate to Dependency Views > Map Menu Actions.
  3. Open the menu action you want to edit.
  4. Right-click in the header and click Insert and Stay.
    This step creates a duplicate copy of the menu action and leaves it open for editing.
  5. Change the name of the copied record to avoid confusion.
  6. Modify the form fields as necessary and save the record.
  7. Open the original record and disable it by clearing the Active check box.
    Table 1. Menu Action form
    Control Description
    Name Descriptive name that appears as the menu option.
    Active Check box that allows you to enable or disable this record.
    Condition Condition that triggers the display of this menu option. If the condition evaluates to false the menu option does not display. Script is evaluated in JavaScript in the user's browser and does not have access to all the APIs that Business Rules do. For details on available parameters, see Condition Parameters. .
    Item Map element for which the menu option displays. Valid values are:
    • Canvas for the menu on the map background.
    • Node for the menu on a CI.
    • Relationship for the menu on a relationship link.
    Order Physical location of the option in the menu. The option with the lowest order number appears first in the menu. All editable and custom options appear below the permanent menu options.
    Script Script that is executed in the browser when the menu option is selected. Script is evaluated in JavaScript in the user's browser and does not have access to all the APIs that Business Rules do.
    Type Menu action type being created, either a menu option or a menu separator. The menu separator is a single line. When the type is a separator, the Script field is ignored.