Services Portal 3.6 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 3.6, scheduled for U.S. release in winter 2020.
For previous release notes, click here.
Trailer Tracks: TTID Host Support
Background
New Omni TTID Device
This release of the Services Portal, primarily within the Trailer Tracks application, introduces initial host support for the new, soon-to-be-available TTID trailer device. The TTID is similar in function to the TT100; its primary purpose is to report its identifying information, including the Trailer ID of the asset, to an Omnitracs in-cab device upon connect or disconnect.
Like the TT100, the TTID can be installed in standalone mode. It can also be installed alongside any other TT telematics device that does not have the ability to publish trailer identifying information to the in-cab device upon connect. Together, the telematics device and the TTID will provide the full-featured TT device offering to customers, similar to traditional TT210 functionality.
In addition to standalone support in the Services Portal, data generated by Omni in-cab devices in connection with TTIDs can be made available to third-party user interfaces to allow the display of Connect/Disconnect and tractor position reports alongside events generated by paired trailer tracking telematics devices.
UI Support for TTID-Equipped Trailers
Support within the Trailer Tracks host for TTID-equipped trailers is described in the table below. In most cases, it is very similar to the support available for TT100-equipped trailers; therefore, users familiar with TT100 implementation will see little visible change.
|
TT UI Page/Area |
TTID Support |
Notes |
|---|---|---|
| Dashboard |  |
There are no changes for TTID-equipped trailers; supported just like TT100-equipped trailers. |
| Trailers - List Filter | |
Users can filter the trailer list by new Device Types:
|
| Trailers - Export | |
The exported CSV has been extended for TTID-equipped trailers to denote the trailer as TTID-equipped. The file now |
| Trailers - Add new... |  |
The Add new trailer dialog window has been updated to prohibit manual creation of TTID-equipped trailers. TTID-equipped trailers are exclusively auto-created in the host upon receipt of a connect/disconnect to a TTID-equipped trailer. |
| Trailers - Overview | |
There are no changes to the Overview subtabs (Status, Specs, and Groups) for TTID-equipped trailers. All are supported like TT100-equipped trailers. |
| Trailers - Ping | |
There are no changes to the Ping button and dialog window for TTID-equipped trailers. Ping is supported like TT100-equipped trailers. |
| Trailers - Settings | |
The rename option is not available for TTID-equipped trailers; rather, the trailer ID is conveyed to the host when it receives a connect message for a TTID-equipped trailer. (The ID is programmed into the TTID via an FST when it is originally installed.) |
| Trailers - Monitoring | |
There are no changes for TTID-equipped trailers; monitoring is supported just like TT100-equipped trailers. |
| Trailers - About Device | |
There are two changes to this tab for TTID-equipped trailers:
|
| Trailers - History | |
Trailer history is supported just like TT100-equipped trailers, except no Reefer events are available from the event filter drop-down list. |
| Trailers - Closest Landmarks | |
There are no visible UI changes for TTID-equipped trailers; this feature is supported just like TT100-equipped trailers. |
| Setup | Monitoring Plans | |
TTID-equipped trailers must be assigned to a plan just like any other trailer. As such, they are supported much like TT100-equipped trailers: a new TTID Alerts tab provides configuration for the optional notifications for the supported events, but there is no new TTID Config tab (since there is nothing available to configure on a TTID from the host). |
| Landmarks | |
There are no visible changes to the Details, Inventory, or Notification tabs for TTID-equipped trailers. All are supported just like TT100-equipped trailers. |
| Queries | |
There are no visible changes to the Queries UI for TTID-equipped trailers. All except Utilization are supported just like TT100-equipped trailers. |
| Alerts | |
There are no visible changes to the Alerts UI for TTID-equipped trailers. This feature is supported just like TT100-equipped trailers. |
| Fleet Map | |
There are no visible changes to the Fleet Map UI for TTID-equipped trailers. This feature is supported just like TT100-equipped trailers. |
| Setup | Company Settings | |
There are no visible changes to the Company Settings UI for TTID-equipped trailers. This feature is supported just like TT100-equipped trailers. |
Integration Support for TTID-Equipped Trailers
Web Services
Support within the Trailer Management Web Service interface for TTID-equipped trailers is described below (and also available on the integrator's wiki).
In most cases, TTID support is very similar to that for TT100-equipped trailers.
|
Trailer Management Method |
Applicable to TTIDs |
Notes |
|---|---|---|
|
|
|
|
TTIDs do not have any required hardware. If a Monitoring Plan requires any sensor or reefer capability, a TTID-equipped trailer will be declared incompatible. | |
|
TTID-equipped trailers cannot be created via integration. If you attempt to do so you will receive this error:
|
|
|
|
|
|
|
|
|
|
|
|
As with TT100s, this error is returned if the trailer is not connected:
|
|
|
TTID-equipped trailers cannot be renamed via integration. If you attempt to do so you will receive this error
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
TTID-equipped trailers do not have on-board geofence support. If you attempt to configure them, you will receive this existing error
|
|
|
TTID-equipped trailers are not eligible for data sharing support. If you attempt to configure them, you will receive this new error:
|
|
|
TTID-equipped trailers are not eligible for data sharing support. If you attempt to configure them, you will receive this error:
|
|
|
TTID-equipped trailers are not eligible for data sharing support. This service will return this existing error:
|
|
|
TTID-equipped trailers do not support reefer functionality. If you attempt to configure them, you will receive this existing error:
|
|
|
TTID-equipped trailers do not support reefer functionality. If you attempt to configure them, you will receive this existing error:
|
|
|
TTID-equipped reefers may not be created via integration. If you attempt to configure them, you will receive this new error:
|
|
|
TTID-equipped trailers do not support reefer functionality. If you attempt to configure them, you will receive this existing error:
|
|
|
|
|
|
|
|
|
TTID-equipped trailers do not support Trailer Mileage Reporting. If you attempt to call this web service, you will receive one of these existing errors:
|
|
|
TTID-equipped trailers do not support Trailer Mileage Reporting. If you attempt to call this web service, you will receive one of these existing errors:
|
|
|
TTID-equipped trailers do not support Trailer Mileage Reporting. If you attempt to call this web service, you will receive one of these existing errors:
|
|
|
TTID-equipped trailers do not support Trailer Mileage Reporting. If you attempt to call this web service, you will receive one of these existing errors:
|
ESS
Support within the Event Subscription Service (ESS) has been extended for TTID-equipped trailers as listed below (and also available on the integrator's wiki).
- The following trailer-related ESS events are published for TTID-equipped trailers:
- T.1.08.0 - Trailer Position Reports
- T.1.18.0 - High Frequency Trailer Position Reports
- T.1.09.0 - Trailer Definition Notifications
- T.1.01.0 - Connect/Disconnect Notifications
- T.1.10.0 - Mobile Health Status Reports - for trailer status overdue condition only
- T.5.01.0 - Geo-Spatial Events (arrival/departure at host-defined geofence)
- The enumeration/annotation on the <mobileType> element within the shared <equipment> type present in many ESS transactions has been updated to reflect the new value for TTIDs:
- 0 = Unknown/Not Installed
- 1 = MCT
- 4 = MCP
- 5 = MCP100
- 6 = MCP110
- 7 = MCP200
- 8 = MCP50
- 9 = IVG
- 10 = TT200/210
- 11 = TT100
- 12 = TT150
- 13 = AMG
- 14 = AMG-C
- 15 =TTID
Fixes/Minor Enhancements
Below are the minor enhancements and fixes that are included in Services Portal 3.6.
Entity Sync to Omnitracs One
The ES-to-OT1 entity sync feature was extended to pull the driver's Sixteen Hour Exemption from HOS and relay it to the Omnitracs One host (along with the driver's other HOS attributes).
Three applications must be changed in order for this attribute to be synced all the way to OT1:
- HOS must make the attribute available to the Services Portal (available via HOS 5.12)
- The Services Portal must consume the attribute and relay it to OT1 (available via SP 3.6)
- OT1 host must consume the attribute from SP and post it into OT1 data/systems (available via RN TBD)
Alerts
- To provide more useful feedback to the user for errors related to the Entity Maintenance Bridge, lower-level feedback returned from HOS is now shown in the Alert text on the Alerts page. In this way, the user is better able to understand what went wrong and what is potentially required to get things in sync.
- On the Alerts page, hyperlinks in the Alert Event that do not link to anything by design have been removed.
Trailer Tracks
Monitoring Plan UI
A few minor UI fixes have been implemented on the Monitoring Plan maintenance page:
- The far left tab (TT200/210 Basic Config) is now active and in focus on the MP UI for customers whose fleets are comprised exclusively of T2s.
- The background and color scheme of all detail tabs on the MP UI now properly extend to the bottom of the screen.
- The serious exception handling on the MP UI now correctly displays debug/trace information on serious error.
Dashboard UI
On the TT dashboard, all errors encountered when editing dormancy levels are now handled properly.
Add Trailer UI
A minor fix was made to the Add new trailer dialog window (available from the Trailers tab) to display the "tethered reefer installed" prompt in the correct scenarios.
Prohibited Characters in Trailer ID
The following special characters are no longer permitted in a trailer's SCAC and ID: $ + & % ? < > /
New trailers and new SCACs cannot include these characters in their IDs. Existing trailers that include these characters in their ID will be allowed to exist as is unless or until they are renamed.
QTRACS
- Message History Report: A minor fix was made to the message list PDF file (available from the Messages page) to ensure that it is completed normally for users who may have coverages and/or global groups currently selected.
- Driver Bulk Import: A minor fix was made to the Drivers > Bulk Import > Results tab so that the error list correctly loads and displays in all cases.
- Fleet Mapping UI: A minor fix was made to the Fleet Map page to prevent duplicate or incorrect map markers from being displayed.
Miscellaneous
- A minor fix was made to the serious exception handling on the PM Management Group UI to correctly display debug/trace information for serious errors.
- In some cases, the Desktop Notifier no longer chimes for users running the Chrome Browser. This happens because Chrome now suppresses audio in windows until the user interacts with the window. A note has been added to the online help to explain this nuance.