App Version: v1.17.0

Introduction

Purpose

This document is the user's manual for the Overview Cloud Mobile application. This represents an evolution of the original mobile application and provides the user an explanation of all the major views of the application.

Scope

The application is represented with three major views accessible via a bottom navigation bar following the Material UI Guideline principals. Each of the major views will be documented and explained hitting each of the major points. This will allow a user greater ease in using the mobile application.

NOTE: The application screenshots are from Android but the Android and iOS applications have the same UI design.

Login

Prior to accessing the mobile application, a user must be a Logikos Overview client.

First Time App Execution

First Time App Execution

When you first execute the mobile application you will be presented with location permission request. You have the ability to deny this but be advised you will not be able to access certain app features. For instance, when interacting with the map, you will disable knowing your location in relation to your assets. You will also lose Google Map navigation features. Once you set this permission, you are presented with the login screen.

NOTE: To change the location permission in the future, you will need to access the app's permissions via the mobile operating system.

Controls

Login Controls

On the login display you have a text field for your user name and a password field for your password. Additionally, the Remember Me checkbox offers the convenience of having the system store your last login details, eliminating the need to re-enter your credentials every time.

The Target Line Server combobox control is one you will not worry about as it will point to Production where you will find your data. Staging is for test purposes. The Login button is what you press to login into the Overview system. You will be presented either with a Please Wait... or an Attention dialog depending on success or failure with your login. The Recover button provides a number to Overview Customer Support in the event of issues you cannot overcome.

NOTE: When selecting Remember Me checkbox, your password is not stored on the device but your last login token.

Two-Factor Authentication (2FA)

Two-Factor Authentication

The Overview System supports 2FA. This is configured via the Overview Web Portal. When enabled, the mobile application will present a 2FA challenge requesting the PIN associated with the authenticator app. Launch the authenticator app to find the PIN. Enter it into the PIN text field, and then press the Login button.

NOTE 1: If the Remember Me checkbox is selected on the initial login screen, then this challenge will only occur on the first login. It will only occur again when the login token has expired.

NOTE 2: At this time, only the Google Authenticator app is supported.

Map View

The map view provides an embedded Google Map control to visualize the location of tracked objects.

Google Map Controls

Map Controls

After successful login, the map will load your tracked objects. Once on the map, you will have a series of useful google map features plus some additional ones we created, discussed in the Managing Objects subsection below.

Map / Satellite Display

The map has the capability of changing between street view and satellite view. This is denoted in the second picture above. The third of the floating action button provides the toggle between these views. The application will remember your selection based on User Application Settings chosen.

Go to Current Location

The floating Compass button, located in the upper right-hand corner of the map for android and the lower right-hand corner for iOS, can quickly navigate the map camera to your mobile device's current location.

NOTE: This feature is disabled if you denied the Location permission discussed in First Time App Execution.

Getting Directions

On Android devices, you can get directions to a selected object.

When an object is selected on the map, a snackbar displaying the asset's name, number of contained assets, and address will appear at the bottom of the screen. Once that information is dismissed, you have the option to get directions to the selected object via Google Maps. The Google Map controls appear in the lower right-hand of the map with the option to get directions or open the location in Google Maps. Selecting the Directions button will open Google Maps allowing you to then get turn-by-turn directions to the object.

NOTE 1: This feature is disabled if you denied the Location permission discussed in First Time App Execution.

NOTE 2: You must have Google Maps installed to take full advantage of this feature.

Orientation

Orientation allows you to change what direction the map faces (typically due north) along with zooming in / out. This can all be accomplished via pinching, swiping, and twisting the orientation. You can also utilize the Compass button to re-orient to true north.

On Android devices, you also have the ability to utilize the Zoom In/Out buttons in the lower right hand side of the map.

NOTE: To enhance map performance, an efficient clustering mechanism is employed. A maximum of 250 active objects is supported on the map. If this limit is surpassed, objects are grouped together with visual indicators, that display the quantity of objects within that cluster. To view individual objects, simply zoom in, and the cluster will expand, revealing its contents.

Managing Objects

