Configure Mobile Device Management (MDM)

If your company uses MDM, before configuring the Field Management Mobile app, ensure your environment meets these requirements:

  • MDM Solution Configured: Your organization has an active MDM solution properly integrated with your corporate app distribution channels. Solutions could include ManageEngine Endpoint Central, Microsoft Intune, or VMware Workspace ONE.

  • App Deployment Channels:

    • Android: Apps must be deployed via Managed Google Play (not sideloaded or from test tracks).

    • iOS: Apps must be deployed as managed apps via Apple Business Manager or a Volume Purchase Program (VPP) integrated with your MDM.

  • App Version: Ensure the deployed app version contains the implemented code for reading MDM configurations using the exact ServerURL key.

Note: Small teams with only a few devices may choose to bypass MDM. In these cases, no configuration is required, and users can initialize the app directly in the browser. For details, see Pair the Portal to Field Management Mobile.

See the configuration steps below, which are different depending on whether you have an Android or iOS device.

Configure MDM for Android Devices

Android MDM consoles typically generate the configuration interface automatically based on the app's internal schema.

  1. Navigate to the App Management section: In your MDM console, locate the App Repository or App Catalog.
  2. Select the application: Find the specific application you are configuring.
  3. Locate the Configurations tab: If the app was correctly set up via Managed Google Play, a specific tab labeled Configurations (or App Configuration) should display when viewing the app details. Define the Settings:
    1. Locate the API Server URL field (corresponds to the internal key ServerURL).
    2. Enter the URL for your backend server.
  4. Assign and deploy:
    1. Save the configuration profile.
    2. Assign this configuration profile to the target device groups or users.

    The MDM will silently push these settings to managed devices. The app will receive them on its next launch or synchronization event.

Configure MDM for iOS Devices

For iOS devices, administrators must manually enter the exact key-value pairs that the application is coded to retrieve. The MDM console does not automatically generate the input fields.

  1. Navigate to the App Management section: In your MDM console, locate the App Repository or App Catalog.
  2. Select the application: Find the specific application you are configuring.
  3. Locate the Configurations tab/profile: For many MDMs, you will create a new App Configuration Profile and associate it with this application.
  4. Manually enter key-value pairs: You will need to add a new entry manually. Use the exact internal application keys provided here:
    • Key Name: ServerURL
    • Value Type: String
    • Description: The endpoint URL for the application backend services.
    • Example Value: https://api.com

    The app config file should look something like this:

    <plist version="1.0">
<dict>
    <key>ServerURL</key>
    <string>https://portal_url.com/</string>
</dict>
</plist>
  5. Assign and deploy:
    1. Save and name the configuration profile.
    2. Make sure the profile is assigned to the correct iOS device groups.

    The MDM will push these settings to enrolled iOS devices and apps will be initialized.