Services Portal 2.7 Release Notes

These release notes describe the new features and enhancements for Services Portal applications (QTRACS, Performance Monitoring, Trailer Tracks, Fleet Mapping, GeoServices, and Administration) in Services Portal 2.7, which released in the U.S. in the fall of 2015.

For previous release notes, click here.

System Requirements and Upgrade Information

Supported browsers

Services Portal applications (QTRACS, Performance Monitoring, Trailer Tracks, Fleet Mapping, GeoServices, and Administration) are supported fully on Microsoft Internet Explorer versions 8, 9, 10, and 11. You may experience minor display issues in MSIE 8.

Firefox and Chrome are tested and supported.

No other Internet browsers are tested.

Ensure your browser loads the newest version of the Services Portal

It is highly recommended that you clear temporary Internet files before you log in for the first time after the upgrade. Press Ctrl+Shift+Delete to open your browser’s history control panel then check the box for temporary internet files or caches. Click delete or clear to confirm your choice then close and reopen your browser. This will ensure your browser is loading the newest version of the Services Portal pages. For more information about this process, including browser specific instructions, see Omnitracs’ quick reference card on the subject.

Trailer Mileage Reporting

Services Portal 2.7 includes Trailer Mileage Reporting, a future enhancement to Trailer Tracks that is currently not supported and only in beta testing. Trailer Mileage Reporting allows fleets to track the distance a trailer travels as long as it is connected to 7-way power. A new mileage counter is include in status messages from the TT210. Fleets can track and reset the mileage counter as needed.

Trailer Mileage Reporting Management

Trailer Mileage Reporting is disabled by default but can be enabled from the Trailer Tracks company settings page. Trailer Mileage Reporting can only be enabled by users with the “Can maintain Trailer Tracks company settings” capability and cannot be enabled or disabled by web services. Every time Trailer Mileage Reporting is enabled or disabled a message is sent to all untethered trailers in the fleet, regardless of firmware version.

Trailer Mileage Counter

If Trailer Mileage Reporting is disabled the trailer mileage counter (TMC) is hidden in the UI. When enabled, the TMC is displayed in miles or kilometers based on company preference and is shown on the trailer details status and history tabs, the event history page, the event history query page, and in the trailer details and event history CSV reports. The TMC has a cap of 2,668,769 miles or 4,294,967,965 meters. Once the TMC reaches its cap, it rolls over to 0.

Configuration

The TMC can be reset from the Trailer Tracks host application and a new value can be pushed out to the TT210 to cause it to begin accumulating from the new value. TMC reset values are sent immediately to the TT210. The Trailer Tracks application maintains an audit trail of all resets made from the host application. The audit trail is accessible from the mileage tab on the trailer details page. The TMC can be reset from the mileage tab on the settings page in the trailer directory. This tab is only visible if Trailer Mileage Reporting is enabled.

Alerts

You can set thresholds and receive alerts when the TMC exceeds this threshold. Thresholds and alert recipients can be set in the mileage tab on the Trailer Details page or in the monitoring plan. This new alert operates the same way as other Trailer Tracks alerts.

Integration

Web Services

Four new web services allow integrators to utilize Trailer Mileage Reporting:

Name Web Service Function
Get Mileage Counter getMileageCounter Get a current reading from the TMC and the timestamp for the reading
Set Mileage Counter setMileageCounter Reset the TMC to 0 or a user defined value
Get Trailer Mileage Threshold getTrailerMileageThreshold Retrieve the current threshold settings including whether the threshold is enabled or disabled, the current threshold value, and a list of email addresses to receive alerts when the threshold is exceeded
Set Trailer Mileage Threshold setTrailerMileageThreshold Used to enable or disable a threshold, set the mileage threshold, and identify email addresses to be notified if the threshold is exceeded

For more information visit the Trailer Management page on the Services Portal Integration Developer’s wiki at: https://intinfo.omnitracs.com/display/iWebInt/Trailer+Management

Event Subscription Services

The following ESS transactions now also include the TMC when generated by a TT210 device with the appropriate firmware:

Transaction Type Name
T.1.02.0 Cargo Event Notifications
T.1.03.0 Door Event Notifications
T.1.04.0 Auxiliary Sensor Event Notifications
T.1.05.0 Battery Event Notifications
T.1.06.0 Geofence Event Notifications
T.1.07.0 Status Reports
T.1.12.0 Trailer Trip Reporting Events
T.1.13.0 Trailer External Power Events
T.1.14.0 Reefer Trailer OEM Alarm Events
T.1.15.0 Reefer Trailer Temperature Events
T.1.16.0 Reefer Trailer Set Point Events
T.1.17.0 Reefer Trailer Low Fuel Events

