How to manage menu items

REDIRECT: This URL has changed to https://support8.gwos.com/gw/gw8/latest/documentation/administration/menu-editor
Click the link above if you are not automatically redirected in 10 seconds.

Adding a folder

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.

    new 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.

    new folder dialog

Adding a page

Pages can be in the form of either an internal GroundWork 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 GroundWork Link.

    new groundwork link
  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.

    new internal link

Reordering, editing, deleting folders and pages

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 trashcan icon. If you are deleting a folder any underlying pages are also removed. 

    folder options

Use Case: Adding a top-level page

Use Case - 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) 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), How to create a new role.
  2. Create a two new Users (e.g., employee1, employee2) assigning the new role from above, see How to create a new user.
  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 How to create NOC boards.
  4. Add a new page (e.g., Regions 1) containing an internal link to the new NOC Boards:
    • Select Administration > Menu Editor.
    • Click Add to Menu, hover over and select New GroundWork 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 use 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 Internal Link.

        new internal link roles

  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 page example

Related articles