blackberryathocnetworkedcrisiscommunication ...€¦ · chapter7:managethesituationmap 38...

BlackBerry AtHoc Networked Crisis Communication

BlackBerry AtHoc MobileAdmin GuideRelease 4.1, August 2018

Copyright ©2018 BlackBerry Limited. All Rights Reserved.This document may not be copied, disclosed, transferred, or modified without the prior written consent ofBlackBerry Limited. While all content is believed to be correct at the time of publication, it is provided as gen-eral purpose information. The content is subject to change without notice and is provided “as is” and with noexpressed or implied warranties whatsoever, including, but not limited to, a warranty for accuracy made byBlackBerry Limited. The software described in this document is provided under written license only, con-tains valuable trade secrets and proprietary information, and is protected by the copyright laws of the UnitedStates and other countries. Unauthorized use of software or its documentation can result in civil damagesand criminal prosecution.

TrademarksTrademarks, including but not limited to ATHOC, EMBLEMDesign, ATHOC & Design and the PURPLEGLOBE Design are the trademarks or registered trademarks of BlackBerry Limited, its subsidiaries and/oraffiliates, used under license, and the exclusive rights to such trademarks are expressly reserved. All othertrademarks are the property of their respective owners. Users are not permitted to use thesemarks withoutthe prior written consent of AtHoc or such third party whichmay own themark.