The following sub-sections explain the Map View and how to manage objects on the map.

*NOTE: You must have an appropriate user role to add, edit, or delete objects. *

Finding Objects

Finding Objects

To find objects on the map, you have several options. The first is going to your map home point via the Home button. This button provides you two options. The first option is the Home location, which can be navigated to by pressing the button, or long pressing the button and selecting Home from the dropdown. This will take you to the user's home location if it is set (this can be set via the web portal), or the customer's home location if the user's home location is not set. The second option is the Show All selection in the dropdown. This will zoom in/out so the map will show all of your assets in North America.

The second option for finding objects are the Filter Controls. These controls are at the bottom of the map. The dropdown filter provides a filter on different Asset Types to only show the objects of interest on the map. The Search text field can narrow down based on the name of the object and other associated data.

NOTE: When you select an object, a snackbar appears displaying the object name, number of contained assets, and address. This snackbar can be dismissed via a right-to-left swipe or will disappear after five seconds.

Creating Job Sites

Creating Job Sites

You have two ways of creating a Job Site. The first is to tap the Create Job Site button in the upper right-hand corner. This will open Create Job Site page where you must specify the Address or Latitude / Longitude text fields prior to saving the asset.

The second way is to long press where you want to create the job site on the map. This will bring up the Create Job Site dialog. Select Yes on this dialog and the Create Job Site page will open with the Latitude / Longitude fields populated with the location of the long press.

Assigning Unassigned Trackers

Assigning Unassigned Tags

Trackers are meant to be associated with assets. To quickly identify an unassigned tracker, select the Unassigned Trackers filter dropdown. From here the map will only reflect the unassigned trackers. Select the tracker of interest and tap the Info Window. The Associate Asset dialog appears with the option to select from existing assets or create a new asset via the Add Asset link.

Managing Container Objects

Managing Container Objects

Container objects (i.e. Warehouse, Job Site, Vehicle) contain a count of child assets associated with it. When this object type is selected, a management page is displayed. The page displays the container object's name in the Title bar and lists its child assets. From the Title bar, select the # icon to get a summary count of the child assets. Select the Pencil icon to open the Update [Type] page, where information about the parent container can be edited.

Managing Contained Assets

Managing Contained Assets

The contained assets (i.e. the children) are in a scrollable list of collapsed list items identifying the name of the asset. Selecting the asset will expand the summary information of the asset. This enables the Pencil (edit) and Trash Can (delete) icons. Tapping these icons will bring up the Update Asset page and Delete dialog respectively. The Envelope icon will bring up the Generate Email dialog to send an email about the container object with the child assets.

Assets View

The Assets View provides a paged control of all owned assets. Each page contains 50 assets in a scrollable list of collapsed list items. The list item will display the asset name, and when expanded, summary information about the asset.

NOTE: You must have an appropriate user role to add, edit, or delete assets.

Finding an Asset

Finding an Asset

There are several ways to find an asset. The first is via the page navigation. Each page of asset name list items is alphabetical. Navigation buttons are provided to advance to the first, next, previous, or last page. Selecting the X / Y page control allows for a specific page to be selected via the Select Page dialog.

To aide in navigating multiple pages of assets, utilize the Search text field. This will narrow down the number of assets shown. There is also a barcode scanner accessible via the Camera icon. Scanning the asset's barcode will quickly allow access to the asset.

Managing an Asset

Managing an Asset

Selecting an asset will enable the management controls for the asset. A long press of an asset will copy the asset's name to the system clipboard for pasting in another app. The enabled icons provide the following options:

1. Select the + icon to create a new asset via the Create TYPE page.
2. Select the Pencil icon to edit a selected asset via the Update TYPE page.
3. Select the Trash Can icon to delete an asset via the Delete Asset dialog.
4. Select the Map icon to show the asset on the Map View.
5. Select the Email icon to generate an email with a CSV attachment of all the asset information for a given page.

NOTE: If the selected asset is a child asset, it will instead show the asset's container on the Map View.

Menu View

The Menu View provides access to a list of one-off actions supported by the mobile application. These actions are closed via hitting an X icon in the left-hand side of the page. The sub-sections below describe the actions.

