How to Configure the Mobile Application

The Oracle Transportation Mobile Web Application is a mobile browser-based application that lets carriers and drivers to do basic functions. It can provide an offline user experience and be configured and customized via a mobile layout and user preference that selects that customized mobile layout. The Mobile Web Application shows same language as the mobile device and uses all of OTM's supported languages.

Enable Access

In order to use the Oracle Transportation Mobile Web App, the intended mobile web app user must have a user role with access to the following access control lists:

Mobile Web Application REST - View: If you want the user to have read-only access to the mobile app. All mobile web app uses should have this setting.
Mobile Web Application REST - Update: If you the user to Start/Confirm Shipments or Add Event, you will need this access as well as the View access.

Additionally, if your mobile user wants to see invoices, they must be granted access to these access control lists:

REST - Invoice - View
REST - Invoice - Update

Saved Query Access

If you've restricted user access to specific saved queries, you must provide access to the following saved queries. Additionally, if your mobile layout references a custom saved query, you must grant access to that as well. See Configure User Access for details.

By default a Servprov user needs access to these Saved Queries to run the mobile app:

SERVPROVS ACCEPTED SHIPMENTS
SERVPROVS ACTIVE SHIPMENTS
SERVPROVS ALL SHIPMENTS
SERVPROVS COMPLETED SHIPMENTS
SERVPROVS OPENSPOTBID SHIPMENTS
SERVPROVS SUBMITTEDSPOTBID SHIPMENTS
SERVPROVS TENDERED SHIPMENTS

By default a Driver user needs access to these Saved Queries to run the mobile app:

DRIVERS ALL FUTURE SHIPMENTS
DRIVERS ASSIGNED SHIPMENTS
DRIVERS COMPLETED SHIPMENTS
DRIVERS CONFIRMED SHIPMENTS
DRIVERS CURRENT SHIPMENT

Custom Saved Queries

You can write you own saved query and replace the PUBLIC one in the mobile layout with your custom query. You must define the saved query GID in the savedQueryGid elements in then the mobile layout in order to use it.

Any saved query you use must have the Enable for Mobile Use checkbox selected.

Create VPD to Limit Invoice Access

If you are giving your SERVPROV users access to invoice ACLs, then you should also add an Invoice VPD to your SERVPROV VPD. Use the following text for your VPD definition:

exists (select 'x' from user_association where user_association.gl_user_gid = vpd.get_gl_user() AND user_association.user_association_qual = 'SERVPROV' and invoice.servprov_gid = user_association.user_association_value)

Enable Automation Agents

Although not specific to the mobile web application, in order for an event/tracking event to get processed in OTM, a matching agent along with a corresponding workflow agent is needed. It can be “Legacy Shipment Matching” along with the public agent “Shipment Event Tracker” or the “Match Shipment” agent action, and a tracking event based agent for workflow processing.

When entering an event and specifying received quantities, if you want to view the received quantity fields in the shipment manager without the extra step of looking into the shipment’s events, you must configure an automation agent to copy the quantities from the event to the shipment ship unit. See the “Ship Unit Received Data” section of the Add Shipment Tracking Event topic for details on configuring this automation agent.

Properties

Add the following to properties set to avoid saved query delays:

Create a Custom Mobile Layout

If you do not want to use the default mobile layout, copy and customize it to suit your needs.

Invoice

If you want to upload documents to support line items for invoices, you must edit your mobile layout and set the hideOnDashboard to "false" for the invoices dynamic box.

Offline Work

A carrier can accept or decline tenders, and "start" shipment while the device is offline, if this functionality is enabled. To enable the offline functionality, the mobile layout for the carrier must have the offline settings enabled.

Select the Mobile Layout to Use

Edit the User Preferences for the user. Add the Mobile Layout ID user preference, and select the Mobile Layout of your choosing.

Launching the Mobile Web Application

The URL for the mobile web app is:

https://[hostname]/logisticsmobile

Where the [hostname] is your OTM URL.

Supported browsers are the most recent versions of Safari for iOS and Chrome for Android.

Add the Mobile Web Application to a Mobile Device

The mobile app can be added to the home screen of your mobile device. After setting up the mobile app, use the browser in your mobile device to Add to Home Screen after you have opened the mobile web app in the browser. Each OS has a different method for adding a web page to their home screen, but the option usually exists from the browser's Share feature. That will create an icon on the mobile device which will open the mobile web app directly.