Warning
WARNING: The TrackAbout MetaWiki has been deprecated and is no longer being updated.

Please visit our new TrackAbout Knowledge Base at https://supportkb.trackabout.com for the most-up-to-date documentation on TrackAbout and TrackAbout Mobile.

Difference between revisions of "Smartphone App"

From TrackAbout MetaWiki
Jump to navigation Jump to search
m
(Major update and revamp of this whole page.)
Line 1: Line 1:
<translate>
 
 
{{TrackAbout Module
 
{{TrackAbout Module
 
|Module Description=TrackAbout's smartphone app for iOS and Android enables users to perform a variety of asset tracking operations.
 
|Module Description=TrackAbout's smartphone app for iOS and Android enables users to perform a variety of asset tracking operations.
Line 6: Line 5:
 
}}
 
}}
 
[[Category:TrackAbout Module]]
 
[[Category:TrackAbout Module]]
==Overview == <!--T:1-->
 
TrackAbout's smartphone app for iOS and Android enables users to perform a variety of asset tracking operations.
 
  
== Requirements == <!--T:2-->
+
==Overview ==
The app is intended only for existing customers of TrackAbout. Call your sales contact for more details.
+
The smartphone app is also known as TAMobile 7.
  
===Smartphone operating system requirements=== <!--T:3-->
+
==Hardware Purchasing Recommendations==
* [[Smartphone_App#iOS_Version_Support_Policy|iOS Version Support Policy (Apple)]]
+
See [[Smartphone Hardware Purchasing Recommendations]]
* [[Smartphone_App#Android_Version_Support_Policy|Android Version Support Policy]]
+
 +
== Features ==
  
== Features == <!--T:4-->
+
===Geolocation ===
 +
* Capture device GPS information during scanning.  This GPS data will be displayed in a map view on the website when reviewing Record details. Location Services should be enabled on the device.
 +
* See [[Smartphone Geolocation]]
  
===General === <!--T:5-->
+
=== Action Types Supported ===  
* Geolocation - capture device GPS information during scanning.  This GPS data will be displayed in a map view on the website when reviewing Record details. Location Services should be enabled on the device.
 
 
 
===Smartphone Compatible Actions === <!--T:6-->
 
 
* '''Add New/Register Asset''' - initialize new assets or edit existing assets in TrackAbout
 
* '''Add New/Register Asset''' - initialize new assets or edit existing assets in TrackAbout
 
* '''Add New/Register Container/Pallet''' - initialize new containers/pallets in TrackAbout
 
* '''Add New/Register Container/Pallet''' - initialize new containers/pallets in TrackAbout
Line 47: Line 44:
 
* '''Sort Trip Load (Picking)''' - prepare an order for delivery
 
* '''Sort Trip Load (Picking)''' - prepare an order for delivery
  
=== Follow On Tracking (FOT) Users === <!--T:8-->
+
=== Follow On Tracking (FOT) Action Types Supported ===  
 
The app supports several Follow-On Tracking mobile actions:
 
The app supports several Follow-On Tracking mobile actions:
*Asset Search - search for assets by tag and view asset details and history
+
*'''Asset Search''' - search for assets by tag and view asset details and history
*Move Asset - tracks customer movement of assets between their internal locations
+
*'''Move Asset''' - tracks customer movement of assets between their internal locations
*Record Weight/Volume - sets an asset volume or weight depending on asset type
+
*'''Record Weight/Volume''' - sets an asset volume or weight depending on asset type
 +
 
 +
== Provisioning the Smartphone Module ==
 +
The Smartphone module needs to be provisioned and enabled in your instance. Contact TrackAbout Sales for pricing and details.
 +
 
 +
Once provisioned, the Support Team will enable and configure the module for your instance.
  
== Setup == <!--T:9-->
+
== Roles, Permissions and User Setup for Smartphone ==
The Smartphone app needs to be enabled in your instance. Call your sales contact for more pricing and details.
+
#[[Mobile Roles|Mobile Roles Setup]]
#The Support Team will enable the Smartphone in your instance.
+
## Mobile Roles must be configured in your environment before the app can be used. The new role MUST have "Smartphone and Tablet" checked or selected.
#[[Mobile Roles|Mobile Roles Setup]]: Create and setup Mobile roles. Be sure to select the correct role purpose. The new role MUST select "Smartphone and Tablet"
 
 
#[[Internal Users|Setup Internal Users]]
 
#[[Internal Users|Setup Internal Users]]
##For each user requiring access, check the box '''TAMobile Android/iOS'''
+
##For each new smartphone user, check the box '''TAMobile Android/iOS'''
##Also assign the '''TAMobile Rugged and TAMobile Desktop''' role and save
+
##Also assign the '''TAMobile Rugged and TAMobile Desktop''' role and save the page.
  
 +
== Where To Download the App ==
 +
=== Apple iOS - App Store Download ===
 +
[[File:badge_appstore-lrg.png|link=https://itunes.apple.com/us/app/trackabout/id530125664]]
  
== Apple iOS Devices == <!--T:10-->
+
[https://itunes.apple.com/us/app/trackabout/id530125664 Click to see the TrackAbout app in the Apple App Store]
=== iOS App Download ===
 
[[File:badge_appstore-lrg.png|link=https://itunes.apple.com/us/app/trackabout/id530125664?mt=8&uo=4]]
 
  
====Can't Find TrackAbout using iPad?==== <!--T:11-->
+
====iPad Users - Can't Find TrackAbout in the App Store?====
 
On an iPad, when searching for "TrackAbout" in the App Store, TrackAbout may not appear in the search results. This is because the results are being filtered for iPad-only apps (as opposed to iPhone apps). TrackAbout is built as an iPhone app, but works on iPad.
 
On an iPad, when searching for "TrackAbout" in the App Store, TrackAbout may not appear in the search results. This is because the results are being filtered for iPad-only apps (as opposed to iPhone apps). TrackAbout is built as an iPhone app, but works on iPad.
  
Line 79: Line 81:
 
[[File:ipad3.JPG|400px]]
 
[[File:ipad3.JPG|400px]]
  
<!--T:12-->
 
 
Follow these steps on iPad:
 
Follow these steps on iPad:
 
* Launch the App Store
 
* Launch the App Store
Line 85: Line 86:
 
* In the top left, tap "iPad only" and select "iPhone only"
 
* In the top left, tap "iPad only" and select "iPhone only"
  
===iOS Version Support Policy=== <!--T:13-->
+
===Google Play Store - Android App Download===
''Updated June 28th, 2021. This policy is reviewed quarterly.''
 
 
 
====Supported iOS Versions==== <!--T:14-->
 
{{warning|Beginning January 1st 2022, TrackAbout will no longer provide updates of the iOS app for devices running iOS 12.x and lower and will no longer offer support with issues raised from devices running those old versions.}}
 
 
 
Current Policy:<br />
 
*iOS version 12.5 or higher, including iOS 13, iOS 14, iOS 15.
 
 
 
Devices with non-supported OS versions will cease to get new updates of TrackAbout from their respective stores. They will always be able to uninstall and reinstall the last supported version from the App Store, but TrackAbout will only support the current application release.
 
 
 
<!--T:15-->
 
See Apple's [https://support.apple.com/en-us/HT201685 support.apple.com: Find the software version] page
 
 
 
You may also find this page useful to see which devices can run which versions of iOS: https://iosref.com/ios
 
 
 
====Supported iPhones==== <!--T:16-->
 
* iPhone 12 series (12, 12 Pro, 12 Pro Max)
 
* iPhone 11 series (11, 11 Pro, 11 Pro Max)
 
* iPhone X series (X, XR, XS, XS Max)
 
* iPhone 8 series (8, 8 Plus)
 
* iPhone 7 series (7, 7 Plus)
 
* iPhone 6 series (6S, 6S Plus)
 
** Losing support Jan 2022: iPhone 6 and 6 Plus
 
* iPhone SE series (gen 1 and gen 2)
 
 
 
<!--T:17-->
 
See [http://support.apple.com/kb/HT3939 support.apple.com: Identifying iPhone Models]
 
 
 
====Supported iPads==== <!--T:18-->
 
NOTE: Non-cellular iPads (WiFi only) do not have a GPS chip and geolocation of assets and records may be inaccurate.
 
 
 
Consult the site https://iosref.com/ios
 
 
 
Any device that can run the supported versions of iOS listed above can be used.
 
 
 
<!--T:19-->
 
See [http://support.apple.com/kb/HT5452 support.apple.com: Identifying iPad Models]
 
 
 
<!--T:20-->
 
''The TrackAbout application will work on iPad, but the design is not currently optimized to take advantage of the larger tablet screen.''
 
 
 
====Supported iPod Touches==== <!--T:21-->
 
NOTE: iPod Touches do not have a GPS chip and geolocation of assets and records may be inaccurate.
 
* iPod Touch (7th generation)
 
 
 
<!--T:22-->
 
See [http://support.apple.com/kb/HT1353 support.apple.com: Identifying iPod Models]
 
 
 
====Support Policy Explained==== <!--T:23-->
 
 
 
<!--T:24-->
 
Apple releases new major versions of iOS (e.g. iOS 13 to iOS 14) each year. See [https://en.wikipedia.org/wiki/History_of_iOS Wikipedia History of iOS] for the exact schedule.
 
 
 
<!--T:25-->
 
TrackAbout must choose how far back to support major versions of iOS. As time passes, it becomes increasingly expensive and eventually impossible to continue supporting apps on old versions of iOS. Apple forces the hand of developers by dropping support for older versions of iOS from their developer tools.
 
 
 
<!--T:26-->
 
iPhones and iPads are consumer technology, and the pace of change in the consumer space is rapid. Whereas rugged enterprise devices are typically expected to have a useful service life of 5 years, consumer technology generally has a life-span of 2-3 years.
 
 
 
<!--T:27-->
 
TrackAbout is sensitive to the needs of its customers and does not wish to unduly prohibit use of the app by paying customers who haven't yet or cannot update their devices to the latest version of iOS.
 
 
 
<!--T:28-->
 
Therefore, TrackAbout's iOS Version Support Policy balances these competing realities by:<br/>
 
* Supporting the last two major releases (back to the most recent dot version of the older OS). For example, if iOS 11.3 is the latest version, TrackAbout supports iOS 11.X and iOS 10.3, which was the highest version in the 10.x series.
 
* Prompting users periodically to upgrade from within the TrackAbout app when a newer iOS version is available.
 
* Increasing TrackAbout's minimum requirements 6 months after Apple releases a new OS. New versions of iOS typically reach greater than 80% adoption within 6 months of release.
 
 
 
== Android Devices == <!--T:29-->
 
===Android App Download===
 
Download from the Google Play Store
 
 
 
 
[[File:android_app_on_google_play.png|link=https://play.google.com/store/apps/details?id=com.trackabout.mono]]
 
[[File:android_app_on_google_play.png|link=https://play.google.com/store/apps/details?id=com.trackabout.mono]]
  
===Android Version Support Policy=== <!--T:30-->
+
[https://play.google.com/store/apps/details?id=com.trackabout.mono Click to see the TrackAbout app in the Google Play Store]
''Updated June 28th, 2021. This policy is reviewed quarterly.''
 
 
 
====Operating System==== <!--T:31-->
 
 
 
Currently Supporting:
 
* Android version 5.1 or higher
 
Devices with non-supported OS versions will cease to get new updates of TrackAbout from their respective stores. They will always be able to uninstall and reinstall the last supported version from stores, but TrackAbout will only support the current application release.<br>
 
<!--T:32-->
 
See [http://www.wikihow.com/Check-What-Android-Version-You-Have How to check what Android version you have]
 
 
 
====Hardware requirements==== <!--T:33-->
 
* A rear-facing camera with 2 megapixels or greater
 
* Minimum 1 GB RAM
 
* Bluetooth (for printing)
 
 
 
===Choosing an Android Device=== <!--T:34-->
 
There are a great many consumer-grade Android devices on the market at all price points. TrackAbout does not recommend specific models. So how do you choose? Here's what's important:
 
 
 
;Android OS Version
 
:You '''must''' make sure the device meets TrackAbout's requirements (above) for minimum OS version. The higher the version number, the better. Plan for at least 3 years of OS updates, and understand that TrackAbout will drop support for older versions of the Android OS at least annually.
 
 
 
<!--T:35-->
 
;Monthly Android OS Security Updates
 
:Google releases monthly operating system security patches. It's important for your security and the security of your company that you choose a phone that will receive these updates. Bargain devices tend to not receive the updates. Some carrier-sold devices do not regularly receive updates. Devices sold directly by Google in their Store will always receive timely updates. Flagship devices like the Samsung Galaxy series sold by network carriers will likely receive updates. Ask when buying or do some research to find out.
 
 
 
<!--T:36-->
 
;CPU + Camera
 
:Scanning QR and barcodes using the smartphone's camera requires a powerful CPU. A bargain phone will likely have a poor camera and a sub-par CPU. Most mid-tier devices made in 2017 and later will probably have acceptable camera and CPU performance, but you should buy one phone and test it, and return it if it doesn't perform well enough. Compare the performance to a high-end Android or iPhone running TrackAbout.
 
 
 
<!--T:37-->
 
;Battery
 
:Most Android devices get 3 to 4 hours of screen on time (SoT) under typical usage scenarios before needing a recharge. Barcode scanning makes heavy use of the camera to take rapid images of the target barcodes. Those images are fed to the CPU for image recognition processing (finding the barcodes). Barcode scanning can therefore drain a battery faster. Opt for a phone with an over-sized battery when possible. A phone with replaceable batteries could be a good choice, or provide workers with car chargers or portable battery recharge packs for use in the field so they can keep going all day. Be aware of Quick Charge technology and buy compliant Quick Charge chargers.
 
 
 
<!--T:38-->
 
;Buy One and Test
 
:What kind of environment are your workers in? Outdoors? Indoors in low-light? Some cameras do not perform well in low-light, they may have auto-focus problems which impacts scanning. It's important that you try out a phone in your environment before purchasing in quantity.
 
 
 
<!--T:39-->
 
;Safe Bets
 
:The current generation Samsung Galaxy devices are typically safe bets because they meet all the above criteria. They are flagship (top of the line) products with great specs and a great camera, which makes for excellent scanning.
 
:Devices sold directly in the [https://store.google.com/category/phones Google Store] are generally safe bets, although as of this writing (April 2017) they tend to be expensive, flagship devices.
 
:TrackAbout does not routinely test Android devices, so we can't make other more specific recommendations here.
 
 
 
<!--T:40-->
 
;Supported Rugged Android Devices
 
See the list of certified devices on the [[TrackAbout_Certified_Devices#Featured_Rugged_Android_Devices|Featured Rugged Android Devices]] section of the Certified Devices wiki page.
 
  
<!--T:41-->
+
===TrackAbout APK Download Site===
;Known-Bad Devices
+
For those customers deploying the TrackAbout app using a Mobile Device Management solution, you can download [https://apkshare.z20.web.core.windows.net/ the latest version of the Android app from this site].
:Samsung Galaxy Note 4 - Our test device had severe camera auto-focus problems that made scanning very frustrating. There are [https://www.google.com/search?q=note+4+autofocus+fix widely reported problems with auto-focus on the Note 4]. We attempted modifying "Metering Modes" under camera settings, trying Matrix or Spot settings, but it did not help.
 
  
<!--T:42-->
+
== In-App Settings ==
;Useful Service Life
 
:Consumer-grade smartphones have a useful service life of about 2 years. After 2 years, one of two things will happen. (1) The battery will age and fail to hold a reasonable charge. Batteries can sometimes be replaced, but it may not be cost-effective. (2) The device will no longer receive security updates. In either case, the device should be replaced.
 
:Rugged-grade Android devices may have a longer service life of 4-5 years. However, they will likely not receive security updates.
 
 
 
===Android Support Policy Explained=== <!--T:43-->
 
See [http://en.wikipedia.org/wiki/Android_version_history Wikipedia's Android Version History] for detailed timeline of Android's version history.
 
 
 
<!--T:44-->
 
Google increments the '''major version number''' of Android (e.g. Android 7.0 to Android 8.0) once a year.
 
 
 
<!--T:45-->
 
Google increments the '''minor version number''' of Android (e.g. 7.0 to 7.1) occasionally. and with no set schedule. Google does issue monthly security patches that typically don't change the minor version number. However, not all phone manufacturers or cell phone carriers deliver the Google security updates monthly, if at all.
 
 
 
<!--T:46-->
 
Google has an unwritten policy that states that its manufacturers ''should'' provide Android updates up to 18 months from a device's introduction date. However, manufacturers are not required to not follow this policy.
 
 
 
<!--T:47-->
 
Different device manufacturers (Samsung, HTC, LG, etc) update their devices at different speeds. Traditionally, manufacturers have been slow to update devices, and have been known to abandon specific devices before 18 months have elapsed. This leads to a large number of simultaneously active versions of Android in the wild.
 
 
 
<!--T:48-->
 
Android phones and tablets are generally a consumer technology, and the pace of change in the consumer space is rapid. Whereas rugged enterprise devices are typically expected to have a useful service life of 4-5 years, consumer technology generally has a life-span of 2 years.
 
 
 
<!--T:49-->
 
There are a rugged Android devices available, and the version of Android OS installed on rugged devices tends to lag behind the latest consumer devices.
 
 
 
<!--T:50-->
 
TrackAbout is sensitive to the needs of its customers and does not wish to unduly prohibit use of the app by paying customers who haven't yet or cannot update their devices to the latest version of Android. On the other hand, supporting so many different versions of the Android operating system adds complexity and maintenance costs to the software development process.
 
 
 
<!--T:51-->
 
TrackAbout's Android Version Support Policy balances the competing realities by:
 
* Supporting Android versions that have 10% or greater market share according to [https://developer.android.com/about/dashboards/index.html Google's monthly statistics].
 
* Supporting rugged Android devices on a case-by-case basis and for as long as we reasonably can. Rugged device Android versions tend to lag consumer device versions and do not generally receive updates. It has been our experience that Android software development tools change to keep up with the latest versions of the OS, and sometimes we do not have a choice to support older operating systems. This can make it prohibitively expensive to support older versions of Android.
 
 
 
== App Settings == <!--T:52-->
 
 
[[File:TrackAbout App Settings Screen.jpeg|thumbnail|right]]
 
[[File:TrackAbout App Settings Screen.jpeg|thumbnail|right]]
 
On the main screen of the app tap "Settings"
 
On the main screen of the app tap "Settings"
Line 254: Line 102:
 
::For test environment (test.trackabout.com), select: <code>Test</code>
 
::For test environment (test.trackabout.com), select: <code>Test</code>
  
<!--T:53-->
 
 
;Feedback
 
;Feedback
 
:If your device allows vibration you can choose to enable or disable this setting.
 
:If your device allows vibration you can choose to enable or disable this setting.
  
<!--T:54-->
 
 
;About
 
;About
:Make sure that you have the latest version of the app downloaded from the iTunes or Google Play stores depending on your device.  Updating to the latest version of the app may resolve any issues or problems you may be experiencing with the app.
+
:Make sure that you have the latest version of the app downloaded from the Apple App Store or Google Play stores depending on your device.  Updating to the latest version of the app may resolve any issues or problems you may be experiencing with the app.
 
 
==FAQ== <!--T:55-->
 
=== Searching in the TAM7 app ===
 
There are many screens in the TAM7 app in which we try to assist the user in finding the option they're looking for. 
 
  
 +
==Smartphone Vendor-Specific Help==
 +
See the page [[Smartphone Vendor-Specific Help]] for notes about configuring smartphone devices from specific hardware vendors.
  
Here's the logic build into the dynamic search functionality in TAM7:  
+
==Things To Know about the Smartphone App==
 +
=== Searching within Lists ===
 +
Several screens contain long lists of information. When a search box is offered, here's how it works:
  
* If there are 200 items or less, we show them on the screen when it loads. Otherwise you have to search to get results
+
* If there are 200 items or less, we show them all.
* A dynamic search starts once you have 2 or more characters typed
+
* If there are more than 200 items in the list, you have to search to get results
* The way search suggestions are displayed can differ per data type, but the general logic is:
+
* The search starts after typing 2 or more characters
 +
* The way results are displayed can differ by type of data, but the general logic is:
 
** Search results contain all items whose Name (and sometimes Description) are contained in the search terms. We also do a fuzzy match, so if the letters of the search terms appear in order, we match that. OX100 would match "Oxygen 100". OX100 would also match "One Box of 10 screws and 50 bolts" (because O X 1 0 0 shows up in that order in that phrase).
 
** Search results contain all items whose Name (and sometimes Description) are contained in the search terms. We also do a fuzzy match, so if the letters of the search terms appear in order, we match that. OX100 would match "Oxygen 100". OX100 would also match "One Box of 10 screws and 50 bolts" (because O X 1 0 0 shows up in that order in that phrase).
** First, we show items whose Number ("MId" in teckie terms) starts with the search term, sorted alphabetically. These are things like Customer Number, Location ID, Product Code Name.  
+
** First, we show items whose Number ("MId" in techie terms) starts with the search term, sorted alphabetically. These are things like Customer Number, Location ID, Product Code Name.  
 
** Then we show items with display names (Customer Name, Location Name, etc) that contain the search term, sorted alphabetically.
 
** Then we show items with display names (Customer Name, Location Name, etc) that contain the search term, sorted alphabetically.
  
=== Offline Mode ===  
+
=== Offline Mode ===
The App handles off-line connectivity transparently. If the App does not have WiFi or cellular access, it saves the record(s) until the device is back online. The user will notice an App notification that unsaved records are saved locally until they can be pushed. Once the device is back on-line, the Apps retries automatically and saves the records without any user intervention.
+
Field workers often lose network connectivity due to lack of signal. The app handles this transparently to the user.
 
 
=== Hardware scanning: Zebra TC55, TC56 and similar devices === <!--T:56-->
 
 
 
==== Data Wedge Setup ==== <!--T:57-->
 
In order for the hardware scanner to function in the TrackAbout app, the program DataWedge needs to be configured.
 
Steps:
 
* Ensure TrackAbout app is installed
 
* Open DataWedge
 
* Click the menu button a (third button on the bottom on the phone, next to Home)
 
* Choose "New profile"
 
* Enter "TrackAbout" and press OK
 
* Tap on the TrackAbout entry
 
* Set the following settings:
 
** Profile enabled: checked
 
** Associated apps: click and press the menu button, then "New app/activity". Select com.trackabout.mono (look for the TrackAbout icon), then select the first item, *
 
** Enabled under Barcode Input: checked
 
** Scan Params (Possibly under Scanner Configuration) - Decode Audio Feedback: Silent (it may read Silent, go in and set it to Silent or None again)
 
** Scan Params (Possibly under Scanner Configuration) - Decode Haptic Feedback: unchecked
 
** Enabled under Keystroke Output: unchecked
 
** Enabled under Intent Output: checked
 
** Intent action: com.trackabout.motoscan
 
** Intent category: scan
 
** Intent delivery: Broadcast intent
 
** Enabled under IP Output: unchecked
 
 
 
Once the Data Wedge profile has been configured, the TAM7 app needs to be configured to use the hardware scanner. To do this, see: [[#Enabling_the_hardware_barcode_scanner_in_the_TrackAbout_app|Enabling the hardware barcode scanner in the TrackAbout app]]
 
 
 
=== Hardware scanning: Honeywell EDA50 and similar devices === <!--T:56-->
 
 
 
==== Data Wedge Setup ====
 
In order for the hardware scanner to function in the TrackAbout app, the program DataWedge needs to be configured.
 
Steps:
 
* Ensure TrackAbout app is installed
 
* Open Settings, then Click on Scan Settings.
 
* Click on Internal Scanner
 
* Click the "+" icon at the top left of the screen to add a new profile.
 
* In the Add Profile screen that comes up, click on "Select an Application". Select TrackAbout from the list.
 
* A new entry called "TrackAbout Profile" will be created. Click on that entry.
 
* Click on "Data Processing Settings"
 
* Uncheck the checkboxes for Launch Browser, Scan to Intent, and Launch EZ Config.
 
* Check the Data Intent checkbox
 
* Click on Data Intent
 
* Click on Action, and type in "com.trackabout.scanwedge" , and click Ok.
 
* Click on Category, and type in "TrackAboutScan", and click Ok.
 
* Exit from Settings.
 
*
 
* Now open and log into the TrackAbout app.
 
* Go to Settings from the left menu.
 
* Click on Data Wedge settings
 
* Click on Intent Data Key, and type in "data"
 
* The Intent Name and Intent Category should already be set to "com.trackabout.scanwedge", and "TrackAboutScan"
 
* Click on Done.
 
* Click "Check barcode scanning" under "Scan Check"
 
* When you see "Use this screen to test the scanning capability of your device," scan a barcode using the hardware scanner (don't select orange scan box to bring up camera). The barcode scanned will appear on the screen.
 
* Click back and a new option appears, "Preferred Scan Method".
 
* Ensure "Preferred Scan Method" is set to "Hardware (Internal)"
 
 
 
=== Hardware scanning: Urovo i6310 and similar devices ===
 
 
 
==== Data Wedge Setup ====
 
In order for the hardware scanner to function in the TrackAbout app, the factory-installed Scanner program needs to be configured.
 
Steps:
 
* Ensure the TrackAbout application is installed.
 
* Open the Scanner application and tap the Gear icon to open Scanner Settings.
 
* Under "Keyboard output mode", uncheck "output the barcode into the focused edit box".
 
* Make a note of the "Intent action" value. At the time of this writing, it is "android.intent.ACTION_DECODE_DATA".
 
* Make a note of the "Intent string extra" value. At the time of this writing, it is "barcode_string".
 
* Now open and log into the TrackAbout application.
 
* Go to Settings from the left menu.  
 
* Tap on Data Wedge settings.
 
* Tap on Intent Name and enter the "Intent action" value noted above.
 
* Tap on Intent Data Key and enter the "Intent string extra" value noted above.
 
* The Intent Category does not need to change.
 
* Tap on Done.
 
* Tap "Check barcode scanning" under "Scan Check"
 
* When you see "Use this screen to test the scanning capability of your device," scan a barcode using the hardware scanner (don't select orange scan box to bring up camera). The barcode scanned will appear on the screen.
 
* Tap "Back" and a new option appears, "Preferred Scan Method".
 
* Ensure "Preferred Scan Method" is set to "Hardware (Internal)"
 
 
 
====Troubleshooting DataWedge====
 
  
'''Issue:''' DataWedge Demo app appears when scanning in some screens in TAM7
+
If the app does not have network connectivity, it saves records locally until the device is back online. The user will be shown a notification that unsaved records are being retained locally.
  
'''Solution:''' Remove TAM7 associations from the DataWedge Demo profile
+
Once the device is back online, the app sends data automatically without user intervention.
* Tap the menu button in the demo app (three dots on the bottom right hand side of the screen)
 
* Choose Settings
 
* Tap on Associated Apps
 
* Tap and hold to delete any app that says TrackAbout
 
* Return to TAM7 and try scanning again
 
  
=== Hardware scanning: Cognex MX-1000 and MX-1502 devices ===  
+
=== Enabling Integrated Scanning Hardware ===  
* Make sure the Cognex device is on the latest firmware and configured to scan for either iOS or Android. Please consult your Cognex vendor and device documentation.
+
Some rugged devices have dedicated, integrated scanning hardware. Enabling these is usually a two-step process.
* If using Android, install the Cognex MX helper app on [https://itunes.apple.com/us/app/cognex-quick-setup/id978679507?mt=8 Google Play]
 
  
If scanning stops working, swipe away the TrackAbout app and try again. If that does not work, restart the smartphone device.
+
Step 1 is to configure the scanning hardware using the vendor's built-in app. See [[Smartphone Vendor-Specific Help]] for details
  
=== Hardware scanning: Zebra TC20 / RFD2000 and RFD8500 devices ===
+
Step 2 is to teach the app that a dedicated scanner should be used instead of using the built-in camera for scanning.
* Make sure the device(s) are using the latest OS and/or firmware. Please consult your Zebra vendor and device documentation.
 
* Consult your Zebra vendor and device documentation to connect with and test your device using the applicable Zebra scanning application.
 
* If you're using the TC20, please follow the Data Wedge Setup section above.
 
  
=== Enabling the hardware barcode scanner in the TrackAbout app === <!--T:58-->
+
The user must do a "Scan Check" and use the hardware scanner successfully. These are the steps.
We use a passive check to determine if a hardware barcode scanner is available on the device. The user has to do a "Scan Check" and use the hardware scanner successfully.
+
* Log into the TrackAbout app
* Log into TrackAbout
 
 
* Go to Settings
 
* Go to Settings
 
* Click "Check barcode scanning" under 'Scan Check'
 
* Click "Check barcode scanning" under 'Scan Check'
Line 389: Line 146:
  
 
=== Enabling the hardware RFID scanner in the TrackAbout app ===
 
=== Enabling the hardware RFID scanner in the TrackAbout app ===
* TrackAbout has to first enable RFID functionality
+
* Log into the TrackAbout app
* Log into TrackAbout
 
 
* Go to Settings
 
* Go to Settings
 
* Click "RFID settings"
 
* Click "RFID settings"
Line 398: Line 154:
 
* If your device also has an integrated hardware barcode scanner please ensure you follow the steps above to setup the hardware barcode scanner as well
 
* If your device also has an integrated hardware barcode scanner please ensure you follow the steps above to setup the hardware barcode scanner as well
  
===Upgrade Nag=== <!--T:59-->
+
===App Upgrade Reminder===  
Once a new version of the App has been released to the stores, the App will prompt users to upgrade. One week after release to the app stores, users will receive a message once a day reminding them to upgrade.
+
When a new version of the app is published in the app stores, the TrackAbout app will prompt users to upgrade.
  
===Session Duration=== <!--T:60-->
+
One week after release, users will receive a message once every day reminding them to upgrade.
Once logged into the iOS or Android application, the user can remained logged in for 30 days without logging in again.  After 30 days the user will be logged out and asked to re-enter their credentials.
 
  
===Printing with TAMobile 7 ===
+
We always encourage ensuring users are using the very latest version of the app.
  
Customers using TrackAbout's POD can pair their devices with a TrackAbout certified printer.  Check our [[TrackAbout_Certified_Devices#Proof_of_Delivery_Receipt_-_Mobile_Printers|Certified devices page]] to see what printers can be used and contact support@trackabout.com to get set up.
+
===Login Session Duration===
 +
Users will remain logged in for 30 days.
  
== Tips & Tricks == <!--T:61-->
+
After 30 days, the user will be logged out and asked to re-enter their credentials.
===iOS===
 
==== Screen capture====
 
* To capture screen in iOS device, hold the '''Home''' and '''Power''' buttons simultaneously. The snapshot will be saved in the Pictures.
 
  
===Android=== <!--T:62-->
+
=== Printing ===
==== Screen capture====
+
Customers using TrackAbout's POD can pair their devices with a TrackAbout certified printer.  Check our [[TrackAbout_Certified_Devices#Proof_of_Delivery_Receipt_-_Mobile_Printers|certified devices page]] to see which printers are supported and contact support@trackabout.com to get set up.
Screen capture depends on the device manufacture
 
* Samsung Galaxy S3: Press and hold the Power button and the Home button at the same time
 
* Most others: Simultaneously press Volume Down + Power for 1 second
 
</translate>
 

Revision as of 10:39, 1 October 2021


TrackAbout Module
Module Name: Smartphone App
Short Description TrackAbout's smartphone app for iOS and Android enables users to perform a variety of asset tracking operations.
Supported In: TAMobile Android, TAMobile iOS
Business Process: Asset Management, Production, Distribution, Supply Chain
← Back to list

Overview

The smartphone app is also known as TAMobile 7.

Hardware Purchasing Recommendations

See Smartphone Hardware Purchasing Recommendations

Features

Geolocation

  • Capture device GPS information during scanning. This GPS data will be displayed in a map view on the website when reviewing Record details. Location Services should be enabled on the device.
  • See Smartphone Geolocation

Action Types Supported

  • Add New/Register Asset - initialize new assets or edit existing assets in TrackAbout
  • Add New/Register Container/Pallet - initialize new containers/pallets in TrackAbout
  • Add New/Register Bulk Tank - initialize new bulk tanks in TrackAbout
  • Asset Search - search for assets by tag and view asset details and history
  • Collect Many Signatures/Sign Later - allows collecting signatures for multiple deliveries to the same location at once, after the last delivery.
  • Create Order - order creation, with the ability to add line items to the order by scanning existing assets (to look up their product code)
  • Customer Audit - count all assets found on customer premise
  • Delivery - delivery of assets, including not-scanned and hard good/consumable support
  • Dynamic forms - collect custom data on any record*
  • Fill - record the filling of assets
  • Find Inventory - lookup assets on the go by product code or location
  • Generic Action - part of the Dynamic Workflow module, this action allows clients to create custom workflows
  • Load and Unload Truck - track assets loaded onto and unload off trucks, including not-scanned and hard good/consumable support
  • Locate - set location of assets to internal branch locations
  • Maintenance - record maintenance on assets
  • Move Asset - part of the Follow On Tracking, allows customer users to move assets between FOT locations
  • Receive from Vendor - record assets obtained from a vendor
  • Reclassify Assets - change service of assets
  • Replace Barcode - replace worn or missing barcodes while retaining asset history and traceability
  • Reserve for Order - assign specific assets to an order
  • Return Assets - similar to Delivery action, but allows returns only
  • Set Volume - part of the Follow On Tracking, allows customer users to set assets' volume
  • Sort Container/Build Pallet - add assets to a container/pallet in preparation for Filling, Delivery, Maintenance and Interbranch Transfer
  • Sort Trip Load (Picking) - prepare an order for delivery

Follow On Tracking (FOT) Action Types Supported

The app supports several Follow-On Tracking mobile actions:

  • Asset Search - search for assets by tag and view asset details and history
  • Move Asset - tracks customer movement of assets between their internal locations
  • Record Weight/Volume - sets an asset volume or weight depending on asset type

Provisioning the Smartphone Module

The Smartphone module needs to be provisioned and enabled in your instance. Contact TrackAbout Sales for pricing and details.

Once provisioned, the Support Team will enable and configure the module for your instance.

Roles, Permissions and User Setup for Smartphone

  1. Mobile Roles Setup
    1. Mobile Roles must be configured in your environment before the app can be used. The new role MUST have "Smartphone and Tablet" checked or selected.
  2. Setup Internal Users
    1. For each new smartphone user, check the box TAMobile Android/iOS
    2. Also assign the TAMobile Rugged and TAMobile Desktop role and save the page.

Where To Download the App

Apple iOS - App Store Download

Badge appstore-lrg.png

Click to see the TrackAbout app in the Apple App Store

iPad Users - Can't Find TrackAbout in the App Store?

On an iPad, when searching for "TrackAbout" in the App Store, TrackAbout may not appear in the search results. This is because the results are being filtered for iPad-only apps (as opposed to iPhone apps). TrackAbout is built as an iPhone app, but works on iPad.

You must search specifically for iPhone applications from iPad to find the TrackAbout application (pictured below)

Click the Toggle in the upper right hand corner to change to include iPhone applications in the search

Ipad1.JPG

Ipad2.JPG

Ipad3.JPG

Follow these steps on iPad:

  • Launch the App Store
  • Search for "TrackAbout"
  • In the top left, tap "iPad only" and select "iPhone only"

Google Play Store - Android App Download

Android app on google play.png

Click to see the TrackAbout app in the Google Play Store

TrackAbout APK Download Site

For those customers deploying the TrackAbout app using a Mobile Device Management solution, you can download the latest version of the Android app from this site.

In-App Settings

TrackAbout App Settings Screen.jpeg

On the main screen of the app tap "Settings"

Server
Environment
For production environment (www.trackabout.com), select: Production
For test environment (test.trackabout.com), select: Test
Feedback
If your device allows vibration you can choose to enable or disable this setting.
About
Make sure that you have the latest version of the app downloaded from the Apple App Store or Google Play stores depending on your device. Updating to the latest version of the app may resolve any issues or problems you may be experiencing with the app.

Smartphone Vendor-Specific Help

See the page Smartphone Vendor-Specific Help for notes about configuring smartphone devices from specific hardware vendors.

Things To Know about the Smartphone App

Searching within Lists

Several screens contain long lists of information. When a search box is offered, here's how it works:

  • If there are 200 items or less, we show them all.
  • If there are more than 200 items in the list, you have to search to get results
  • The search starts after typing 2 or more characters
  • The way results are displayed can differ by type of data, but the general logic is:
    • Search results contain all items whose Name (and sometimes Description) are contained in the search terms. We also do a fuzzy match, so if the letters of the search terms appear in order, we match that. OX100 would match "Oxygen 100". OX100 would also match "One Box of 10 screws and 50 bolts" (because O X 1 0 0 shows up in that order in that phrase).
    • First, we show items whose Number ("MId" in techie terms) starts with the search term, sorted alphabetically. These are things like Customer Number, Location ID, Product Code Name.
    • Then we show items with display names (Customer Name, Location Name, etc) that contain the search term, sorted alphabetically.

Offline Mode

Field workers often lose network connectivity due to lack of signal. The app handles this transparently to the user.

If the app does not have network connectivity, it saves records locally until the device is back online. The user will be shown a notification that unsaved records are being retained locally.

Once the device is back online, the app sends data automatically without user intervention.

Enabling Integrated Scanning Hardware

Some rugged devices have dedicated, integrated scanning hardware. Enabling these is usually a two-step process.

Step 1 is to configure the scanning hardware using the vendor's built-in app. See Smartphone Vendor-Specific Help for details

Step 2 is to teach the app that a dedicated scanner should be used instead of using the built-in camera for scanning.

The user must do a "Scan Check" and use the hardware scanner successfully. These are the steps.

  • Log into the TrackAbout app
  • Go to Settings
  • Click "Check barcode scanning" under 'Scan Check'
  • When you see "Use this screen to test the scanning capability of your device," scan a barcode using the hardware scanner (don't select orange scan box to bring up camera). The barcode scanned will appear on the screen.
  • Click back and a new option appears, "Preferred Scan Method".
  • Ensure "Preferred Scan Method" is set to "Hardware Scanner"

Enabling the hardware RFID scanner in the TrackAbout app

  • Log into the TrackAbout app
  • Go to Settings
  • Click "RFID settings"
  • Click "RFID device"
  • Select your RFID device from the list and click on "Save"
  • Test scanning an RFID tag, and set the global power level
  • If your device also has an integrated hardware barcode scanner please ensure you follow the steps above to setup the hardware barcode scanner as well

App Upgrade Reminder

When a new version of the app is published in the app stores, the TrackAbout app will prompt users to upgrade.

One week after release, users will receive a message once every day reminding them to upgrade.

We always encourage ensuring users are using the very latest version of the app.

Login Session Duration

Users will remain logged in for 30 days.

After 30 days, the user will be logged out and asked to re-enter their credentials.

Printing

Customers using TrackAbout's POD can pair their devices with a TrackAbout certified printer. Check our certified devices page to see which printers are supported and contact support@trackabout.com to get set up.