These transactions now include two new elements if Trailer Mileage Reporting is enabled for the fleet and the mobile device has firmware that supports Trailer Mileage Reporting.

Element Type Length Format Description
Mileage Counter Char 9 nnnnnnn.n Counter value in miles or km (based on company's preference)
Mileage Counter Timestamp Char 20 yyyy-mm-ddThh:mm:ssZ Date and time counter value was captured

Also, a new ESS transaction was created for alerts related to TMC thresholds being exceeded. The new transaction is T.1.21.0 and is sent when a TMC exceeds the enabled and configured threshold. The new transaction will contain the TMC value, timestamp, and threshold value that was exceeded.

For more information visit the ESS Transaction page on the Services Portal Integration Developer’s wiki at: https://intinfo.omnitracs.com/display/iWebInt/ESS+Transactions

Compressed Natural Gas

Services Portal 2.7 includes integration support for Compressed Natural Gas (CNG) features in the Performance Monitoring application. These features allow you to monitor fuel consumption and other Performance Monitoring metrics for CNG vehicles just as you do for diesel vehicles. CNG support is currently only available for vehicles equipped with an MCP200 mobile device. Some MCP200s may require a firmware upgrade, please contact your Customer Experience Representative for more information.

The T.4.01 ESS Performance Extract transaction now includes a new <fuelSource> element that indicates if the extract is diesel (0) or CNG (1). If the <fuelSource> element indicates the fuel used is CNG then the <fuelUsed> element is provided in diesel gallon equivalents (DGEs). This allows customers using CNG vehicles to compare Performance Monitoring data from CNG vehicles.

Performance extracts from CNG vehicles are partially visible in the Performance Monitoring host application and reporting interface; however, all key performance measures related to fuel efficiency excludes all data from CNG vehicles. Pages where CNG fuel efficiency data was omitted/suppressed contain a “*excludes CNG data” link at the top of the page and the link contains further information about the CNG data exclusion. This link is only visible if you have CNG vehicles in your fleet and only on pages where CNG fuel data was excluded.

Fault extracts returned from CNG vehicles are visible in the Performance Monitoring host application and units of measure are displayed in gallons for diesel vehicles and DGEs for CNG vehicles.

Omnitracs Intelligent Vehicle Gateway

Services Portal 2.6 added support for a new mobile platform being tested by Omnitracs formerly called OTIS. OTIS has been renamed Omnitracs Intelligent Vehicle Gateway (IVG) and the UI has been updated in Services Portal 2.7 to reflect this. In addition to the new name, IVG also has a new image to identify it in the Vehicle Directory.

Fixes/Minor Enhancements

The following fixes and minor enhancements were included in the Services Portal 2.7 release.

GeoServices

  • Corrected the latitude and longitude coordinates for Barrett Lake, BC.
  • Corrected the latitude and longitude coordinates for Saint-Alexis-de-Matapedia, QC.

Integration

  • Fixed an issue that sometimes caused the getDriverLogininfo() web service to not return the properly logged-in driver if the driver was bumped off at or near the time of the request.
  • The Subscribed? Flag now updates properly on the Cross-Company Invitation Details panel.

Miscellaneous

  • When downloading pdf reports, the name of the report is displayed instead of reportRetrieve.do.
  • The User directory in Administration now contains a column showing the timestamp for when the user last attempted to log in.
  • HTTP links in the footer were converted to HTTPS as a security enhancement to protect the privacy and integrity of exchanged data.
  • The URL for CoPilot FleetPortal was updated in the Services Portal frame
  • A special tag was added to the Services Portal frame that hosts Analytics Manager to automatically set the document mode to IE7 for Analytics Manager in order to ensure the best functionality of Analytics Manager but alleviate the need for users to put the Services Portal website in compatibility mode.

QTRACS

  • Fixed an issue with the message export feature where the wrong message was sometimes exported when two messages existed with the same source, destination, and creation time.
  • Fixed an issue that sometimes prevented the Message Export from printing correctly if the message contained special characters.

Trailer Tracks

  • The filter criteria no longer appears twice on CSV reports for Connect/Disconnect events.
  • When you rename a trailer, the name will auto update in the trailer list and you can click the trailer to view its details without having to refresh the page now.

Previous Releases