System Tray Menu

For new desktop app deployments, the BlackBerry AtHoc Management System menu item in the desktop app system tray menu is no longer included by default. Enterprise Administrators and Organization Administrators can add the BlackBerry AtHoc Management System menu item in the System Tray Menu XML. If the menu item is added, all operators connected to the desktop app will start to see the menu item after the next get update (GU) call. For existing desktop app deployments, the BlackBerry AtHoc Management System menu item will be removed from the desktop system tray menu when:
  • An Enterprise Administrator or Organization Administrator makes any update to the system tray menu XML.
  • The desktop app gateway is saved.
  • The desktop app completes a GU call to retrieve new System Tray Menu XML for the organization.

Only users with operator permissions will see the BlackBerry AtHoc Management System menu item.

Operators can configure the items that appear in the Desktop App system tray menu.

  1. Log in to the BlackBerry AtHoc management console as an administrator.
  2. In the navigation bar, click The Settings icon.
  3. In the Devices section, click Desktop App.
  4. On the Desktop App screen, in the System Tray Menu section, select Display System Tray Icon.
  5. Optionally, select the Desktop Operator Login Link option. Select this option if you have SSO enabled in your organization. This option allows desktop links, such as the "Access My Profile" link, to authenticate operators through your organization's SSO provider. This option is enabled by default.
  6. In the Available Menu Items section, click Manage Menu Items.
  7. On the Desktop App Menu Items window, click Add Menu Item.
  8. On the Add Menu Item window, enter a name and URL for the new menu item.
  9. Click Save. Take note of the ID of the new menu item.
  10. Click Close.
  11. In the Menu Configuration field, add the new menu item to the menu configuration XML. Menu items have this format: <Item Id="8009" Type="Link"/>.
  12. Optionally, add a separator to the Menu Configuration XML. Separators have this format: <Item Type="Separator" />.
  13. Optionally, cut and paste the code for each additional function to add or move menu items and separators.
  14. Click Save.

The following menu items are available:

The following is a sample Menu Configuration XML:

Option

Included by default

Code

About

Yes

8005

Access My Profile

Yes

520

Access Self Service

Yes

521

Always Minimize Deskbar to System Tray

No

8015

Auto Hide Deskbar

No

8012

BlackBerry AtHoc Management System

Yes

532

Check for New Alerts

Yes

8009

Clear Search Box History

No

8002

Connection Options...

No

8008

Deskbar always on top

No

8013

Dismiss All Audio Notifiers

No

8021

Dismiss All Desktop Popups

No

8020

Dismiss All Popups

Yes

8022

Enable Popup Auto Focus

No

8025

Exit

No

8006

Show Deskbar

No

9002

Uninstall

No

8004

Update My Device Info

Yes

531

Update My Info

Yes

530

<SystrayLayout>
  <Item Id="8009" Type="Link" />
  <Item Id="8022" Type="Link" />
  <Item Type="Separator" />
  <Item Id="521" Type="Link" />
  <Item Id="530" Type="Link" />
  <Item Id="531" Type="Link" />
  <Item Type="Separator" />
  <Item Id="8005" Type="Link" />
</SystrayLayout>

There are global menu items and items that are private to a specific organization. Global menu items are defined in one of the setup providers, for example organization 3 and organization 1. Private menu items are defined in the working organization.

A global change to one of the existing menu options such as 521 “Access Self Service” can be made in organization 1. A change to the global setting (for example the query string) affects server-side processing, so there is no need for desktop app clients to do a check update for the change to take effect.

Addition or removal of a menu item is picked up by desktop app clients at the next get update.

When a public menu item is deleted without changing the system tray menu XML, users will see a server error when accessing the menu option.