Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. Desktop App 7.7 (Windows), 2.6 (Mac)
  4. Desktop App Installation and Administration Guide
  5. Operation
  6. System tray menu

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
     window, in the
    System Tray Menu
     section, select
    Display System Tray Icon
    .
  5. In the
    Available Menu Items
     section, click
    Manage Menu Items
    .
  6. On the
    Desktop App Menu Items
     window, click
    Add Menu Item
    .
  7. On the
    Add Menu Item
     window, enter a name and URL for the new menu item.
  8. Click
    Save
    . Take note of the ID of the new menu item.
  9. Click
    Close
    .
  10. 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"/>.
  11. Optionally, add a separator to the Menu Configuration XML. Separators have this format: <Item Type="Separator" />.
  12. Optionally, cut and paste the code for each additional function to add or move menu items and separators.
  13. 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.