Managing modules and assets

Your Radar modules are added to the BlackBerry Radar Dashboard application under your organization when they are purchased. You need to add the assets that will host these Radar modules to the application.

Before adding any assets to the application, you must define the asset types, as you need to specify the asset type when adding an asset. A typical sequence of asset configuration is as follows:

  1. Define asset types
  2. Add assets
  3. Pair assets with modules

The rest of the tasks can be performed as required.


Define an asset type

An asset type is a common alerting configuration for assets that share that configuration. In each asset type, you can specify the types of alerts you want the BlackBerry Radar Dashboard to notify users about. For example, you can define an asset type for assets that carry cargo of high value. In this asset type, you can include alerts about changes in door state and unusual changes in temperature and humidity. When the BlackBerry Radar service discovers any alert condition in any asset of this asset type, it will report that condition as an event on the map, and also send an alert notification message to registered users.

You can override the alert settings for an individual geofence or a particular asset. For more information, see Configure or modify alert settings.

To define an asset type:

  1. Open the Assets Types view from the main menu.
  2. Click Add Asset Type.
  3. Enter a name and a description for the asset type.
  4. In the Alert On area, check each box that you want to include in asset alert notification (see example).
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  5. Click the Add Asset Type button.

Add an asset

When a new asset is added to your fleet, enter the asset in the application.

  1. Open the Assets view.
  2. Click Add to open the Add Asset view. A red textbox denotes a mandatory field.
  3. In the Identifier field, enter the asset identifier. This is usually the number or code painted on the exterior of the asset.
  4. Under Asset Type, click to display the dropdown list. You must have the required asset type defined (see Define an asset type).
  5. Select the asset type from the list.
  6. Under Trailer Type, click and select the trailer type from the dropdown list.
  7. Under Door Type, click and select the door type from the dropdown list.
  8. Under Mounting Location, click and select the mounting location from the dropdown list.
  9. In the Mileage at Install field, enter the mileage at the time of installation.
  10. In the Dimensions fields, enter the asset dimensions.
  11. Click Save New Asset.

Add assets in bulk

If you have a large number of assets to add, you can add them by uploading a CSV file that contains the information about the assets.

CSV stands for comma-separated values. A CSV file is a text file that contains information structured in tabular form. If you have an Excel spreadsheet that contains all the assets as well as the required information about the assets (see list below), you can create a CSV file simply by saving your Excel file as Comma Separated Values (CSV).

It’s important to note that your CSV file must contain all the information required for each asset. This means that you must include the following columns in your CSV, and that each column must contain the required information, as detailed below.

You can give the columns any names in your CSV file, but the column names must be in the first row and separated by commas (or another delimiter that you decide to use).

The content of the asset type column must match the asset type names used in the application; for example, if your asset type is Perishable Cargo, enter it exactly in your CSV file.

The content of the door type, roof type, and trailer type columns must use only lowercase letters. For any multiple-word type names, you must use underscores between the words. The table below lists all the type names used on the Dashboard UI and their expected values in the CSV file.

On Dashboard UI In CSV
Trailer Type
  • Dry Trailer
  • Intermodal
  • Dry Only
  • Chassis
  • Flatbed
  • dry_trailer
  • intermodal
  • dry_only
  • chassis
  • flatbed
Door Type
  • Barn
  • Rollup
  • None
  • barn
  • rollup
  • none
Mounting Location
  • Door
  • Chassis
  • door
  • chassis

The CSV file excerpt below provides a few sample entries. The screen image that follows shows one of the assets added using this CSV file.

assets_csv

csv_added_asset

Note 1: A CSV file may contain no more than 1000 rows. A larger CSV file will cause the import to fail.

Note 2: Importing a CSV file will block the application UI until the import is completed. Do not close the browser while a CSV file is being processed.

