Skip Navigation

Basic
BlackBerry AtHoc
test procedures

The following tables provides detailed instructions on the basic
BlackBerry AtHoc
test procedures.
Log in
Description
Expected result
Open a browser, and navigate to the Management System application. To do this, navigate to the
<AtHoc-ENS-URL>
. For example,
https://alerts.company.com
(if SSL is used).
The login page displays.
Log in as an administrator.
The
BlackBerry AtHoc
management system home page displays.
In the navigation bar, click The Settings icon.
Connect a client
Description
Expected result
Install a desktop software client, as described in the
BlackBerry AtHoc
Desktop App Installation and Administration Guide
.
The desktop software is installed on the user's computer and the user appears in the User manager.
Custom attributes
Description
Expected result
Open the
BlackBerry AtHoc
management system. In the navigation bar, click The Settings icon.
Click
Users
>
User Attributes
. On the
User Attributes
page, click
New
.
Create a multi-select picklist attribute whose Attribute Name is
Test
.
Assign two pick-list values to the Test attribute:
T1
and
T2
.
Click
Save
to create the pick list attribute.
A pick list attribute named
Test
is created.
Create a number attribute named
ID
.
A number attribute named
ID
is created.
Create a text attribute named
Comments
.
A text attribute named
Comments
is created.
Select the pick list attribute named
Test
and click
Delete
.
The
Test
attribute is deleted.
Hierarchy editing
Description
Expected result
In the navigation bar, click The Settings icon.
The Settings page opens.
From the
Settings
page, in the
Users
section, click
User Attributes
.
The User Attributes screen opens.
On the
User Attributes
screen, select the attribute that is of the Type
Path
.
The Organizational Hierarchy settings page opens.
In the
Values
section, add or delete a node.
Click
Save
.
A Success message is displayed.
In the navigation bar, click The Settings icon.
The Settings page opens.
From the
Settings
page, in the
Users
section, click
Distribution List Folders
.
The Distribution List Folders screen opens.
On the
Distribution List Folders
screen, add or delete a node.
Click
Save
.
A success message is displayed.
Distribution lists
Description
Expected result
In the navigation bar, click
Users
. Click
Distribution Lists
.
Create a static list named
Stat1
and add your user ID as a member.
The
Members
field displays
1
.
Create a dynamic list named
Dyn1
and add a criteria that includes your user ID in the results.
Import or export users
Description
Expected result
In the navigation bar, click the
Users
>
Users
.
The
Users
page opens.
Click
More Actions
>
Import
>
Users
.
Download a template CSV file. An Excel spreadsheet opens and must (if new install) contain only the selected User ID.
Excel must be installed on your computer. If you do not have Excel, use Notepad to view the .csv file content.
The file must contain all static lists, custom attributes, and devices.
Fill in all required fields.
Save the file with the name
test.csv
.
Return to the management system and continue from the
Import User File
page.
Select the import CSV file:
  1. Click
    Browse
    .
  2. In the file selection dialog, navigate to and select the
    test.csv
    file.
  3. Right-click and select
    Open with
    to confirm the selection of the file.
  4. Click
    Open
    .
  5. Click
    Import
    .
The Import User Progress window opens and all users are successfully processed. The
Last import
field displays the correct date and time of the import.
Click
Download Log
and in the
File Download
dialog, select
Open
.
An Excel spreadsheet opens and displays all the users from the CSV file. The
AtHoc
Import Result column contains the value
OK
and each user has a unique user ID.
Compare the Users list with the import CSV file. To open the CSV file:
  1. From the
    Users
    page, click
    More
    >
    Actions
    >
    Import
    >
    Users
    .
  2. Click
    Browse
    and open the import .csv file.
An Excel spreadsheet opens and contains the current user and the users that were imported.
In the navigation bar, click
Users
>
Users
.
All qualified users display in the table.
Spot check users to verify that the correct details have been imported.
The details pane at the bottom of the screen displays the correct information for the selected end user.
Alert templates
Description
Expected result
In the navigation bar, click
Alert
>
Alert Templates
.
The Alert Templates page opens.
Click
New
.
The New Alert Template screen opens.
Create an alert template named
SC1
.
For the new template:
  1. Select
    Available for Quick Publish
    .
  2. Add the title and body.
  3. Add a response option.
  4. Target one or more users.
  5. Select delivery to the following device: Desktop popup.
  6. Check spelling.
Save the alert template.
An alert template named
SC1
is created.
Alert publishing
Description
Expected result
In the navigation bar, click
Alerts
>
New Alert
.
The Select from Alert Templates page opens.
Publish an alert template:
  1. Select the
    SC1
    alert template and click
    Edit
    .
  2. In the
    Target Users
    section, click review the users in the Targeting Summary.
  3. Click
    Review and Publish
    .
  4. Click
    Publish
    .
All qualified users are targeted. The Sent Alerts list displays the published alert with a Live status. If the status is still Scheduled, wait 15 seconds and re-select
Sent Alerts
to refresh the display. The status must be live in no more than 15 seconds from template activation.
Wait up to two minutes for the alert to arrive on the users desktop. After you receive the pop-up, click
Acknowledge and Close
.
The desktop pop-up displays and an audio alert plays (if speakers are connected and audio is enabled).
Upon acknowledgment, the pop-up must disappear.
Self Service
Description
Expected result
From the user's computer, right-click the
AtHoc
desktop software system tray icon (The Desktop App icon) and select
Access Self Service
.
For Mac users, left-click to open the status item menu.
A new browser window displays the Self Service Inbox which contains the newly published alert (but only if the user authentication is set to Auto\Windows authentication.)
(Mac) The Safari browser is launched for any service selected from the status item menu.
Navigate through the other Self Service tabs and verify that the displayed information is correct.
The published alert appears in the list with a Live status.
Alert tracking reports
Description
Expected result
In the navigation bar, click
Alert
>
Sent Alerts
.
The published alert appears in the list with a Live status.
Hover the pointer over the published alert. The tool tip displays the title body and responses. Click the alert to open the details.
You can see the Delivery Summary, which lists the number of targeted users, the number of Sent to users, and the number of users who acknowledged the alert.
You can also see a drop–down list of detail reports.
Click
Export
>
Export Full Report
. Note that you must have Excel 2003 or higher installed on your computer to open the report.
You are asked to open the .csv file. The Detailed Alert tracking report must open and display the alert details and track information.
You can see the users who received and acknowledged the alert.
Audio files
Description
Expected result
In the navigation bar, click The Settings icon.
In the
Basic
section, click
Audio Files
.
The Audio Files page opens.
Click
New
.
The New Audio File dialog opens.
Enter an audio name and upload a .wav file that is larger than 1 MB but not more than 2 MB.
You can record a .wav file using the Windows Sound Recorder (Start / Programs / Accessories / Entertainment / Sound Recorder.) A voice recording of 30 seconds must be 1 MB. After you record a voice, save it using
File
>
Save As
.
After selecting the file to be uploaded, click
Save
.
Return to Audio Files.
Error logs
Description
Expected result
Check the Windows application event log and the AtHocEventViewer on the application server.
You must not see any unexplained errors in the log.