Setting the URL of the Maximo Application Suite server in the Maximo Mobile application

To use the Maximo® Mobile application with IBM® Maximo Manage, the URL of your Maximo Application Suite server must be set in the application. The URL can be set manually by the mobile user or set centrally for each user by using a Mobile Device Management (MDM) application.

Maximo Mobile supports the standard approach to centrally configuring mobile applications that is defined by the Appconfig Community. When you load the Maximo Mobile Android application in an MDM application, the configurable settings are displayed, and you can set their values. For the Maximo Mobile iOS application, some MDM applications can load the configurable settings from an AppConfig.xml file. If your MDM application, can load the configuration setting from an AppConfig.xml file, create an appconfig.xml file and copy the following text to the file:

<managedAppConfiguration>
	<version>1</version>
	<bundleId>com.ibm.iot.maximo.mobile</bundleId> 
  <!-- for eam set bundleId as com.ibm.iot.maximo.mobileeam -->
	<dict>
    <boolean keyName="useSystemBrowserLogin">
          <defaultValue>
                <value>true</value>
          </defaultValue>
    </boolean>
    <string keyName="iosSystemBrowserType">
      <defaultValue>
        <value>ASWebAuthenticationSession</value>
      </defaultValue>
      <constraint>
        <values>
          <value>ExternalBrowser</value>
          <value>ASWebAuthenticationSession</value>
        </values>
      </constraint>
    </string>
  </dict>
	<presentation defaultLocale="en-US">
    <field keyName="useSystemBrowserLogin" type="checkbox">
      <label>
            <language value="en-US"> Use the system browser to log in?</language>
      </label>
      <description>
            <language value="en-US"/>
      </description>
    </field>
    <field keyName="iosSystemBrowserType" type="select">
      <label>
            <language value="en-US"> Select the system browser option to log in for iOS?</language>
      </label>
      <description>
            <language value="en-US"/>
      </description>
      <options>
        <option value="ExternalBrowser">
          <language value="en-US">ExternalBrowser</language>
        </option>
        <option selected="true" value="ASWebAuthenticationSession">
          <language value="en-US">ASWebAuthenticationSession</language>
        </option>
      </options>
    </field>
	</presentation>
</managedAppConfiguration>

For more information, see the documentation for your MDM application.

If your MDM application does not support the AppConfig.xml file, you can add the following settings and their values in your MDM application:

Table 1. AppConfig settings supported by Maximo Mobile
Setting	Type	Description
serverURL	String	The URL of the Maximo Application Suite server to which users connect.
allowURLtoBeChanged	Boolean	Allow the user to change the server URL in the Maximo Mobile application. The default value is `true`, which allows a user to change the URL in the application if, for example, they want to connect to a different server.
useSystemBrowserLogin	Boolean	The user logs in using the system browser instead of the embedded browser of the application. The default value is `false`. The user logs in using the system default browser when using the MDM application is used and useSystemBrowserLogin is set to `true`.
iosSystemBrowserType	Boolean	The logs in using iOS Safari browser. Set to `ExternalBrowser` or `ASWebAuthenticationSession`.

If you are not using an MDM application to manage your devices, you must send the URL of the Maximo Application Suite server to each Maximo Mobile user. Each user must then manually enter the URL of the server in the Maximo Mobile application.

After the URL of the server is set in the Maximo Mobile application, the Maximo Mobile applications, which are deployed on the Maximo Manage server, are set up on the device.