Configuring properties that affect mobile apps

In Maximo® Manage, you can set system properties that affect the Maximo Mobile apps.

You configure system properties in the System Properties application in Maximo Manage. The following table describes the system properties that you can configure for mobile apps.
Table 1. System properties that affect mobile apps
Property Description
mxe.mobile.travel.radius The radius from the user’s GPS location to the coordinates of a work order’s service address over which travel time can be tracked. Distance is the actual distance measured between the two coordinates, not the driving distance. If a user's PERSON record lists the UK or US as their country, the value is measured in miles. In all other cases, the value is measured in kilometers.
mxe.mobile.travel.prompt Users can track travel time when the value in mxe.mobile.travel.radius is matched or exceeded. Set to 1 to enable.
mxe.mobile.travel.navigation In the Maximo Mobile Technician and Inspections apps, when a user clicks Start travel, a map opens to help the user get to the location of the work. Set to 1 to enable.
mxe.mobile.navigation.ios When you start a trip, a Maximo Mobile application opens a map service to help you navigate to your destination. Valid values for this property are AppleMaps, GoogleMaps, or Waze.

This property requires the mxe.mobile.travel.navigation property to be enabled.

Longitude and latitude coordinates are reported. Information about x and y axes is not provided.

IOS devices default to using AppleMaps .
mxe.mobile.navigation.android When you start a trip, a Maximo Mobile application opens a map service to help you navigate to your destination. Valid values for this property are AppleMaps, GoogleMaps, or Waze.

This property requires the mxe.mobile.travel.navigation property to be enabled.

Longitude and latitude coordinates are reported. Information about x and y axes is not provided.

Android devices default to using GoogleMaps .
mxe.mobile.navigation.windows When you start a trip, a Maximo Mobile application opens a map service to help you navigate to your destination. Valid values for this property are AppleMaps, GoogleMaps, or Waze.

This property requires the mxe.mobile.travel.navigation property to be enabled.

Longitude and latitude coordinates are reported. Information about x and y axes is not provided.

Windows devices default to using GoogleMaps .
maximo.mobile.fetch.timeout The time in milliseconds that the Maximo Mobile application waits for a response from the server and also the minimum time that the application stays offline if a response is not received. After the minimum time that the application stays offline expires, the application tries to connect to the server the next time that the mobile user sends a request to the server.
mxe.app.workorder.InspectionBatchRecord Set to 1 to create batch records for inspections in the same work order, regardless of the hierarchy of the work order. This property is set to 0 by default. 
mxe.app.workorder.StatusToCreateInspection Defines the internal work order status where the inspection result is created.

The inspection Result ID is generated when an Inspection Form is associated to the work order. The default value is WAPPR. This property should be updated to a list of values delimited by comma (,).

If then you will not be able to to start an inspection from a work order.
mxe.app.inspection.UpdatePendingResults Set to 1 to update pending inspection results with the newest active revision.
mxe.mobile.inspection.mobilefeatures Enables features in Maximo Mobile that are not supported in Conduct an Inspection Work Center.
mxe.mobile.inspection.features.signature Enables signature input on Inspections forms.
mxe.mobile.inspection.features.multiselect Enable multi-select input on Inspections forms.
mxe.mobile.inspection.features.enablereview Set a review status between the In progress and Complete statuses.

After you enable this property, you need to set the Require review option to Yes from the Form Settings page.
maximo.mobile.usetimer Specifies whether Start work starts the timer. Set to 0 to change status only and not start the timer.
maximo.mobile.statusforphysicalsignature The status that requires the user to provide a physical signature.
maximo.mobile.ldap.isForm This property is used by Maximo Mobile to detect what LDAP authentication method is used.
If you use SAML for authentication, ensure that the following properties are set correctly.
  • maximo.mobile.ldap.isForm=0
  • mxe.useSAML=1
maximo.mobile.completestatus The status that the work order changes to Complete when work is tapped in Maximo Mobile.
mxe.webclient.resetMobileSCCache Reset the mobile start center cache. Resetting the cache might cause portlet loading issues.
maximo.mobile.allowmultipletimers Determines whether multiple timers can be started at the same time. The default value is true.