To upload a CSV file:

  1. Open the Assets view.
  2. Click CSV.
  3. In the Upload CSV File of Assets view, change the delimiter to match the delimiter used in your CSV file, if needed.
  4. Click Choose File under CSV File.
  5. Navigate to the location of the CSV file to upload, select the file, and click Open.
  6. In the next screen, under Configure Columns, Data Field lists the data fields required for adding assets, and CSV Field Header allows you to select the headers used in the CSV file that match the data fields. In each dropdown list under CSV Field Header, select the header name that matches the data field on the left.
  7. Click Process CSV File. When processing is complete, a summary of the operation is displayed (see example).
  8. Click Done to go back to the Assets view.

Pair a module with an asset

When a BlackBerry Radar module is installed on an asset, you need to pair the module with the asset in order for asset tracking to start on this asset. This can be done in either the Modules or the Assets view.

At the Modules view:

  1. Open the Modules view.
  2. Check Only show unassociated modules to display a shorter list.
  3. Select the module from the list. If the module is already associated with an asset, you need to disassociate it first before associating it with a different asset.
  4. To pair with an existing asset, under Associate with Existing Asset:
    • Type in the asset identifier or select from the dropdown list.
    • Click Associate.

Alternatively, at the Assets view:

  1. Search for or select the asset from the Assets view.
  2. Open the Association tab. This asset’s association is shown under Current Association.
  3. If this asset is already associated with another module, click Disassociate.
  4. In the confirmation dialog box, click Yes.
  5. Under Associate with Module,
    • Click Select Module to display the dropdown list
    • Select the module to associate with
    • Click Associate.

Unpair a module

When a Radar module needs to be replaced or removed from the container, remove the association between the module and the asset in the BlackBerry Radar Dashboard. You can do this from either the Modules view or the Assets view.

From the Modules view:

  1. Open the Modules view.
  2. Select the module from the list.
  3. Click Disassociate.
  4. Click Yes in the confirmation dialog box.

Alternatively, from the Assets view:

  1. Open the Assets view.
  2. Select the asset from the list.
  3. Open the Association tab.
  4. Click Disassociate.
  5. Click Yes in the confirmation dialog box.

Modify asset information

You can modify an individual asset's properties, such as its asset type and trailer type, in the asset view:

  1. Open the Assets view.
  2. Click the asset to modify.
  3. Click Options to open the Options tab.
  4. To change the asset identifier, enter the new identifier in the Identifier field.
  5. To change the asset type, trailer type, door type, or mounting location, select the new type from the corresponding dropdown list.
  6. To modify or add to notes, enter it in the Notes area.
  7. To change asset dimensions, enter new dimension values in the Dimensions fields.
  8. Click Save Changes.

Modify asset alert settings

You can modify asset alert settings in the asset view:

  1. Open the Assets view.
  2. Click the asset to modify.
  3. Click Options to open the Options tab.
  4. Check the Override alerting box. This opens a new list of alert boxes. Note that alerts set here will override the alerts set in the asset type or in any geofence. Check all the boxes that you want to override alerting for; modify the values under the alerts as needed (see example).
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  5. Scroll down and click Save Changes.

Remove an asset

If an asset needs to be removed from the fleet, remove it from the BlackBerry Radar Dashboard. Note that if an asset is associated with a module, you cannot remove the asset.

  1. Open the Assets view.
  2. Click the asset you want to delete.
  3. Click the grey garbage can button garbage can button at the upper right corner of the asset view. If the button is not clickable, this asset is in use and cannot be removed.
  4. Click Yes in the confirmation dialog box.

Remove an asset type

If an asset type is no longer used, you may remove it from the Dashboard application. Note that if any asset is assigned to this asset type, you won’t be able to remove the asset type.

  1. Open the Asset Types view.
  2. Click the asset type you want to remove.
  3. Click the grey garbage can button garbage can button at the upper right corner of the asset type view. If the button is not clickable, this asset type is in use and cannot be removed.
  4. Click Yes in the confirmation dialog box.