The Menu Editor feature allows administrators to customize the GroundWork menu by modifying top-level and sub-menu items. Each of the menu items can be assigned secure access by role to determine who can access. GroundWork Monitor comes with a default set of menus items. This page provides an overview of the feature and how to manage the GroundWork menu.

About Menu Editor

The menu structure is hierarchical in nature with top level items including Home, Administration, Configuration, Dashboards, Reports, and Sign out. Many of the top-level items have underlying sub menus (folders) or pages. Administrators have access to add, reorder, edit, and delete menu folders and pages. 

groundwork menu structure

Taking a look at the Administration > Menu Editor, we see the Root path or the top-level position of the GroundWork menu. You can see (page icon) the menu item Home is a page in itself and the menu items Administration through Reports are folders containing additional folders or pages.

Pages and folders can easily be modified, deleted and reordered. And, user access to folders and pages is provided by roles .

It’s simple to add a menu item. You can add a new folder which contains pages, or add a new Internal Link or an External Link.

  • An Internal Link page is any internal page hosted on or proxied through the GroundWork server. These will require a relative URL to any GroundWork path, a user can select from a list of existing URLs. An example of an Internal Link is /it/business/index.php?r=businessServiceMonitoring/group which is the GroundWork path to the Configuration > BSM and SLAs > BSM menu item or page.
  • An External Link page is any other link. These will require a full path including protocol and domain. An example of an External Link may be to a common location users look for company monitoring reference. 

    menu editor structure

Customizing the GroundWork Menu

Folders are essentially menu items that hold pages (other menu items). A folders depth is limited to three levels.

  1. Select Administration > Menu Editor.
  2. The top level of the menu structure will be displayed, showing Root as the location and a list of the current GroundWork menu options.
  3. Click Add to Menu.
  4. Select New Folder.

    adding a folder
  5. Enter a Menu Display Name, this is displayed in the GroundWork menu.
  6. Enter a Menu Description, for display in the Menu Editor list.
  7. Enter one or more Roles or allow all roles access to the folder by checking the Permit All Roles box.
  8. Click Create Folder.

    folder properties

Pages can be in the form of either an Internal Link which uses a GroundWork path, or an external link which requires a full path including protocol and domain. Pages can be created at the Root level of the menu structure or created within a folder.

  1. Select Administration > Menu Editor.
  2. Click Add to Menu (if you are adding a page to a folder, click the folder name first).
  3. Select New Internal Link.

    adding a page
  4. Enter a Menu Display Name, this is displayed in the GroundWork menu.
  5. Enter a Menu Description, for display in the Menu Editor list.
  6. Enter a relative URL to any GroundWork path. You can use the Choose from existing link for a listing.
  7. Enter one or more Roles or allow all roles access to the page by checking the Permit All Roles box.
  8. Click Create Internal Link.

    page properties

Folders and pages can be reordered, edited and deleted. 

  1. To reorder pages simply use the up and down arrow icons to position the folder or page to the desired location.
  2. To edit a folder or page, select the corresponding Edit button.
  3. And to delete a folder or page, click the corresponding Delete button. If you are deleting a folder any underlying pages are also removed.

    reordering, editing, deleting

Use Case: Adding a Top-level Page

  • Specific users of GroundWork Monitor need to quickly access at-a-glance views of network operations pertaining to their infrastructure.
  • In this use case we create an easily accessible page which provides targeted NOC Boards. The page structure itself allows for an administrator to permit specific role and user access.
  • Specifically, we'll create a top-level page (Region 1), to display two NOC Boards (nocboard1, nocboard2), to be accessible to only the Role (GermanyRegion1 with assigned Group access) which is assigned to the Users (employee1 and employee2).
  • The NOC Boards will presents a host group's host services of unacknowledged problems which are not in downtime. That's it, the users will be able to access specific NOC Boards based on their login and will be presented with information they need.
  1. Create a new Role (e.g., GermanyRegion1) and assign a host group, see Users Roles and Permissions.
  2. Create a two new Users (e.g., employee1, employee2) assigning the new role from above, see Users Roles and Permissions.
  3. Create two new NOC Boards (e.g., nocboard1, nocboard2) selecting a host group, and filters for unacknowledged problems which are not in downtime, see NOC Board.
  4. Add a new page (e.g., Region 1) containing an Internal Link to the new NOC Boards:
    • Select Administration > Menu Editor.
    • Click Add to Menu, hover over and select New Internal Link.
    • Provide the information in the New Internal Link dialog box:
      • Enter a Menu Display Name (e.g., Region 1).
      • Enter a Menu Description (e.g., Region 1 Monitoring).
      • Enter the GroundWork link route (e.g., /nocboard, or click Choose from existing link). Then, check the boxes for the boards to be included (e.g., first for nocboard2 and then nocboard1, as we want have nocboard2 to be listed first).
      • In the Roles box, with Permit All Roles unchecked, enter GermanyRegion1 to limit access to only those users in this role.
      • Click Create.

        page properties

  5. Sign out and log back in as one of the new users (e.g., employee1). You should see the new page (e.g., Region 1) as a top-level menu option, and when selected it displays NOC Board 2 and NOC Board 1.

    new top level page

Related Resources