When set to false, the user can start one timer at a time in Maximo Mobile. Multiple work orders can still have In Progress status. This value applies only for transactions that are started by the user who is logged in to the mobile device.
maximo.mobile.attachments.bulkDownload.automatically Automatically downloads files that are attached to a record every time transactional records such as work orders are downloaded or refreshed on a mobile device. You do not need to open each mobile application to download attachments. The default value is true.
maximo.mobile.attachments.bulkdownload.filesizelimit The maximum file size for a file that can be downloaded in the bulk download process. Users can still download the file through the attachment page. The default value is 5120 KB.
maximo.mobile.attachments.bulkDownload.zipcount The increment used to communicate progress of the bulk download of attachments. Progress count is displayed at the interval of the increment. For example, 10 of 100 is displayed, followed by 20 of 100. The default increment display value is 10.
maximo.mobile.attachments.bulkdownload.filetypes Attachment file types available for bulk download. File types include jpg, png, mp4, pdf, doc, xls, and xlst. All file types are included by default.
maximo.mobile.ios.zipdownload.timeout Dictates the timeout value in milliseconds for IOS native zip file downloads. IOS native zip file downloads include application files, the preloaded database package, and attachments.
mci.mvi.apikey The API key of your Maximo Visual Inspection instance. This property is associated with the mxe.mobile.inspection.features.mviintegration property.
mci.mvi.apiurl The URL of your Maximo Visual Inspection instance. This property is associated with the mxe.mobile.inspection.features.mviintegration property.
mxe.mobile.inspection.features.mviintegration Enables Maximo Visual Inspection photo analysis in Maximo Mobile.
maximo.mobile.esignatureenabled Set to true to enable e-signatures to be used to confirm the status change of a work order in the Technician application.
maximo.mobile.wostatusforesig Set to a work order status that requires an e-signature. For example, COMP.
mxe.allownativeesig Set to true to require a native key for Maximo Asset Management instead of user credentials. This property is required to enable e-signatures in Maximo Asset Management.
maximo.mobile.download.parallel The number of apps that the Navigator can download at the same time. If this parameter is set to 0, all apps are downloaded at the same time. The default value is 3.
maximo.mobile.userInteraction.idleTimeout The number of minutes before the current user is logged out of an application due to inactivity.

The default value is -1 which disables idle session timeout.
maximo.mobile.locationsharing.enabled Set to true to enable location sharing from mobile devices.
maximo.mobile.locationsharing.fgMinInterval Minimal foreground location refresh interval measured in seconds. Mobile device location information will be sent to the server at this interval.
maximo.mobile.locationsharing.options List of options to include in the JSON geolocation data collection.
Options include:
enableHighAccuracy
Set to true to collect greater location detail.
timeout
Set a timeout value for the request, measured in milliseconds.
maxAge
Set the maximum age of a cached position, measured in milliseconds

Multiple options can be set using commas as a delimiter. For example, enableHighAccuracy:true, timeout:30000:

.
maximo.mobile.customsync You can create one or more custom data sync operations to fetch a subset of record data for an application.

You must format the value for this property as a JSON schema array. Within the schema, you can define the label to display in the UI, the application, the datasource, and the type of data synchronization to perform.

Here is an example value for maximo.mobile.customsync:
[{"name":"Technician worklist only","lookup_delta":1,"ds_list":[{"app":"techmobile","ds":["todaywoassignedDS"]}]},
  {"name":"Technician lookup only","lookup_delta":1,"ds_list":[{"app":"techmobile","ds":["dsFailureList"]}]},
  {"name":"Technician and inspection lookup and work list","lookup_delta":1,"ds_list":[{"app":"techmobile","ds":["dsFailureList","todaywoassignedDS"]},{"app":"inspection","ds":["inspFormLookupDS","assignedworkds"]}]}]
name
The name value is the name that you assign to the data synchronization operation. This is the label of the data synchronization operation that appears on the Update type page.
lookup_delta
Set this value to 1 to update record data that has changed since the last time a synchronization was performed. Set to 0 to refresh all records related to the defined datasource.
ds_list
Configure a specific Maximo Mobile application and datasource for the synchronization operation.

You can review application XML files to identify datasources for which you want to create custom data synchronization operations.
maximo.mobile.gpsspoofing.ios.producedByAccessory Use this property to define how the server handles GPS location data that is simulated through an accessory on an iOS device.

Set the value to 0 to allow the server to fetch GPS location data from a simulated source. Set the value to 1 to prevent the server from fetching GPS location data from a simulated source.
maximo.mobile.gpsspoofing.ios.simulatedBySoftware Use this property to define how the server handles GPS location data that is simulated through apps on an iOS device.

Set the value to 0 to allow the server to fetch GPS location data from a simulated source. Set the value to 1 to prevent the server from fetching GPS location data from a simulated source.
maximo.mobile.gpsspoofing.android.emulator Use this property to define how the server handles GPS location data from an emulator on an Android device.

Set the value to 0 to allow the server to fetch GPS location data from an emulator. Set the value to 1 to prevent the server from fetching GPS location data from an emulator.
maximo.mobile.gpsspoofing.android.mockProvider Use this fproperty to define how the server handles GPS location data from an alternative provider, usually thorough an app installed on an Android device.

Set the value to 0 to allow the server to fetch GPS location data from an alternative provider. Set the value to 1 to prevent the server from fetching GPS location data from an alternative provider.
maximo.mobile.async.fetch This property helps to prevent timeouts when Maximo Mobile makes asynchronous data fetches from Maximo Manage that take an extended period of time.

To enable this property, set the value to 1.
sr.mobile.sapriority This property controls where the service address is imported from when user is in process of create a new service request.

Defaults to ASSET and can be set to LOCATION or empty value. Live refresh is possible.