BlackBerry AtHoc Geofencing User Guide
- July 4, 2024
- BlackBerry
Table of Contents
- AtHoc Geofencing
- What is AtHoc Geofencing?
- Geofence map settings and controls
- Create a geofence
- View all geofences
- View tracked users for a geofence
- Edit a geofence
- View geofence dwelling reports
- Export geofence dwelling reports
- Delete a geofence
- BlackBerry AtHoc Customer Support Portal
- Documentation feedback
- Legal notice
- References
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
BlackBerry AtHoc
Geofencing
AtHoc Geofencing
What is AtHoc Geofencing?
AtHoc Geofencing is a standalone application that enables operators to
accurately and easily track the location of users in the field. Using AtHoc
Geofencing, operators can easily identify where a user currently is, where
they’ve been, and how long they’ve been there. AtHoc Geofencing provides
automated entry and exit tracking, giving the operator greater situational
awareness of their users.
Enable geofence features
The AtHoc Geofence application is not enabled by default.
Before you begin: You must be a System Administrator to enable geofence
features.
- Log in to the BlackBerry AtHoc management system as a System Administrator.
- Click .
- On the Settings screen, in the System Setup section, click Feature Enablement.
- On the Feature Enablement screen, click the IsGeoFencingAppSupported row.
- On the Edit Feature Enablement dialog, select True from the Enabled drop-down list to enable geofencing.
- Optionally, if you are logged in to an enterprise or super enterprise organization, select the Force all children to inherit option.
- Click Save.
The AtHoc Geofencing features are enabled and the Geofencing button appears on
the home page of the BlackBerry AtHoc management system.
Access the Geofence application
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to access the Geofence application.
- Geofence features must be enabled.
-
Do either of the following:
• Log in to the BlackBerry AtHoc management system as a Geofence Manager, Enterprise Administrator,
Organization Administrator, or System Administrator and then click Geofencing on the home page.
• Open a browser window and enter the following URL: https://<>/geofence.
The AtHoc Geofence application opens in a new browser tab. -
Optionally, from the AtHoc Geofence application, manage Geofence map settings and controls.
Geofence map settings and controls
Geofence map settings
Setting | Description |
---|---|
Reset to the default Geofence map view. | |
Open the Imported Shape Layers manager. View and enable imported shape |
layers. For more information about adding and validating shape layers, see
Shape layers in the BlackBerry AtHoc Live Map guide.
| Open the Geofence manager. Create and manage geofences. View dwelling
reports.
| Access the Help & Support page. This page provides information about the
product version, terms of service, and a link to the documentation.
| Open the Map Settings screen in the BlackBerry AtHoc management system.
| View your profile information.
Geofence map controls
Control | Description |
---|---|
Enter an address and press Enter on your keyboard to move the map view to |
that location.
| Select the type of map you want to view.
| Open the drawing tools panel.
| Draw a polygon on the map.
| Draw a rectangle on the map.
| Draw a circle on the map.
| Select or deselect a shape on the map.
| Delete a drawn shape from the map.
| Open the measurement tools tray.
| Measure the distance between points on the map.
| Measure the area of a drawn shape on the map.
| Clear a measurement from the map.
| Close a tool tray or panel.
| Move to the default view.
| Zoom in.
| Zoom out.
Create a geofence
Create geofences to track the location of your users. The entry and exit times
of users who enter or leave the geofence are tracked.
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to create a geofence.
- Geofence features must be enabled.
-
Access the Geofence application.
-
In the side navigation bar, click > Create Geofence. The Create Geofence panel opens.
-
On the map, do any of the following:
• Click to search for a location on the map.
• Click to open the drawing tools panel and then draw a shape on the map.
• Select an existing shape on the map.
• Select an imported shape layer on the map. To display an imported shape layer, click to open the Imported Shape Layers panel. Toggle the switch for the shape layer to display it on the map. -
On the Create Geofence panel, in the Basic section, select the Active or Inactive status option. Active is selected by default. Inactive geofences do not appear on the map. User entries and exits are tracked only in active geofences.
-
In the Basic section, enter a name and description for the geofence. The Name field has a 100 character limit. The Description field has a 300 character limit. The following special characters are not allowed: ` ! $ % & ^ = . ; \ : ? ” < > | [ ].
-
In the Tags field, add up to 5 tags. Select a predefined tag, or type to create a new tag. Press Enter on your keyboard to save the tag. The following special characters are not allowed: ` ! $ % & ^ = . ; \ : ? ” < > | [ ].
-
In the Tracked Users section, do either of the following to add tracked users to the geofence. At least one active user must be selected. Operators with userbase restrictions see only users they have access to.
• Click the USERS tab. Click ADD USERS. On the Add Users dialog, select the users to track. Click APPLY. You can select up to 50 users.
• Click the DISTRIBUTION LISTS tab. Click inside the Distribution Lists field and then select the distribution lists to include from the pull-down menu. Click anywhere outside of the Distribution Lists field to exit the distribution list selector.
The number of tracked users is displayed in the Tracked Users section. Click the number of tracked users to open the Tracked Users dialog and view information about the tracked users. -
Click Save.
View all geofences
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to access the geofence manager.
- Geofence features must be enabled.
- Access the Geofence application.
- In the side navigation bar, click > Geofences. The Geofences panel opens. A indicates an active geofence. A indicates an inactive geofence. The indicates the number of active users in a geofence. Any tags associated with a geofence are displayed below the name of the geofence.
- Optionally, click the name of a geofence to zoom to it on the map.
- Optionally, in the row for a geofence, click to do any of the following:
• Edit the geofence
• View the dwelling report
• Delete the geofence
View tracked users for a geofence
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to view the tracked users for a geofence.
- Geofence features must be enabled.
- Access the Geofence application.
- In the side navigation bar, click > Geofences. The Geofences panel opens. The indicates the number of active users in a geofence.
- On the Geofences panel, in the row for a geofence, click > Edit.
- On the Edit Geofence panel, click the link that displays the number of users in the Tracked Users section. The Tracked Users dialog appears, displaying all tracked users in the geofence.
- Optionally, on the Tracked Users dialog, do any of the following:
• Click any column header to sort the display alphabetically by that column’s values.
• Enter a name in the Search names field to search for a tracked user by display name, username, first name, or last name.
• Click COLUMNS to toggle the display of any column on or off. Each column represents a user attribute. Organization hierarchy and dynamic hierarchy type attributes are not supported.
• Click FILTERS to narrow the display of tracked users by display name, username, first name, or last name.
• Click DENSITY to adjust the height of rows in the display.
Edit a geofence
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to create a geofence.
- Geofence features must be enabled.
-
Access the Geofence application.
-
In the side navigation bar, click > Geofences.
-
On the Geofences panel, in the row for a geofence, click > Edit.
-
On the Edit Geofence panel, in the Basic section, do any of the following:
• Select the Active or Inactive status option.
• Update the name and description for the geofence. The Name field has a 100 character limit. The Description field has a 300 character limit. The following special characters are not allowed:! $ % & ^ = . ; \ : ? ” < > | [ ]. • In the Tags section, add up to 5 tags. Select a predefined tag, or type to create a new tag. Press Enter on your keyboard to save the tag. The following special characters are not allowed:
! $ % & ^ = . ; \ : ? ” < > | [ ].
Click to remove a tag. -
On the geofence map, click to move the location of the geofence or change its shape. This option is available only for geofences created by drawing a shape on the map. The shapes of geofences created from imported shape layers cannot be modified.
-
On the Edit Geofence panel, in the Tracked Users section, do any of the following:
• Click the link that displays the number of users in the Tracked Users section. The Tracked Users dialog appears, displaying all tracked users in the geofence.
• Click the USERS tab. Click ADD USERS to add additional tracked users to the geofence. On the Add Users dialog, select the users to track. Click APPLY.
• Click the DISTRIBUTION LISTS tab. Click inside the Distribution Lists field and then select the distribution lists to include from the pull-down menu. Click anywhere outside of the Distribution Lists field to exit the distribution list selector.
• Click to remove a tracked user. -
Click Save.
View geofence dwelling reports
The geofence dwelling report provides information about the entry, exit, and
dwelling times of your users for one or more geofences.
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to view geofence dwelling reports.
- Geofence features must be enabled.
-
Access the Geofence application.
-
Do either of the following:
• To view a dwelling report for all geofences in your organization, in the side navigation bar, click > Reports. The Dwelling Report screen opens. The dwelling report for the last day is displayed by default.
• To view a dwelling report for a specific geofence, click > Geofences. On the Geofences panel, on the row for a geofence, click > View Report. -
Optionally, on the Dwelling Report screen, select a entry and exit time and date from the Entry Time and Exit Time calendar pickers.
-
Optionally, on the Dwelling Report screen, do any of the following:
• Click any column header to sort the display alphabetically by that column’s values.
• Enter a name in the Search geofence field to search for a geofence.
• Click COLUMNS to toggle the display of any column on or off.
• Click DENSITY to adjust the height of rows in the display.
• Click EXPORT > Download as CSV to save the dwelling report to your local system.
Export geofence dwelling reports
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to export geofence dwelling reports.
- Geofence features must be enabled.
- Access the Geofence application.
- To export a dwelling report for all geofences in your organization, in the side navigation bar, click > Reports.
- To export a dwelling report for a specific geofence, click > Geofences. On the Geofences panel, on the row for a geofence, click > View Report.
- On the Dwelling Report screen, click EXPORT > Download as CSV to save the dwelling report to your local system.
Delete a geofence
Deleting a geofence cannot be undone. Deleting a geofence also deletes all
data related to the geofence.
Before you begin:
- You must be a Geofence Manager, Enterprise Administrator, Organization Administrator, or System Administrator to export geofence dwelling reports.
- Geofence features must be enabled.
- In the side navigation bar, click > Manage.
- On the Geofence Manager panel, in the row for a geofence, click > Delete.
- On the Delete geofence? confirmation dialog, click DELETE.
BlackBerry AtHoc Customer Support Portal
BlackBerry AtHoc customers can obtain more information about BlackBerry AtHoc
products or get answers to questions about their BlackBerry AtHoc systems
through the Customer Support Portal:
https://www.blackberry.com/us/en/support/enterpriseapps/athoc
The BlackBerry AtHoc Customer Support Portal also provides support via
computer-based training, operator checklists, best practice resources,
reference manuals, and user guides.
Documentation feedback
The BlackBerry AtHoc documentation team strives to provide accurate, useful,
and up-to-date technical documentation.
If you have any feedback or comments about BlackBerry AtHoc documentation,
email
athocdocfeedback@blackberry.com.
Please include the name and version number of the document in your email.
To view additional BlackBerry AtHoc documentation, visit
https://docs.blackberry.com/en/id-comm-collab/blackberry-athoc.
To view the BlackBerry AtHoc Quick Action Guides, see
https://docs.blackberry.com/en/idcomm-collab/blackberry-athoc/Quick-action-
guides/latest.
For more information about BlackBerry AtHoc products or if you need answers to
questions about your BlackBerry AtHoc system, visit the Customer Support
Portal at https://www.blackberry.com/us/en/support/enterpriseapps/athoc.
Legal notice
©2024 BlackBerry Limited. Trademarks, including but not limited to BLACKBERRY,
BBM, BES, EMBLEM Design, ATHOC, CYLANCE and SECUSMART are the trademarks or
registered trademarks of BlackBerry Limited, its subsidiaries and/or
affiliates, used under license, and the exclusive rights to such trademarks
are expressly reserved. All other trademarks are the property of their
respective owners.
Patents, as applicable, identified at:
www.blackberry.com/patents.
This documentation including all documentation incorporated by reference
herein such as documentation provided or made available on the BlackBerry
website provided or made accessible “AS IS” and “AS AVAILABLE” and without
condition, endorsement, guarantee, representation, or warranty of any kind by
BlackBerry Limited and its affiliated companies (“BlackBerry”) and BlackBerry
assumes no responsibility for any typographical, technical, or other
inaccuracies, errors, or omissions in this documentation. In order to protect
BlackBerry proprietary and confidential information and/or trade secrets, this
documentation may describe some aspects of BlackBerry technology in
generalized terms. BlackBerry reserves the right to periodically change
information that is contained in this documentation; however, BlackBerry makes
no commitment to provide any such changes, updates, enhancements, or other
additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of
information, hardware or software, products or services including components
and content such as content protected by copyright and/or thirdparty websites
(collectively the “Third Party Products and Services”). BlackBerry does not
control, and is not responsible for, any Third Party Products and Services
including, without limitation the content, accuracy, copyright compliance,
compatibility, performance, trustworthiness, legality, decency, links, or any
other aspect of Third Party Products and Services. The inclusion of a
reference to Third Party Products and Services in this documentation does not
imply endorsement by BlackBerry of the Third Party Products and Services or
the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR
JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR
WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY
CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF
DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY,
MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR
ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR
RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF
ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES
REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT
VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR
LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY
LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE
EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE
HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE
DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO
EVENT SHALL BLACKBERRY BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS
DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE,
HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN
INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT,
CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR
AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO
REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS
INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA,
FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY
APPLICATIONS USED IN CONJUNCTION WITH BLACKBERRY PRODUCTS OR SERVICES,
DOWNTIME COSTS, LOSS OF THE USE OF BLACKBERRY PRODUCTS OR SERVICES OR ANY
PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF
COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY
LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF
BLACKBERRY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION,
BLACKBERRY SHALL HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN
CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR
STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A)
IRRESPECTIVE OF THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU
INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT
LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR
BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY
REMEDY CONTAINED HEREIN; AND (B) TO BLACKBERRY AND ITS AFFILIATED COMPANIES,
THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE
PROVIDERS), AUTHORIZED BLACKBERRY DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE
PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT
CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL
ANY DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR
OF BLACKBERRY OR ANY AFFILIATES OF BLACKBERRY HAVE ANY LIABILITY ARISING FROM
OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and
Services, it is your responsibility to ensure that your airtime service
provider has agreed to support all of their features. Some airtime service
providers might not offer Internet browsing functionality with a subscription
to the BlackBerry® Internet Service. Check with your service provider for
availability, roaming arrangements, service plans and features. Installation
or use of Third Party Products and Services with BlackBerry’s products and
services may require one or more patent, trademark, copyright, or other
licenses in order to avoid infringement or violation of third party rights.
You are solely responsible for determining whether to use Third Party Products
and Services and if any third party licenses are required to do so. If
required you are responsible for acquiring them. You should not install or use
Third Party Products and Services until all necessary licenses have been
acquired. Any Third Party Products and Services that are provided with
BlackBerry’s products and services are provided as a convenience to you and
are provided “AS IS” with no express or implied conditions, endorsements,
guarantees, representations, or warranties of any kind by BlackBerry and
BlackBerry assumes no liability whatsoever, in relation thereto. Your use of
Third Party Products and Services shall be governed by and subject to you
agreeing to the terms of separate licenses and other agreements applicable
thereto with third parties, except to the extent expressly covered by a
license or other agreement with BlackBerry.
The terms of use of any BlackBerry product or service are set out in a
separate license or other agreement with BlackBerry applicable thereto.
NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN
AGREEMENTS OR WARRANTIES PROVIDED BY BLACKBERRY FOR PORTIONS OF ANY BLACKBERRY
PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
BlackBerry Enterprise Software incorporates certain third-party software. The
license and copyright information associated with this software is available
at http://worldwide.blackberry.com/legal/thirdpartysoftware.jsp.
BlackBerry Limited
2200 University Avenue East
Waterloo, Ontario
Canada N2K 0A7
BlackBerry UK Limited
Ground Floor, The Pearce Building, West Street,
Maidenhead, Berkshire SL6 1RL
United Kingdom
Published in Canada
References
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>