This product includes software developed by Microsoft (http://www.microsoft.com).

This product includes software developed by Intel (http://www.intel.com).

This product includes software developed by BroadCom (http://www.broadcom.com).

All other trademarks mentioned in this document are the property of their respective owners.

PatentsThis product includes technology protected under patents and pending patents.

BlackBerry Solution License Agreementhttps://us.blackberry.com/legal/blackberry-solution-license-agreement

Contact InformationBlackBerry AtHoc

2988 Campus Drive, Suite 100

SanMateo, CA 94403

Tel: 1-650-685-3000

Email: [email protected]

Web: http://www.athoc.com

http://www.microsoft.com/

http://www.intel.com/

http://www.broadcom.com/

http://www.athoc.com/legal/patents

https://us.blackberry.com/legal/blackberry-solution-license-agreement

Contents

CHAPTER 1: WHAT IS THE BLACKBERRY ATHOC MOBILE APP? 1

CHAPTER 1: PRODUCT REQUIREMENTS 2Supported OS versions 2Software requirements 2

CHAPTER 2: SET UP THE BLACKBERRY ATHOC MOBILE APP 3Personal Safety System (PSS) setup 3Register theMobile app 3

CHAPTER 3: CONFIGURE THE MOBILE APP DEVICE IN BLACKBERRY ATHOC 7Enable theMobile App device on the BlackBerry Athoc application server 7Configure theMobile App settings 8Configure themobile device 10Role-based permissions for themobile app 11Configuremobile alert settings 12

CHAPTER 4: CREATE AN ALERT TEMPLATE 14Define alert template details 14Define content for an alert or alert template 15Configure a response option as a user attribute 20Define target users for an alert or alert template 21Select personal devices for an alert or alert template 24Specify personal device options for an alert or alert template 25Select and configuremass devices for an alert or alert template 26Configure the schedule for an alert or alert template 27Edit an alert template 28Duplicate an alert template 28Delete an alert template 29

CHAPTER 5: CREATE AND PUBLISH ALERTS 30Publish an alert from an existing alert template 30View the details of a sent alert 30Edit an alert 33Resend an alert 33End an alert 34Delete an alert 35Track alerts with advanced reports 35View advanced reports 35Advanced report types 35

CHAPTER 6: MANAGE INCOMING ALERTS FROM THE INBOX 37Access the inbox 37

i

CHAPTER 7: MANAGE THE SITUATION MAP 38Access the situationmap 38Add shapes to themap 38Attachmedia to objects on themap 39Sharemap objects 40Workwith map layers 41Monitor incoming alerts 42Publish alerts from themap 42

CHAPTER 8: MANAGE USERS 44Create a user 44Grant Operator Permissions 45Edit operator permissions 45Revoke operator permissions 46View user details 46Edit user details 47

CHAPTER 9: BLACKBERRY ATHOC CUSTOMER PORTAL 48

ii

Chapter 1: What is the BlackBerry AtHoc mobile app?The BlackBerry AtHocmobile app leverages the latest mobile technologies for rapidmass noti-fication and personnel accountability. The BlackBerry AtHocmobile app provides significantadvantages tomobile operators, first responders, and alert recipients. This innovative applicationactivatesmass alerts and personnel tracking. The BlackBerry AtHocmobile app is available onmost popular devices, including Android and iOS smart phones and tablets. The BlackBerry AtHocmobile app can be downloaded fromApple App store, Google Play store, and the BlackBerryWorld store. Combined with the BlackBerry AtHocmanagement system, BlackBerry AtHoc’saward-winning, unified, net-centric technology, the BlackBerry AtHocmobile app enhances anorganization’s ability to reach key personnel during themost extreme conditions, extending situ-ational awareness and the reach of the BlackBerry AtHocmanagement system.

Chapter 1: What is the BlackBerry AtHoc mobile app?

1

Chapter 1: Product requirementsThe BlackBerry AtHocmobile app has the following software requirements and supported OS ver-sions requirements.

Supported OS versionsl Android version 5 and above

l iOS version 9 and above

Software requirementsBlackBerry AtHoc release 7.5 or later version

BlackBerry AtHoc Mobile Admin Guide

2

Chapter 2: Set up the BlackBerry AtHoc mobile appThe BlackBerry AtHocmobile app is available as a download fromApple App store, Google Play

store, and BlackBerryWorld. When the BlackBerry AtHocmobile app is installed, a (globe)icon appears on your device home screen.When new alert content is published, the BlackBerryAtHocmobile app displays an audio/visual alert notification on amobile phone. The end-user canchoose a response option (if response options are sent) and click a link to view complete AlertInbox information on active alerts.

Personal Safety System (PSS) setupFor detailed information about PSS and how to connect BlackBerry AtHocmanagement systemwithmobile app, contact BlackBerry AtHoc Technical Support team.

Register the Mobile appPrerequisites

l Download and install the BlackBerry AtHocmobile app from theGoogle Play store, Apple Appstore, or BlackBerryWorld store.

l Before you register the BlackBerry AtHocMobile app on your device, youmust have the organ-ization code provided by your BlackBerry AtHoc administrator.

l If the BlackBerry AtHocmobile app is pushed byUEM/MDMand you belong to the same organ-ization configured in the UEM/MDM, then you only have to verify your email addresswhen regis-tering for the first time and are directed to the home screen. In this case, you do not have toenter the organization code. Youmust enter the organization code if you switch organizationsafter registering for the first time.

l Youmay have to enter the organization code when registering for the first time if the organ-ization you belong to is not configured in UEM/MDM, or there is no organization code con-figured in UEM/MDM.

To register themobile app on your device for the first time, complete the following steps:

1. Tap the BlackBerry AtHoc app icon on your device. The Registration screen opens.

2. Read the welcomemessage that is displayed. Close themessage.

Chapter 2: Set up the BlackBerry AtHoc mobile app

3

3. On the Registration screen, enter the email address that is associated with your BlackBerryAtHocmanagement system email address.

4. Enter the PSS server URL (For Debug).

5. TapSend (iOS device) or icon (Android device). The Email Verification screen with a con-firmationmessage is displayed.


4

6. Check your email for a welcome email from the BlackBerry AtHoc system administrator with alink to activate your account to your registered email address.

7. ClickVerify Now.

8. After the email address is verified, the AddOrganization screen opens on your device.

9. Enter the organization code provided by your BlackBerry AtHoc administrator and tapSend

or the icon.Note: If your organization is already configured with your email address and organization

code, then youmay not see this screen.

Chapter 2: Set up the BlackBerry AtHoc mobile app

5

The screen displays that you are connected to the organization.


6

Chapter 3: Configure the Mobile App device in Black-Berry AtHocConfigure themobile gateway in the Settings section of the BlackBerry AtHocmanagement sys-tem to enable the BlackBerry AtHocmanagement system to publish alerts through themobile app.

Enable the Mobile App device on the BlackBerry Athocapplication serverLog in to the BlackBerry AtHocmanagement console and check the DeliveryGateways section toverify that theMobile device has been installed. If the device is installed, skip this section.

1. Log in to the BlackBerry AtHoc application server as an administrator.

2. Navigate to the following folder <IWSAlerts Install Path>\Server-Objects\Tools and run the AtHoc.Applications.Tools.InstallPackage.exefile. The Configure Device Support screen opens.

3. Select theMobile App check box.

4. ClickEnable.5. When the Installation Complete pop-up window is displayed, clickOK.6. ClickClose.

Chapter 3: Configure theMobile App device in BlackBerry AtHoc

7

Configure the Mobile App settingsConfigure theMobile App gateway settings to deliver alerts to and receive alerts from themobiledevice.

Note: Contact the BlackBerry AtHoc Technical Support for assistance in setting up theMobileApp for BlackBerry AtHoc. Before you begin this process, you should also contact your sys-tem administrator to get the NDS address used for the notification delivery server.

To configure theMobile App gateway, complete the following steps:

1. In the navigation bar, click the (Settings) icon.2. In the Devices section, clickMobile App. TheMobile App gateway configuration screen

openswith the default settings that are listed in the following table.

Option Description

Notification Delivery Server Settings

Notification Deliv-ery ServerAddress

https://mobile.athoc.com

Username Should be between 3 and 100 characters long

Password Should be between 3 and 100 characters long

Debug Trace Default:NoYesAvoid performance degradation by enabling debug tracing for themobile deliverygateway only while actively debugging themobile notifications for theMobileapplication.

Features

Alerts Selected

Map Unselected

Alert Publishing Unselected

AdvancedFeatures

Unselected. When selected, advanced settings display that required a dis-tribution list for access. Options include Emergencies Check In, Reports, andTracking. When you select Tracking , the Tracking Interval option is displayed toset an interval. To learn about the advanced features, refer to the Role-based per-missions for themobile app section of this guide.

Settings

Photo Quality Default: LowHigh

VideoQuality Default: LowHigh


8

Option Description

EmergencyContact Number

Designate the emergency contact telephone number. If no phone number isentered in the field, theMobile App will not have an emergency contact numberbutton.

Support EmailAddress

[email protected]

Enable MobileAnalytics

Collects mobile app usage analytics. No personal, private, or sensitive inform-ation is collected.Default: NoYes

Send Locationwith Response

Sends user location information with alert or event responses.Default:YesNo

User Choice Enables eachmobile user to choose whether to send location information withalert or event responses.Default: NoYesThis option is visible only when "Yes" is selected for Send Location withResponse.

Note: You should use the default values to set up and configure the AtHocMobile applic-ation.

3. Click theCopy Default Settings link.4. Enter the NDS address you received from your SystemAdministrator into theNotification

Delivery Server Address field.By default, the URL points to mobile.athoc.com.

5. Add the user name and password provided by BlackBerry AtHoc.

6. In the Features section, select the options that can be available to users when they are usingtheir mobile device:

l Alerts—Users can receive alerts.

l Map—Users can view the SSAmap.

l Alert Publishing—Operators can publish alerts.

l Advanced Features—Advanced features that members of a distribution list can use.When you select this option, select a distribution list and the features that members of thedistribution list can use. To learn about the advanced features, see Role-based per-missions for themobile app.

7. In theSettings section, select the photo and video quality.8. In theEmergency Contact Number field, enter the phone number of the operations center

to which emergencies are sent frommobile devices.


9

9. In theDebug Email Address field, enter an email address to which logs are sent for errordebugging.

10. In theSend Location with Response section, select whether to send location informationwith alert or event responses.When "No" is selected, location information is prevented frombeing returned with alert or event responses even if mobile location services are active on themobile device.

11. In theUser Choice section, select whether to enablemobile users to choose to send locationinformation with alert or event responses. This option is only available when "Yes" is selectedfor theSend Location with Response option.

12. ClickSave.

Configure the mobile deviceAfter BlackBerry AtHoc Technical Support has set up the correct Notification Delivery Server(NDS) address, you can assign an AtHocMobile Gateway to the phone.

To edit the Devices screen and enablemobile phone notification, complete the following steps:

1. Log in to the BlackBerry AtHocmanagement system as an administrator.

2. In the navigation bar, click the (Settings) icon.

3. In the Devices section, clickDevices. The DeviceManage screen opens.4. ClickMobile App.

5. ClickEdit.

6. In the DeliveryGateway section, click on theAdd a Delivery Gateway list and selectMobileApp.


10

7. ClickConfigure to open the text-entry field.

8. By default, the configuration value appears in the text-entry field. If the text-entry field isempty, complete the following steps:

a. ClickRemove.b. SelectMobile App from the list again.

c. ClickConfigure.d. Copy the following text into the field:

<Configuration><DeviceType>mobileNotification</DeviceType>

</Configuration>

9. ClickSave.10. ClickEnable.

Role-based permissions for the mobile appAs a system administrator, you can specify what controls a user can see on themobile devicedepending on their roles and responsibilities (also known as role-based permissions). Forexample, youmight want an emergency team to be able to see themap, send field reports, starttracking, and send emergency duress alerts. However, youmight want a student on a campus ornon-emergency personnel to only be able to receive notifications and to send duress (emergency)alerts to security without having access to themap or to tracking or field reports.

To specify permissions for advanced features, complete the following steps:

1. For users who need advanced features, create a distribution list.Note: Only one distribution list can be used for the organization.

2. In the navigation bar, click the (Settings) icon.3. In the Devices section, click theMobile App link. TheMobile app settings page opens.


11

4. In the Features section, selectAlerts to provide permission to receive alerts onmobiledevices.

5. SelectMap to provide access to view SSAmap.

6. SelectAlert Publishing to provide publishing permission to operators.7. SelectAdvanced Features to provide advanced features to a group of users. The select

advance features section appears.

8. In theSelect advanced features section, select one or more types of features that the usercan access from themobile application:

l Emergencies—Send duressmessages

l Check In—User check ins on themap

l Reports—Send field reports

l Tracking—Trackmobile device location for a specified amount of time.

9. Make any other needed changes for theMobile App settings.

10. Click theSave button.

Configure mobile alert settingsConfigure themobile alert settings to respond to alerts. You can select a severity level, specifywhether the incoming alert appears on themap, or whether an alert template is published. Thesealerts appear on the Situationmap and on reports with icons. All threeMobile incoming alerts cat-egories Emergency, Check In, and Report can be edited to trigger a template.

The following incomingmobile alerts types are available in the system:

l Mobile Standard

l Emergency (Duress)

l Check-in

l Report

l Custom

l Report: Add a custom report

Alert rules help determine which alert templates to run when an alert arrives in the Inbox. MobileAlert rules have no conditions, the operator can select an alert template to be triggered on incom-ingmobile alert.

To set up and configure incoming alert settings, complete the following steps:

1. In the navigation bar, click the (Settings) icon.2. In the Basic section, clickMobile Alert Settings. TheMobile Alert Settings screen opens.


12

3. In the Emergency section, select the (Edit) icon. By default, the severity is set to High. Youcan send an alert with an emergency by selecting an alert template from theRun Alert Tem-plate list, select theAutomatically display on map check box, and then clickSave.The Emergency title and icon are preset and cannot be changed.

4. In the Check-In section, select the (Edit) icon. By default, the severity is set to moderate.You can select an alert template from theRun Alert Template list, select theAutomaticallydisplay on map check box, and then clickSave.The Check In title and icon are preset and cannot be changed.

5. In the Report section, clickAdd to create a new incoming alert report that users can accessthrough their mobile device.

Create a field report for the mobile appWhen amobile user sends a field report, they can choose from a list of report types. These fieldreports types can trigger an alert template.

To add a field report type to the list of field reports users can access through their mobile devices,complete the following steps:

1. In the navigation bar, click the (Settings) icon.2. In the Basic region, clickMobile Alert Settings. TheMobile Alerts Settings screen opens.3. In the Report section, clickAdd. The Report screen opens.4. Add or select values in the following fields:

l Title—Enter a descriptive label that identifies the field report.

l Message—Enter the default message you want to appear in themessage field. This textcan be edited by end users prior to them sending the field report.

l Icon—Select the specific icon you want to use onmaps to represent the event report.

l Default Severity—Select the default severity of the field report. Severity options includeHigh, Moderate, Low, Informational, or Unknown, and end users can change the severityprior to sending the report.

l Run Alert Template—Select an alert template to be published when a user sends thefield report. Note that only alert templates that are ready to be published are displayed.

l Automatically display on map—(Optional) Select this checkbox if you want the fieldreport to appear by default on themap. This setting cannot be edited by end users prior tothem sending the report.

5. ClickSave to add the field report to the list of options under the Report section.6. (Optional) Repeat steps 3 through 5 to add additional report types that end users can access

when preparing to send an event report.


13

Chapter 4: Create an alert templateAlert templates define the types of alerts that can occur within an alert folder, enabling operators toquickly publish the appropriate alert during an emergency.

When initially setting up the BlackBerry AtHoc system, the Administrator defines the alert folders(categories of alerts) and appropriate alert templates for each folder. Later, the Administrator orAdvanced Alert Managers can add new alert templates or modify existing ones.

Note: When operators access the Alert Templates screen, they can see only alert templatesassociated with folders to which they have access.

To create a new mobile alert template, complete the following steps:

1. In the Navigation bar, click the Alerts button.2. Click theAlert Templates link.3. Click theNew button on the Alert Templates screen.

4. On the screen that appears, select or enter values in each of the following sections, details ofwhich can be found in each of the following sections of this guide:

o Alert Template (Alert templates only)o Contento Target Userso MassDeviceso Schedule

5. After you have reviewed the template content, clickSave

Define alert template detailsThe Alert Template section is used to establish the identifying characteristics of the alert templatein the system.

To configure the alert template details, complete the following steps:

1. In the navigation bar, click theAlerts > Alert Templates.2. ClickNew. The New Alert Template screen opens.

3. In theAlert Template section, in theName field, enter ameaningful name for the alert tem-plate to help publishers identify it. The Name and Description display in BlackBerry AtHoc onlyand is not displayed to end users.

4. In theDescription field, provide details about the alert template purpose or content. Thisdescription is not seen by end users and is only visible within the application.

5. In the Folder field, click the down arrow and select the alert folder to which you want to addthe alert template.

6. Select theAvailable for Quick Publish check box if you want to make the new alert tem-plate available through all quick publish links in the application

Chapter 4: Create an alert template

14

7. SelectAvailable for mobile publishing check box if you want to make the new alert tem-plate available for quick publish onn themobile app.

8. When you are done, go to the Content section and configure the fields within it.

Define content for an alert or alert templateTheContent section is used to define the key parts of an alert or alert template in the system: thetitle, the body, the type, and any response options,Website links, attachments, or location detailsthat are relevant.

To add content, complete the following steps:

1. (Optional) If you are creating an alert or alert template in a language other than default lan-guage displayed on the screen, click the button next to the Severity field and select the lan-guage from the list that appears. Note that this does not change the language displayed on thescreen. Instead, it changes the language that themessage is delivered in. If text-to-speech isenabled, the audio portion of the sent alert is in the language you selected.

2. In theSeverity field, select the severity level from the dropdown list.Important: High severity is reserved for extreme emergencies. On theMobile application, it

overrides the device sound settings to emit any sounds associated with the alertor alert template.

3. In the Title field, enter a one-line summary that communicates the purpose of the alert or alerttemplate. The title is required and displays at the top of the recipients' screen when the alert issent out.

4. (Optional) If you want to insert a placeholder into the alert or alert template title, click the(Expand) icon and select the placeholder from the list.

5. In theBody field, enter up to 2000 characters of text that communicateswhy the alert hasbeen sent and provide instructions to the target audience.

6. (Optional) If you want to insert a placeholder into the event or template body, click the(Expand) icon and select the placeholder in the dropdown list that appears.

7. In the Type field, select the type that fits with the alert or alert template you are creating.8. In the Response Options field, do one of the following:

l Click theCustom Response Options dropdown list to view a list of pre-set responsesyou can add to the alert or alert template.

l Click theAdd Response Option link to define one or more responses that alert recip-ients can send to let you know that they have received themessage. If the responseinvolves a call bridge, select the Call Bridge check box, then, in the two fields that appearbelow the check box, enter the call bridge number and passcode users will need in orderto respond. For specific details about what call bridges are and how they are used, referto the text box below.

(Optional) If you want to insert a placeholder into the ResponseOptions field, click the(Expand) icon and select the placeholder in the dropdown list that appears.


15

9. (Optional) In theMore Info Link field, enter one of the following:

l A URL that opens aWeb page where users can go to get more details about the alertwhen it is sent out. When users receive the alert, a For Further Information link within itwill take them to theWeb page.

l A URL that opens an attachment (media or documents) stored on Dropbox. For detailson how to store an attachment on Dropbox, see Add an attachment using dropbox.

10. If you entered a URL in the previous step, click the Test URL link to verify that the link workscorrectly.

11. (Optional) In the Location field, click theAdd button to access amap on which you can des-ignate a geographic area for the alert or alert template.

For a detailed description on how to specify a geographic location, see Select an alertlocation.

12. When you are done, go to the Target individual users section and configure the fields within it.

What Is a Call Bridge? A call bridge is a type of alert response option for telephony devices consisting of a text response accom-panied by either a phone number or a URL address. If you set up a Call Bridge phone option, end usersmust type the full phone number plus the passcode (if required) preceded by an ‘x’ delimiter: for example,(321)987-6543x98127.

If you set up a Call Bridge URL, the URL address must begin with one of the following:

l http:// – for standardWeb addresses

l https:// – for securedWeb addresses

l sip:// – for conference device addresses

Add an attachment using DropboxNote: Visibility of theChoose from Dropbox button is controlled by an organization setting so it

might not be active for your organization. If it is active, youmust first register with Drop-box™ and then sign in before you can attach files. Details on how to register and sign in arepresented below.

If you want to include an attachment in an alert, alert template, event, or event template, you canuploadmedia or documents on Dropbox and then include a link to that attachment within the alert,event, or template you are creating. To add a link to an attachment stored in Dropbox, complete thefollowing steps:

1. In the Content section of the alert, event, or template, click theChoose from Dropbox but-ton.

2. Enter your Dropboxusername and password. If you do not have a Dropbox account, clickthe "create an account" link under the Sign In button to create one.Note: Although you need to set up an account in order to accessDropbox, you can use the

Choose from Dropbox button to select files stored in the cloud or add files from yourlocal drive without having to install the full Dropbox application on your computer.

3. Click theUpload button.


16

4. Click theChoose files button.5. Navigate to the file you want to upload, then clickOpen.6. ClickDone.7. Click the filename in your Dropbox homepage, then click theShare link that appears in the

same row.

8. Copy the link location that appears in the Link to file field.9. Paste the link location into theMore Info Link field in the Content section of the alert, event,

or template you are creating.

Select an alert locationThere are two ways to add locations to an alert or event using themap feature: by defining customlocations using the drawing tools available on themap and by selecting geographic areas from alist of locations that were predefined by a BlackBerry AtHoc administrator.

Note: WhenOperators and Administrators create an alert or accountability template, they havethe option tomake Location amandatory component by clicking the Settings button andselecting the Is Location Mandatory check box.When an operator creates an alert orevent from the template, if a location is not added, the alert or event is assigned a status of"Not Ready."

To access amapwhere you can select one or more geographic location for an alert or event, com-plete the following steps:

1. In the Content section, click theAdd button in the Location field.A separate screen appears, displaying an interactivemap.Note: If you have the necessary permissions, you can set the default map area through the

Map and Layer Settings screen.

2. (Optional) If the location you want to target is not displayed on the current map, enter theaddress, point of interest, or longitude/latitude value pair in the search field. PressEnter onyour keyboard to refresh themap location.

3. To use a predefined location on themap as a targeting criteria, click theSelect PredefinedLocations button to access a dropdownmenu fromwhich you can select any of the layersthat have been created for you.When you select a layer, themap auto-updates to display thelayer location on the screen.


17

Note: Uploadingmultiple layers with different set of predefined locations is recommended toimprove usability and system performance. Map layers are configured on theMap andLayers screen, accessible to Administrators at Settings > Situation > Map and Lay-ers.

4. Select one or more predefined locationswithin the layer by clicking them on themap or select-ing the checkbox beside their names in the dropdownmenu.

As youmake selections, the locations are highlighted on themap, as seen below for Shell 1,Shell 2, and Shell 4.

5. To create a custom location, click theCreate Custom Locations button to display the draw-ing tools for creating shapes.


18

6. Click one of the shape buttons in theMap Tools bar and click and drag on the screen to coverthe location you want to use in the alert or event.

7. To view the size of a custom location, click the shape on themap. A black box appears besidethe Create Custom Locations button, listing the total area of the custom location in squaremiles or square kilometers, depending on which unit of measure your system uses.

8. To edit a custom location, click the shape and then click and drag on any of the circles thatappear around the edge of the shape.

9. To scale new shapes up and downwhile preserving their dimensions, complete the followingsteps:

a. Press and hold the SHIFT key on your keyboard.

b. Click and release the shape to select it.

c. Move your cursor over one of the white squares around the shape.

d. Click and hold on the white boxwhile dragging themouse to increase or decrease theshape size.

As you create shapes and select predefined locations on themap, the Location Summaryfield in the bottom-right corner updates to provide you with an overview of the total number oflocations that are displayed on themap and the locations that will be included in the alert orevent.

10. To delete one of the custom locations you created, do one of the following:

l In the Location Summary field, click theX button next to each location you want toremove. Note that if you have createdmore than one custom location, they are combinedin the list and cannot be deleted individually. To delete individual custom locations, usethemethod described below.

l Click the border of the location shape on themap to select it, then click the button toremove it.

11. To see the total number of users and organizations that are located within the selectedmaplocations, click theCalculate link beside the Target By Location field.Important: Users and organizations listed in the Target By Location field are not auto-

matically added to the alert or event target list. To add them as targets, youmustselect the Target Users and Target Organizations checkboxes.


19

12. When you are done adding locations and targeting users and organizations, click theApplybutton to save your changes.

Configure a response option as a user attributeResponse options can be either of the following types:

l Custom—Defined during the creation of an alert or alert template. This is themost commontype.

l Pre-set—Defined in advance as user attributes. The pre-set options have a feature that is notavailable in custom responses.When a user responds to the alert using a pre-set option, theresponse value is copied to their user record as a user attribute that can later be the subject of aquery. The user attributemust be a single-select picklist type.

Benefits of Using a Pre-Set Response Option

Pre-set response options created as user attributes are appropriate in the following situations:

l As a way to efficiently gather data about users for use later in alert targeting. The response an alertrecipient gives to an alert asking if they havemedical training, for example, could be added to eachrespondent's personnel record. During a subsequent emergency, the user database could be searchedand an alert immediately sent out to all users whose user attribute value for Medical Training is set to"Yes."

l When there is a need to send out multiple versions of the same alert but view the results in a single,aggregated report. The responses from each version of the alert are added to each respondent's userrecord. At any time, operators can generate a single personnel report that shows the aggregate totalsfor all response options across themultiple versions of the alert.

To create a response option user attribute, complete the following steps:

1. In the Navigation bar, click the (Settings) icon.2. In the Users region, click theUser Attributes link.

TheUser Attributes screen opens.3. ClickNew and then selectSingle-select Picklist.4. Best Practice:On the New Attribute screen, enter the name of the new attribute prefixed

with "RO" to indicate that the attribute is for response options: for example, RO-OfficeLoca-tion.

5. In theValues field, add the response options for each picklist option.6. In thePage Layout field, leave both dropdown lists set toDo not show.7. (Optional) To track the responses, in thePersonnel Reporting field, select theEnabled

checkbox and enter a report name, such asOffice LocationsResponseOptions.

8. Click theSave button.The response option user attribute then appears in the Response Options section of thealert details screen.


20

If you selected theEnable checkbox in Step 7, each time an operator publishes an alert withthe response options you created, the option each respondent selects is added to their userrecord. To view a summary of responses to each option, go toReports > PersonnelReports and click the name you gave the report in Step 7 above.

Define target users for an alert or alert templateThe Target Users section enables you to identify the users you want to send an alert to or blockfrom receiving the alert. As you create an alert or alert template, users can be identified based ontheir names, attributes, roles, groupmemberships, distribution list memberships, or physical loc-ations.

As the event progresses, the affected users list updates in real time. For example, if you select tonotify "By Location" if additional people enter the selected area during an event with trackingenabled on their mobile device they are added to the list of affected users and begin receivingmes-sages.

Target groups in alerts or alert templatesUsing the ByGroups tab, publishers can target groups of users based on their memberships inorganizational hierarchical nodes and in distribution lists. The alert is sent to users within the selec-ted groups.

The publisher can also block recipient groups (exclude them from alert delivery).

TheGroup target categories displayed are:

l Organizational Hierarchy—If your system is set up for them. The "All User Base" is the firstnode that appears and is the only node from the hierarchy that appears when collapsed.

l Distribution Lists—Static and dynamic

Note: The Administrator can restrict the contents of these categories for each publisher. Forexample, a publisher might have permission to view only one of four organizational hier-archies.

To select groups of users as alert recipients, complete the following steps:


21

1. In the Target Users section, clickBy Groups if it is not already selected.2. In theGroups field, select the checkbox beside each group or distribution list that you want to

target.

If you select a group or distribution list that contains sub-groups or sub-distribution lists, thoseare automatically selected, too. However, any of them can bemanually deselected by clickingthe checkbox next to its name. If you select all of the sub-groups or sub-distribution listsmanu-ally, the parent group or distribution list is not selected automatically.Note: The presence of a black square (or a black hyphen if you are using Google Chrome) in

a checkbox indicates that some of its sub-groups or sub-distribution lists have beenselected and some have not.

Target individual usersTargeting users can be done through the ByUsers tab in the Targeting section by completing thefollowing steps:

1. In the Target Users section, click theBy Users tab.2. In the Users field, click theAdd/Block Users link. The Add/BlockUsers screen appears.3. Select the checkbox beside each user that you want to target in the alert and then click the

Block link next to any user you want to block from receiving the alert.Note: If the name of the user does not appear on the screen, enter the name in the search

field, and then clickSearch.

As you select (and block) users, the total number selected updates automatically at the top ofthe screen and the total number targeted and blocked appears below the search field.

4. After you have selected all users you want to include in the alert, click theApply button.

The Users screen then reappears, displaying the names of the users you added with a

(Checkmark) icon beside their name. If you blocked any users, a (Blocked) icon willappear beside their name.Note: If you change your mind and want to remove a targeted user from the alert recipient list,

click the (Remove) icon next to their name.

Target users by locationIn order to target users by location, youmust first define a location in the Content section of thealert or alert template. For detailed instructions on how to do this, refer to Select an alert location.

You can target users based on a geographical location that you select on amap. To do this, com-plete the following steps:

1. In the Target Users section, click theBy Location tab.2. Select theUsers in the defined location checkbox.

The Targeting Summary field at the bottom of the Target Users section then updates to dis-play the total number of locations on themap that can be used to target recipients when alertsare generated from the alert template.


22

3. Click the number in theBy Location field to open a new screen that displays amap showingeach of the locations that have been targeted. This is the samemap that can be seen in theLocation field within the Content section.

Target or block users by advanced queryYou can perform ad hoc targeting or blocking of users based on general attributes, organizationhierarchies, geolocation, operator attributes, or device types. To target or block users based onadvanced query criteria, complete the following steps:

1. In the Target Users section, click theBy Advanced Query tab.2. Click theAdd Condition link.3. In theSelect Attribute dropdown list, select the first attribute, organization hierarchy, geo-

location, operator attribute, or device you want to use as targeting criteria.

4. In theSelect Operation field, select the operation that you want to assign to the attribute. Toblock users who have specific attributes, select a negative operator such asnot equals ordoes not contain.Note: The list of operations varies depending on the type of attribute selected.

5. If the Operation you selected in Step 3 requires additional query values, a third field appears.Enter or select a value for the attribute.

6. (Optional) Click theAdd Condition link and then repeat steps 2 through 4 for each additionalcondition you want to add.Note: In order to be included in the target group, usersmust meet all conditions specified by

the condition statements.

The Targeting Summary field at the bottom of the Target Users section updates automaticallyto display the total number of users whomatch the query conditions you have created.

7. (Optional) Click the number in the AdvancedQuery field within the Targeting Summary toview a screen that displays the criteria that you created for the advanced query.

8. (Optional) Modify the query conditions as needed to isolate the exact user group to which youwant to send the alert. Click theAdd Condition link to addmore conditions. Click the iconbeside the condition to remove the condition.

Review the targeting summaryThe bottom section of the Target Users section displays the Targeting Summary, showing the totalnumber of groups and users that have been selected and blocked and the number of targeted loc-ations and personal devices included in the alert. As additional groups, users, and devices areadded to or removed from the target group, the section updates automatically.

Clicking any of the numbered links in the Targeting Summary field opens a popup screen thatprovides a list of the users, devices, or search conditions related to the selected target.

By GroupsThe ByGroups summary screen lists all of the organizational hierarchies and all distribution liststhat are included in the alert. If a group or distribution list has children that have been blocked, the


23

alert will not go out to users within those sub-groups or sub-distribution lists.

By Groups-BlockedTheGroups-Blocked summary screen lists all of the organizational hierarchies and all distributionlists that have been excluded from the alert. If all sub-groups or sub-distribution list of a parenthave been blockedmanually, the parent is not, by default, blocked aswell. The parent can onlybe blocked bymanually selecting it for blocking.

By UsersThe ByUsers screen lists all of the users who have been selected for inclusion in the alert.

By Users-BlockedThe ByUsers-Blocked screen lists all of the users who have been blocked from receiving thealert.

By LocationThe By Location screen displays amap showing each of the locations that have been targeted inthe alert. This is the samemap that can be seen in the Location field within the Content sectionof the new alert template or new alert screen.

By Advanced QueryThe ByAdvancedQuery screen lists all of the search conditions that have been created in orderto identify the target audience for the alert.

Personal DevicesThe Personal Devices screen displays a list of each of the personal devices that will be used to tar-get the alert recipients. Beside each device listed is the percent of alert recipients who can bereached using the device.

Select personal devices for an alert or alert templateAfter selecting the users or groups you want to include in the alert or alert template, youmust selectthe personal andmass devices to use to contact the target group. To select personal devices, com-plete the following steps:

1. In the Target Users section, click theSelect Personal Devices tab.

A list of all available personal devices appears, accompanied by statistics that reveal the totalnumber of selected users who can be reached by each device type.

2. Select the checkbox next to each personal device you want to include.

As you select devices, the pie chart on the side of the screen updates to show the number ofreachable and unreachable users based on your current selections.

3. (Optional) Click the number next to the Total Users field to view aUser Listing screen that dis-plays the username and organizational hierarchy for each of the users in the target group.

4. (Optional) Click the numbers in theReachable Users andUnreachable Users fields to viewseparate popup screens providing user details for those subgroups.

Note: If no users are reachable based on the targeted users and devices you select, the alert tem-plate is not ready for publishing.


24

Specify personal device options for an alert or alert templateAfter you select personal devices for an alert or alert template, you can specify options for most ofthe devices by completing the following steps:

1. In the Target Users field, click theSelect Personal Devices tab.2. In the Personal Devices field, select the checkboxes next to each of the personal devices you

want to use as targetingmethods.

3. Click theOptions link in the top corner of the Personal Devices field.The Personal DevicesOptions screen opens, displaying separate tabs and separate optionsfor each of the devices you selected in Step 2.

4. After selecting options, click theApply button at the bottom of the screen.

The following table details the options that are available for themost common device types.


25

DeviceType Options Explanation

BlackBerryAtHocMobile App

Repeat Notification Each alert is only sent once. This option is used to specify ifand how often notifications about the alert are repeated on amobile device.

l None: Send the alert notification once

l Default: Use the default time that has been defined for theselected severity.

o For alerts with a severity level of High, the default isone notification aminute for 10minutes.

o For alerts with a severity ofModerate, Low, Inform-ational, orUnknown, the default is one notification aminute for 2minutes.

l Custom:

o Select how long to repeat the notification if the userdoes not respond.

o Select how long to pause between each repetition.

Note: Ensure that the pause time is smaller than therepetition timeframe. For example, you can settheStop Repetition After value for 5minutes, and thePause between Noti-fications value to 30 seconds - the notificationcan be repeated up to 9 times.However, if theStop Repetition After valueis 5minutes, but thePause between Noti-fications value is 6minutes, the notification isrepeated only once.

Alert notifications repeat until one of the following actionsoccur:

l The recipient responds to the alert from at least onedevice.

l The defined timeframe for repeat notifications elapses.

l The alert ends.

Deliver Alert withSound

Select Yes orNo to deliver the alert with a sound.

Select and configure mass devices for an alert or alert tem-plateMass devices are designed to alert users in a general location using equipment such as digitalsigns, loudspeakers, and fire alarms.When usingmass devices, there is no need to target indi-vidual users or groups.


26

To select and configuremass devices for an alert or alert template, complete the following steps:

1. In theMass Devices section, select the checkbox next to eachmass device you want to useto broadcast alerts.

2. (Optional) Click theOptions link at the top of theMassDevices section.Each of themass devices you selected in Step 1 appears as a separate tab on theMassDevicesOptions screen that opens. The contents of each tab vary depending on the type ofmass device selected.

3. Click each tab on the screen and then configure eachmass device by selecting from the rangeof options that appear.

4. When you have finished configuring all of themass devices, clickSave.

Configure the schedule for an alert or alert templateThe Schedule settings specify how long alerts will remain active. To configure these settings, com-plete the following steps:

1. Scroll down to theSchedule section in the alert or alert template.2. In theSchedule field, select theActivate Recurrence checkbox if you want to create an

alert that will be usedmore than once. If you select this option, additional fields appear at thebottom of the screen. You will configure them in steps 5 through 7 below.

3. In theAlert Timings section, specify the following values:

l Start Time—Bydefault, this field cannot be edited and displays the text, "Set during alertpublishing." However, if the Activate Recurrence checkboxwas selected in Step 2, thefield displays hour, minute, and AM/PM fields that you can use to set the start time for thealert template.

l Alert Duration—The amount of time the alert should be active. Use the dropdown list tospecify whether the time is in minutes, hours, or days.

4. If you did not select the Activate Recurrence checkbox in Step 1, clickSave to finish creatingthe alert or alert template.

If you did select the checkbox, complete the following additional steps using the Recurrence-related fields on the screen.

5. In theRecurrence Pattern section, use the dropdown list to determine how often you wantthe alert to recur: daily, weekly, monthly, or yearly.

6. In the Start Date field of theRecurrence Period section, do one of the following:

l Manually enter the day, month, and year that you want the alert to begin, writing the dateinMM/DD/YYYY format (for example, January 25, 2015 would be written as01/25/2015)

l Click the (Calendar) icon and navigate to and then click the day, month, and year thatyou want to use.


27

7. In theEnd Date field, select one of the three options:

l No end date—The alert will continue to recur until you or someone elsemanuallydeletes it, adds an end date to it, or limits the number of occurrences.

l End after <X> occurrences—The alert will continue to be sent out at the time intervalyou specified in Step 5 until it has been sent out the number of times you specify in thisfield.

l End by <date>—The alert will continue to be sent out until the date you select in thisfield.

8. ClickSave when you are done.

Edit an alert templateWithin BlackBerry AtHoc, alert templates typically consist of alert content, response options, a listof targeted recipients, and a list of delivery devices for a specific situation.

You can edit an existing alert template to change features such as the default header, body text,and target audience by completing the following steps:

1. In the navigation bar, click theAlerts button.2. Click theAlert Templates link.3. Use the search field or scroll down in the alert template list to locate the alert template you

want to edit.

4. Click the name of the alert template.

5. Edit values in any of the following sections:

o Alert Templateo Contento Target Userso MassDevices (Only available in English-language alert templates)o Schedule


Duplicate an alert templateDuplicating an alert template creates an exact copy of it in the system and can be used to speed upthe creation of similar templates. You can duplicate any alert template that contains a checkboxnext to its name.

To duplicate an alert template, complete the following steps:

1. In the navigation bar, click theAlerts button.2. Click theAlert Templates link.3. Use the search field or scroll down in the alert template list to locate the alert template you

want to duplicate.


28

4. Select the checkbox beside the alert template name.Note: If the template does not have a checkbox beside its name, it cannot be duplicated.

5. Click theDuplicate button at the top of the screen.A New Alert Template screen appears, displaying all of the values that were part of the ori-ginal alert template.

6. Make whatever changes you want to the alert template details.

At aminimum, you should change the name of the alert template so that you can distinguish itfrom the original.

7. ClickSave.The screen refreshes and the new alert template appears in the list on the Alert Templatesscreen.

Delete an alert templateWithin BlackBerry AtHoc, alert templates typically consist of alert content, response options, a listof targeted recipients, and a list of delivery devices for a specific situation.

You can delete alert templates individually or in groups from the Alert Templates screen.

To delete an alert template, complete the following steps:

1. In the navigation bar, click theAlerts button.2. Click theAlert Templates link.3. Use the search field or scroll down in the alert template list to locate each of the alert templates

you want to delete.

4. Select the checkbox next to each alert template that you want to delete.

5. Click theDelete button at the top of the screen.A confirmation popup screen opens, listing each of the alert templates you are about to delete.

6. Click theDelete button.The Alert Templates screen refreshes to show the alert template list without the alert templateor alert templates you deleted.


29

Chapter 5: Create and publish alertsAlerts are communications sent to your organization, to mobile users, or to outside organizations.A BlackBerry AtHocOperator creates alerts and targets users, distribution lists, mobile users, andorganizations and publish alerts from the Alertsmenu.

Incoming alerts are alerts received frommobile users or outside organizations.

Before you begin:

Youmust have the following operator permissions to publish an alert fromMobile app:

l SDK user

l Alert publisher

Publish an alert from an existing alert templateImportant: Before creating and publishing a new alert, go to the BlackBerry AtHoc HomePage and checkthe list of all alerts that are currently live, scheduled, and recurring in the system. Doing so will help youavoid creating a duplicate alert.

Themost commonway to create an alert is to open an existing alert template, modify its contents,and then publish it. To create an alert in thismanner, complete the following steps:

1. In the navigation bar, click the Alerts button.2. Click theNew Alert link.

The Select fromAlert Templates screen opens, displaying all alert templates that you haveaccess to in the system.

To view details about any of the alert templates in the list, hover your cursor over an alert tem-plate name.

3. Do one of the following:

o Quick Publish: Click thePublish button next to an alert template in the Ready to Publishcolumn.

o Modify and publish: Click anEdit Alert button tomodify the contents of any alert tem-plate and then clickPublish.Note: Refer to the Create an alert template section of this guide for detailed instructions

on how to fill in the content and target users.

View the details of a sent alertIf you have just clicked thePublish button to send an alert, you can access the Alert Summaryreport by clicking theAlert Summary button at the bottom of the Review and Publish screen.

If you are not on the Review and Publish screen, you can view the alert summary for any live orended alert by completing the following steps:

Chapter 5: Create and publish alerts

30

1. In the navigation bar, click theAlerts button.2. Click theSent Alerts link.3. On the Sent Alerts screen, use the search field or scroll down in the alerts table to locate the

alert whose details you want to view.

4. Click anywhere in an alert line to open the details screen for the alert.TheAlert Summary screen that appears contains a Details tab and tabs for targeted Users,Organizations, andMassDevices, when applicable.

If the alert is live, there is an End Alert button that you can use to end the alert immediately.

The Alert Summary screen lists the current status of the alert; Live or Ended. For live alerts, theinformation on the page updates automatically everyminute. You canmanually update the screen

at any time by clicking the (Refresh) button.

Details tabThe details tab displays all fields that were included in the alert.

The Total Users field in the Target Users region displays the total number of users targeted in thealert. Clicking the number opens a Users screen that displays the names and user details of eachof the targeted users.

For live events, you can change the Alert End Time in the Alert Timing region of the Schedule sec-tion.

Users tabTheUsers tab provides statistics on the number of users who were targeted by the alert and thekinds of responses that were recorded from users who received the alert. The Users tab containstwo sub tabs: Summary and List.

The Summary sub tab opens by default and contains the Sent Details and Response Details sec-tions.

The List sub tab contains a list of all targeted users, and includes the following information bydefault: Sent Time (the time the alert was sent to each user), RespondedOn (the date and time theuser responded to the alert), andMessage Response . You can click theAdd link to add additionalcolumns to the display. Click theReset link to restore the default columns. To display differentcolumns by default, go toSettings > General Settings and then click theDefault Columns -User Reports link in the Layouts region.

TheSent Details section of the Summary sub tab contains statistics on the number of users tar-geted by the alert, the number of users the alert was sent to, and the number of users the system isstill trying to contact or the system failed to contact. For each of these options, a dropdownmenunext to the number contains the following options:

l Export Delivery Summary (CSV)—Click this option to create an exportable CSV file con-taining the names of all users who fit the particular category you clicked: Targeted, Sent , or InProgress or Failed. Where applicable, the CSV also contains the alert sent time, respondedtime, user response, and error time recorded for each user in the list.


31

l Send alert to these users—Click this option to open a duplicate of the original alert that youcanmodify and send out again. For the "In Progress or Failed" category, this option is a quickway of addingmore personal devices and deliverymethods to the alert to try to contact alert tar-gets who were unaware of or unable to respond to the original alert.

l User List—Click this option to open the List sub tab. The List sub tab contains a list of usersmatching the type of sent details selected (Targeted, Sent, or In Progress or Failed.)

TheResponse Details section of the Summary tab displays a list of all of the possible alertresponse options, each assigned a different color. Next to each option the total number of alertrecipients who have selected that option is displayed. This information is also graphically rep-resented on the screen by a circle divided into colored segments in proportion to the number ofresponse options of each type that were selected.

The dropdownmenu next to each response number contains the following options:

l Export Delivery Summary (CSV) for sent alert: Click this option to create an exportableCSV file containing the names of all recipients who chose the corresponding responseoption. Where applicable, the CSV also contains the alert sent time, responded time, userresponse, and work related details for each recipient.

l Send Alert to These Users: Click this option to open a duplicate of the original alert that youcanmodify and send out again. For the Not Responded category, this option is a quick way ofaddingmore personal devices and deliverymethods to the alert to try to contact alert targetswho were unaware of or unable to respond to the original alert. For other options, it is a way toprovide specific additional instructions to a highly targeted group.

l User List—Click this option to open the List sub tab. The List sub tab contains a list of usersmatching the response selected.

Organizations tabTheOrganizations tab provides statistics on the number of organizations that were targeted by thealert and the types of responses that were recorded from those organizations.

Each dropdown list on theOrganizations tab contains aExport Delivery Summary option. Thereis no option to send the alert again to the selected organizations.


32

Mass Devices tabNote: Mass devices are not available for non-English alert templates.TheMassDevices Targeted tab provides statistics on the number of mass devices that were tar-geted by the alert and the responses that were received from the devices. Becausemass devicesbroadcast alerts enmass rather than to specific people or organizations, trackingmass deviceresponses involves simply noting whether a delivered alert was accepted or not. The two responseoptions used for mass devices are Responded, meaning the device broadcast the alert, and NotResponded, whichmeans the device did not broadcast the alert.

The dropdown lists in the Targeted, Sent, and In Progress or Failed sections contain only anExport Delivery Summary option, which creates a downloadable CSV file that lists themassdevices that were targeted, that were sent the alert, or that did not or could not receive the alert.There is no option to send the alert again.

Advanced Reports buttonThe Advanced Reports button takes you to the Reports screen, where you can view a range of dif-ferent reports. For more information, see View advanced reports

Note: Unlike the Report Summary screen, the Advanced Reports screen is not localized. Thescreen appears in U.S. English for all BlackBerry AtHoc users, regardless of their defaultsystem or organization locale.

Edit an alertThe amount of editing that you can do to an alert depends on its current status:

l If the alert has a status ofDraft or Scheduled, you can edit any of the details.l If the alert has a status of Live, you can only edit the End Time for the alert.l If the alert has a status of Ended, you cannot make any changes to it.To edit an alert, complete the following steps:

1. In the Navigation bar, click the Alerts > Sent Alerts.2. Use the search field or scroll down in the alerts table to locate the alert you want to edit.

3. Select the checkbox beside the alert name.

4. Click theMore Actions list and selectEdit.5. Make any changes you want to the unlocked fields.

6. ClickSave.

Resend an alertTheResend feature in BlackBerry AtHoc allows an operator to customize the targets when resend-ing an alert. The operator can resend the alert to all original recipients, to only recipients whoresponded to the original, or to only recipients who did not respond to, or did not receive, the ori-ginal alert.

To resend an alert, complete the following steps:


33

1. In the navigation bar, click the Alerts button.2. Click theSent Alerts link.3. Click the alert that you want to resend.

The Alert Summary screen appears.

4. Click theUsers Targeted tab if it is not already open.5. View theSent Details section of the report.6. To resend the alert to everyone in the original targeting list, for example if you want to make

modifications to the original alert, do the following:

a. Click the dropdownmenu in the Targeted row.b. Select theSend alert to these users option.c. (Optional) Revise the copy of the alert that opens.

d. ClickReview and Publish.e. ClickPublish.

7. To resend the alert to everyone to whom the alert was successfully sent, for example, if youwant to give them further details or instructions, do the following:

a. Click the dropdownmenu in theSent row.b. Select theSend alert to these users option.c. (Optional) Revise the copy of the alert that opens.


8. To resend the alert to everyone whose receipt of the alert is either still in progress or hasfailed, do the following:

a. Click the dropdownmenu in the In Progress or Failed row.b. Select theSend alert to these usersoption.c. (Optional) Revise the copy of the alert that opens by targeting new or additional personal

devices.


End an alertTo end one or more alerts that currently have a status of Live, complete the following steps:

1. In the navigation bar, click the Alerts button.2. Click theSent Alerts link.3. Use the search field or scroll down in the alerts table to locate the alert or alerts you want to

end.


34

4. Select the checkbox next to the name of each alert you want to end.

5. At the top of the screen, click theMore Actions dropdown list and then selectEnd.6. Click End to end the alert.

The alert status changes from Live to Ended.

Delete an alertYou can delete any alert that has a status of Draft or Scheduled. If the alert has a status of Live orEnded, it cannot be deleted from the system.

To delete an alert, complete the following steps:

1. In the navigation bar, click the Alerts button.2. Click theSent Alerts link.3. Locate the alert you want to delete.

4. Select the checkbox next to the alert name.

5. At the top of the screen, click theMore Actions dropdown list and selectDelete.6. Click Delete to remove the alert from the system.

The Alerts screen refreshes and the alert no longer appears in the list.

Track alerts with advanced reportsThe following sections describe how to track alerts using advanced reports and how to export andprint those reports.

View advanced reportsThere are twomethods you can use to view an advanced report. You can select a report from theAdvanced Reports screen, or go directly to a specific report from the Users Targeted tab of theAlert Report page for a sent alert.

To view advanced reports from the Advanced Reports screen, complete the following steps:

1. In the navigation bar, click the Alerts button.2. Click theSent Alerts link.3. Click a live or ended alert.

4. Click theAdvanced Reports button at the top of the screen.5. From the Report section, select a report from theSelect a Report list.6. Select a report type to view. The report opens in a new browser screen.

Advanced report typesThe following reports provide advanced tracking information about the alert delivery process,including the number of alerts sent compared to the delivery devices used and the responsesreceived.


35

Report Name Description

Organizational Report Displays the alert progress for recipients grouped by Organizational Hierarchy.

Distribution ListReport

Displays the alert progress for recipients divided by targeted distribution lists.

Delivery Distributionby Devices (Chart)

Displays a group bar chart that tracks, for each device used, the number of targetedalerts, the number of alerts sent, and the number of responses received.

Delivery Distributionby Devices

Displays a tabular report that tracks, for each device used, the number of targetedalerts, the number of alerts sent, and the number of responses received. The reportcan include all devices or only the devices used for targeted recipients. An additionalfeature enables clicking any user count in the report, such as the number of targetedusers, to open a detailed user tracking report that identifies individual users andprovides their names, device addresses, and responses in a new window. Useful forevaluating the effectiveness of the delivery devices used for the alert.

User TrackingReports

Displays user tracking information and user response data. The User Tracking withDevices report tracks which users were targeted by device and which device usersresponded on. The User Tracking with Alerts report tracks the delivery date and deliv-ery status of the alert.


36

Chapter 6: Manage incoming alerts from the inboxThe Inbox displays information about live and expired alerts coming frommobile users. The Inboxprovides organizationswith ameans of managing incoming alerts andmonitoring what is hap-pening in their system. Updates to the Inbox are fully automated, so if a new alert is received or anoperator reviews or replies to an alert, the list will update immediately to display the new item.Alerts coming frommobile users and outside organizations are called incoming alerts.

Access the inboxTo access the Inbox, complete the following steps:

1. In the navigation bar, click the Alerts button.2. Click the Inbox link.

The Inbox opens, showing all incoming alerts in the system. Alerts that have not yet beenreviewed appear in bold font.

The Inbox list displays the following for each incoming alert:

l Severity icon—Hovering your cursor over the icon displays the severity level, which isone of the following: High, Moderate, Low, Informational, or Unknown.

l Alert title—Displays the subject of the alert.

l Source type icon—Displays a (Person) icon if the source is a person or an(Organization) icon if the source is an organization.

l Source name—Displays the name of the person or organization that created the alert.

l Creation date and time—Displays the time and date stamp for the alert.

l Latitude, Longitude—DisplaysGPS coordinates (for incoming livemobile alerts only).

l Alert type—Displays the category of alert.

l Location icon—Displays only if the related alert has amap associated with it.

Chapter 6: Manage incoming alerts from the inbox

37

Chapter 7: Manage the situation mapMap provides an interactive crisis environment in which teams canmanage an emergency by usingthemap to view people, create shapes, andmanage incoming alerts. In the BlackBerry AtHocman-agement system, themap is found under theBasic >Map Settings.

Access the situation mapThis section describes how to work with themap, which provides a highly visual way to shareinformation among end users that are part of a distribution list to which you are publishing. Themap displays shapes, incoming alerts, people, and alert responses. It also includes links tomul-timedia files that are shared with mobile teammembers.

To open themap, click theSituation button in the Navigation bar, and then click theMap link.

TheMap screen opens and displays three colored tabs on the side:Display, Inbox, and Tools.These tabs allow you tomanage objects, people, and shapes on themap and work with incomingalerts frommobile users and outside organizations.

Whenmultiple people, pins (markers), alert responses, and incoming alerts are clustered togetherwithin a small area of amap, the SituationMap displays a large circle with a number on it, called acluster, to let you know that multiple objects exist in that location.

Single-clicking on a cluster causes the list of clustered objects to appear in the Tools tab in the side-bar. Double-clicking on a cluster zooms themap in far enough to show each individual object in thecluster.

Add shapes to the mapTo add shapes to themap and define their properties through the Tools sidebar, complete the fol-lowing steps:

1. In the Navigation bar, clickSituation >Map.2. If necessary, zoom in on themap tomore easily see the area where you want to add the

object.

3. Click the (Tools) icon to open the Tools sidebar. The Tools sidebar opens to display thedifferent drawing tools available to you.

4. Click to select one of the drawing tools, and thenmove your mouse over the area of themapover which you want to create the object.

o For theMarker tool, click themouse to specify a single point on themap.o For theCircle andSquare tool, click and drag to set the size of the object.o For thePolygon tool:

a. Click and release at the first place you want to start creating your own customshape.

b. Move your mouse to the end of the first edge, then click again to start creating thesecond edge.

Chapter 7: Manage the situationmap

38

c. Continue the process until you have defined all edges and are back at the start of thefirst edge.

d. Double-click to finish the creating the object. The border changes color to indicatethat the object has been created.

After you have finished creating the object, the Tools details screen opens.5. Enter a name and description for the object.

6. Select theVisibility setting for the object. The setting you choose determineswho can seethe shape.

7. Select themap Layer on which you want the object to appear.8. (Optional) Select theMobile Access check box if you want the item to be visible onmobile

devices.

9. (Optional) Click theAdd Media link if you want to add a video, photograph, or any othermedia to the object.

10. ClickSave to add the new object to the layer you specified in Step 8.

Attach media to objects on the mapThe BlackBerry AtHoc system allows you to attachmedia, such as images or video to the shapesand pins on themap so that you can share themedia when sending alerts to your team. If you arethe creator of an object, you can attachmedia when the object is first created or at any time in thefuture. If you are not the object creator, you can addmedia as long as you have the required per-missions to view andmodify the object.

To addmedia to an existing object, complete the following steps:

1. In the Navigation bar, clickSituation >Map.2. On themap, locate the object to which you want to addmedia. If necessary, zoom in on the

map to better view the object.

3. Click the shape or pin to select it.

The border around the object changes color to indicate that it has been selected. The Toolssidebar opens.

4. Enter a Name for the location selected.

6. ClickAdd Media.

7. Choose themedia file in one of the following ways:

o Select the file from the existingmedia files field.o Click theUpload Media link to accessmedia files on your computer and upload them toyour BlackBerry AtHoc media library.

Note: Only .MPEG, .MP4, and .webm video formats and .GIF, .JPEG, and .PNG imageformats can be uploaded.


39

8. ClickAttach9. On the object properties edit screen, clickSave to finish attaching files to the object.

Operators can view full-sized versions of attached pictures and video by clicking the relevantthumbnail in the Tools sidebar.

Share map objectsVarious participants in an organization have different types of permissions to view objects on themap, making it possible to restrict sensitive information to specific users. You can share incomingalerts, shapes, and pins (but not people) directly from amap by changing the visibility permissionsfor all users, the emergency team, organizations, or your team. You can also grant mobile accessto users.

Share incoming alerts, shapes, and pins directly from a mapTo change visibility permissions and share SituationMap objects such as incoming alerts, shapes,and pins, complete the following steps:

1. In the Navigation bar, clickSituation >Map.2. On themap, locate the object you want to share. If necessary, zoom in on themap to better

view the object.

3. Click the shape or incoming alert object to select it.

The border around the object changes color to indicate that it has been selected. The Toolssidebar opens to display the object properties.

4. Click the (Edit) icon at the bottom of the screen to open the object properties edit screen

5. Click theVisibility dropdown list to change the visibility permissions for the object6. Click the Layer dropdown list to change the layer in which the object appears.7. (Optional) Change themobile device visibility of the object by selecting or deselecting the

Mobile Access check box.8. ClickSave to update the object properties.

Share peopleNote: Only Administrator users have the ability to make the People layer visible onmobile maps.

In addition, the permission is all-or-none, meaning all people become visible or no peopleare visible. Administrators cannot make some people visible and some not visible at thesame time.

To share people, complete the following steps:

1. In the Navigation bar, clickSituation >Map Settings. .TheMap and Layers screen that appears provides separate areas for setting up and con-figuringmaps, shape layers, and people layers, with default layers displayed for maps and lay-ers.


40

2. In the People layers section, click the (Edit) icon next to the layer you want to make vis-ible.

3. Click theVisibility dropdown list to change the visibility permissions for the layer.4. (Optional) Change themobile device visibility of the object by selecting or deselecting theDis-

play on mobile check box.5. (Optional) If you selected the check box in Step 5, select a time filter for displaying people on

themobile map by clicking theShow items with location updates within the followingtimeframe dropdown and selecting one of the following options: All, 1Week, 1 Day, 8 Hours,4 Hours, 30Minutes, Now (1Minute).

6. ClickDone to update the object properties.7. ClickSave or Save + Exit at the top of theMap and Layers screen to save your changes.

Important: If you forget to do this, the changes youmade to the People layer are not saved inthe system, even if you clickedDone in Step 7.

Work with map layersShared Situational Awarenessmaps allow you to filter themap by layers for organizing and segreg-ating information that can then be selectively displayed on a singlemap, with different users able tosee different layers depending on their roles and permissions. These layers can include one forinfrastructure, one for weather, one for onlymembers of a private team, a shared one available tothe public, and so on.

To work with map layers, complete the following steps:

1. In the Navigation bar, clickSituation >Map.

2. On themap, click the (Display) icon to open the Display sidebar.3. In the Layers section, select the layers of themap that you want to view, or clickAll to view

everything orDefault to view only the default map layers.

Note: The default layers of themap are configured on theMap and Layers screen, access-ible to Administrators at Settings > Situation > Map and Layers.

4. In the People section of the Display sidebar, select the groups of people you would like to seedisplayed on themap.

Note: Aswith the Layers section, the default groups are configured by Administrator users atSettings > Situation > Map and Layers.

5. In the Alert Responses section of the sidebar, click the icon next to an alert to expand it andview the alert responses that have been received so far.

6. Select the check box next to each response you would like to see on themap.

Themap then refreshes and displays the responses you selected.


41

Monitor incoming alertsIncoming alerts are created by external organization, or by users using their mobile devices andare displayed within theMap feature of BlackBerry AtHoc. There are three Incoming alerts cat-egories—Mobile, Other (IPAWS), and Standard—all of which appear within the Inbox sidebar oftheMaps screen.

To view incoming alerts, complete the following steps:

1. In the Navigation bar, click theSituation >Map.

2. Click the (Inbox) tab.The Inbox sidebar opens, displaying a list of anyMobile, General, and IPAWS incoming alertsthat are currently in the system.

Click any of the incoming alerts to open the details screen. If you click aMobile alert, it also dis-plays on themapwith a tooltip.

3. (Optional) Use the Filters field at the bottom of the screen tomodify themap display.

Using the filter fields, you can set the following:

l Themaximumage of an incoming alert that can appear on the screen. Use the slider barto specify incoming alerts that are anywhere from 1minute old to no limit.

l Whether to display people and incoming alerts based on the range of visibility settingsthat have been used in creating the incoming alerts.

Note: TheShow by visibility filter only appears if you belong to at least one teamwithin the EmergencyCommunity.

l Whether to display only users who are accessible onmobile devices, only users who arenot accessible onmobile devices, or all users.

Publish alerts from the mapYou can publish alerts from any object on themap. For example, if there is an emergency incomingalert, youmight want to publish an alert to a team to respond. Or, if the incoming alert is rep-resented by a shape on themap, you can send the coordinates of the shape and any relevant pic-tures to your team by publishing an alert.

To publish an alert from themap, complete the following steps:

1. In the Navigation bar, click theSituation >Map.2. Do one of the following:

l Locate the object on themap. If necessary, zoom in on themap to view the object better.

l Click the (Inbox) tab and select an incoming alert.

3. Select the object to open the details view.

4. Click the (Publish) icon.


42

5. Enter a title andmessage for the alert.

6. Add any response options.

7. Enter the targeted recipients, including teams and organizations and verify that your targetedaudience is accessible.

8. Click thePublish Now button at the bottom of the sidebar.

A notification appears, containing a link to the User Tracking report for the alert.

9. ClickOK.10. (Optional) Click theDisplay tab on themap to review alert responses.


43

Chapter 8: Manage UsersThe following topics describe how tomanage users within the BlackBerry AtHoc system. Userscan be the end users that receive alerts, operators with varying degrees of privileges, or admin-istrators that configure BlackBerry AtHoc settings. The Users screen lists all users associated withan organization and provides you with tools to manage the status and details for those users.

Create a userNote: Youmust have End User Manager privileges to create users.

Note: If the "Enterprise Features" setting is enabled in the General Settings of an enterprise organ-ization, the BlackBerry AtHoc system enforces user uniqueness in the enterprise organ-ization and its sub organizations. Users created in the enterprise organization or in any of itssub organizationsmust have a unique username andMapping ID.

To create end users from the Users screen, complete the following steps:

1. In the Navigation bar, clickUsers > Users.2. ClickNew.

Note: Fieldsmarked with an asterisk (*) on the New User screen are required.

3. In the Basic Information section, enter the following details about the user:

l Username—The name the user is assigned by the system. Usernames are frequentlyimported from external systems and cannot be edited later.

l First and Last Namel Display Name—The name used to refer to the user within the system, such as bsmith orJack Jones. This field can be edited later by the end user.

l Organizational Hierarchy—(If available) Click the / (forward slash) link. On the popupscreen that appears, navigate to the specific organization to which the user belongs.ClickApply to add the organization information to their record in the system.

l Any custom fields added by the administrators, including details such asCPR cer-tification status, EmergencyCommunitymembership, or special skills.

4. In theNumbers section, enter the work number, mobile number, pager numbers, and anyother numbers that could be used to contact the user. Note: International numbers and numbers with extensions are supported.

BlackBerry AtHoc then runs a validation check tomake sure the number is valid. If it isnot, an "Invalid Phone Number" error appears under the text field. You cannot save thenew user information until you correct or remove the number.

Note: For pagers, only devices that are enabled for the organization appear in the list.

5. In theOnline Addresses section, enter work and home email addresses.6. In thePhysical Addresses section, enter work and home addresses.

Chapter 8: Manage Users

44

7. In theDistribution List Membership section, specify the distribution lists in which the user isamember.

Note: Requiredmemberships are provided by default and cannot be deleted. If you do nothavemanagement permissions for a group, the group is read-only.

8. In theAdvanced Information section, which is configurable for each system, complete anyrequired fields plus any of the non-required fields you want to include in the account details forthe user.

9. Provide a password that meets the displayed rules, if required.

10. ClickSave to create the user.The details of the new user then appear in summary form on the screen. You can then returnto the Users screen or grant the user operator permissions.

Grant Operator PermissionsNote: After youmake changes to publisher permissions, youmust disconnect and re-con-

nect from themobile app.To grant operator permissions to a user, complete the following steps:

1. Create a user.

After you create the new user and clickSave, the user details screen appears.2. Click theGrant Operator Permissions button. TheOperator Permissions screen appears.3. From theOperator Roles list and select each of the roles you want to assign to the user.

As you select roles, they appear on the screen under the Operator Roles list. If you selectmore than three roles, the first three are displayed and the rest can be seen by clicking thescrollbar that appears in the field.

4. (Optional) Enter and confirm a password that meets the specified requirements.

5. (Optional) Select the check boxes to specify if the user must change their password at nextlogin, and whether the password expires.

6. ClickSave to grant the user Operator permissions in the system.

Edit operator permissionsNote: If you want to revoke all Operator permissions for a user, see Revoke operator permissions.

Note: After youmake changes to publisher permissions, youmust disconnect and re-con-nect from themobile app.

To edit Operator permissions to grant or revoke roles for an operator or administrator, completethe following steps:

1. In the Navigation bar, click theUsers > Users.2. Click the Operator name in the list.


45

The user details screen opens, displaying all of the information for that user in the system.

3. Click theEdit Operator Permissions button. TheOperator Permissions screen appears.4. From theOperator Roles list and select each of the roles you want to assign to the user.5. To remove anOperator permission, click theX icon next to the name.

6. ClickSave to update the permissions of the Operator in the system.

Revoke operator permissionsRevoke operator permissions to remove all permissions.

To revoke operator permissions, complete the following steps:

1. In the Navigation bar, click theUsers > Users.2. Click the name of the operator in the list. The user details screen opens, displaying all of the

information for that user in the system.

3. From theMore Actions list selectRevoke Operator Permissions.A warning notification screen appears, asking "Are you sure you want to revokeOperator Per-missions for this user?" and informing you that this action cannot be reversed. Revoking Oper-ator permissions cannot be reversed, but you can later assign the permissions to the operatoragain using the Edit Operator Permissions button on the user details screen.

4. ClickRevoke.

Note: If a user is logged in to the systemwhen their operator permissions are revoked, they arelogged out on their next page navigation and redirected to an error screen with the followingmessage: "You do not have the required Operator Permissions to access this page.Contact your administrator."

View user detailsNote: Youmust have End User Manager privileges to view detailed information about users in the

system, including contact address, memberships, login information and location inform-ation.

To view user details, complete the following steps complete the following steps:

1. In the Navigation bar, click theUsers > Users.2. Click the user name.

The detail screen for the user appears. The details screen displays the following informationabout the user:

l Basic information, including username, first and last name and date the user was created

l Numbers

l Online addresses

l Physical addresses

l Distribution list membership

Chapter 8: Manage Users

46

l Permissions

l Login and location

l User activity

l Any user attributes defined by administrators

Edit user detailsNote: The following instructions explain how tomake changes to the details of an individual in the

system. Youmust have End User Manager privileges to edit user details.

To edit user details, complete the following steps:

1. In the navigation bar, click theUsers > Users.

2. Click the (Edit) icon next to the name of the user whose details you want to edit.3. Make changes to any of the user fields in the following sections of the screen:

l Basic Information

l Numbers

l Online Addresses

l Physical Addresses

l Distribution List Membership

l Login and Location

l Any user attributes defined by administrators

Note: System-generated user details such asDesktop Software Session Information,Mobile Device Location, andmost of the User Activity information cannot be edited.



47

Chapter 9: BlackBerry AtHoc customer portalBlackBerry AtHoc customers can obtain more information about BlackBerry AtHoc products or getanswers to questions about their BlackBerry AtHoc systems through the Customer Portal:

http://www.athoc.com/customers/customer-support.html

The BlackBerry AtHocCustomer portal also provides support through computer-based training,Operator checklists, best practice resources, referencemanuals, and user guides.

Chapter 9: BlackBerry AtHoc customer portal

48

http://www.athoc.com/customers/customer-support.html

blackberryathocnetworkedcrisiscommunication ...€¦ · chapter7:managethesituationmap 38...

Documents