Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. Desktop App 6.2.x.278
  4. Desktop App Installation and Administration Guide
  5. Operation
  6. System tray menu

System tray menu

You can configure the items that appear in the Desktop App system tray menu. 
To add system tray menu items to the desktop app, complete the following steps:
  1. Log in to the BlackBerry AtHoc management console as an administrator.
  2. In the navigation bar, click the The Settings icon (Settings) icon.
  3. In the Devices section, click 
    Desktop App
    . The Desktop App window opens. 
  4. In the System Tray Menu section, select the 
    Display System Tray
     check box.
  5. Click 
    Manage Menu Items
    . The Desktop App Menu Items window opens.
  6. Click 
    Add Menu Item
    . The Add Menu Item window opens.
  7. Enter a name and URL for the new menu item.
  8. Click 
    Save
    . Take note of the ID of the new menu item.
  9. Add the new menu item to the Menu Configuration XML in the Menu Configuration field.
    Menu items have this format: <Item Id="8009" Type="Link"/> 
  10. (Optional) Add a separator to the Menu Configuration XML.
    Separators have this format: <Item Type="Separator" />
  11. (Optional) Cut and paste the code for each additional function to add or move menu items and separators. 
  12. Click 
    Save
    .
The default functions include the following items:
Option
Code
Check for New Alerts
8009
Dismiss All Popups
8022
Access Self Service
521
Update My Info
530
Update My Device Info
531
About
8005
The following is a sample Menu Configuration XML:
 
<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 in order for the change to take effect.
Addition or removal of a menu item is picked up by desktop app clients at the next check update. Changes to a menu item take effect immediately (without CU) because the GS request is processed server-side, and the resulting service URL is sent back to the desktop app.
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.
Add a custom URL
Custom URLs can contain query string parameters. Five predefined values allow you to use user-specific data. The Static value allows you to hard-code a name-value pair.