Customize the desktop client system tray
The system tray icon () appears in the system tray when the desktop app is running. You can change the order of the links that appear in the desktop app system tray using an XML-based menu control. You can also move the link separator up or down and add additional link separators as needed.
- In the navigation bar, click
.
- In the Devices section, click Desktop App.
- On the Desktop App screen, in the System Tray Menu section, select Display System Tray Icon.
- 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.
- In the Available Menu Items section, click Manage Menu Items.
- 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.
- On the Desktop App Menu Items window, click Add Menu Item.
- On the Add Menu Item window, enter a name and URL for the new menu item.
- Click Save. Take note of the ID of the new menu item.
- Click Close.
- 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"/>.
- Optionally, add a separator to the Menu Configuration XML. Separators have this format: <Item Type="Separator" />
- Optionally, cut and paste the code for each additional function to add or move menu items and separators.
- Click Save.
The following menu items are available:
|
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 |
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>For more information, see "System tray menu" in the BlackBerry AtHoc Desktop App Installation and Administration Guide.