App Info and Support

App Info and Support

The About App option provides an About App dialog. This displays the mobile app version, information about what it does, and provides access to the EULAs of frameworks the app utilizes. The Support option will open up the Overview Customer Support website. Here you can find resources related to not only the mobile application, but the Overview system as a whole. The Exit option provides the ability to exit the application.

NOTE: The exit option is only valid on Android.

User Settings

User Settings

The User option brings up the settings for the user on the mobile application. It is a tabbed interface with the following options:

1. The Customer tab allows switching between customers and, if applicable, changing groups within the customer.
2. The Application tab provides the mobile app settings. App Locale allows different keyboard layouts. App Theme Mode will set the app to light, dark, or to the same as the mobile system theme. The Remember Map Type on App Restart checkbox allows the app to remember a preference for street or satellite map views.
3. The User tab displays user information and provides the ability to change your password.

Tag Locator

Tag Locator

The Tag Location action, when selected, brings up the Tag Locator page. This is a special view that works with a custom hardware device to find tags in close proximity in a small location (a.k.a. the map is no longer enough). The first page when accessed asks to plug in the Tag Sniffer hardware.

After plugging in the Tag Sniffer hardware, a challenge dialog is presented asking if it is OK for the mobile application to access the Tag Sniffer. Select the OK button. The Tag Locator page will begin displaying the tags detected by the Tag Sniffer hardware identifying their Id, dBm, and Vdc values. Data filtering options are available via the Tag Filter text field. Select the Email button to send a report of the detected tags.

NOTE: Tag Locator is only available on Android.

Accessibility

Mobile App v1.15.0 updated the application to take greater advantage of the accessibility features of the Android and iOS operating systems. This provides support for larger text and icons within the application.

NOTE: With the largest icon / text settings, the smallest supported mobile screen size is 480 x 800.

Display Settings

Display Settings

To validate this new capability, we utilized an emulated Nexus S with 480 x 800 screen dimensions. We then went under the display settings and maxed the Font size and Display size under the Display settings.

Login View

Login View

For the Login View we implemented a scrollable pane allowing access to all login options. We also ensured visibility of all necessary login control information.

Map View

Map View

On the map view we ensured all information for object selection and the information necessary per that selection are readable. A tradeoff was made on the filter controls where we have to cut-off text but make every effort possible to display the icon of the filter and the count information. The Search text field displays larger text not cutoff while still allowing use of the filter. Any selected object for updating has a scrollable pane with the relevant object information displayed.

Assets View

Assets View

Menu View

Menu View

The Menu View is fully readable when selected. The About App dialog is usable but will require a lot of scrolling. The Support page is accessible and readable. The User page still provides access to all setting options with scrollable panes where necessary. The tabs are cut-off slightly but still distinguishable.

Considerations

There are multiple phones with multiple Display settings. We made every effort necessary to test on a number of physical Android and iOS devices. There may arise a situation where at the max settings, something does not quite display right. You may need to back down a little bit on the "largeness" of your selection.

In any case, if there is a situation that arises where an update is necessary for you, please contact us identifying your phone type, mobile operating system, and mobile app feature you are accessing. Also when contacting customer support, screen shots are very helpful showing the issue.

Final Thoughts

Customer Feedback

The Logikos Overview team is here to help. Any customer feedback is welcome. You can provide this by leaving a review / suggestion in the Android or iOS app stores. You can also contact Customer Support via the customer support page to file tickets or make a phone call.

Future App Features

The following items are future considered app enhancements that we are currently exploring. Nothing in this list is a guarantee to be in a future release. We are just keeping looking for ways to enhance the mobile experience.

1. Tag Assignment Tool: A streamlined way of assigning tags with the mobile applications bar code scanner.
2. App Localization: We currently support CA - French, US - English, and US - Spanish keyboard characters. Research is underway in terms of translating all mobile application labels. This is highly involved as there is also the matter of the data and not just the labels.
3. Tablet Enhancements: We use collapsed list items to utilize the mobile screen real estate for assets. A greater assessment for tablets to expand controls is under consideration.