Online Help | Desktop App

Alloy Navigator mobile app configuration

Introduced in 2021.2

Updated in 2026

Alloy Navigator Mobile App version 2.4

Alloy Navigator is our native app that gives technicians mobile access to Alloy Navigator Express. This page describes how to integrate the mobile app with Alloy Navigator Express, what the mobile configuration includes, and how you can customize it using the Settings App, i.e. how to disable some areas and hide their links from the mobile app's home screen or change views and forms that the mobile app uses.

The Alloy Navigator mobile app is available for iOS and Android mobile devices on App Store and Google Play. For instructions on how to use it, see Mobile App User's Guide.

NOTE: For the list of supported clients, see Installation Guide: Mobile clients.

API backend

The mobile application connects to Alloy Navigator Express through native API integration. The required setup depends on your Alloy Navigator deployment.

Deployment type Requirement

Cloud

No additional setup is required
On-premises

Alloy Navigator Express API module configured for Access Token authentication

For setup instructions, see Installation Guide: Installing and Configuring the API Module.

When users sign in to Alloy Navigator Express in the mobile app, they enter the API web address (API URL) and their Alloy Navigator Express credentials.

TIP: You can view the API URL in the Admin Center, on the General page under Apps and Portals > API. See Configuring general settings for details.

Alloy Navigator configuration

The default configuration for the Alloy Navigator mobile app contains ready-to-use settings for all supported object classes (Tickets,Change Requests, etc) and other areas. The configuration is stored in the Alloy Navigator Express database, and you can access and manage it from the Settings App.

Configuration settings include:

To manage the Alloy Navigator mobile app configuration:

  1. In the Settings App, go to Services > Mobile Applications and open NavigatorMobile. The Mobile Application [NavigatorMobile] dialog opens.

  2. The configuration is available in the Configuration field. It is an XML document, where all configuration entries are wrapped inside the <Data> and </Data> tag pair. For details, see the table below.

    IMPORTANT: Any changes made to the mobile app configuration become immediately active. We recommend that you save or export the default configuration to an external XML file before making any changes. A backup would help revert your changes and reset all settings to defaults.

    Section Elements and attributes Description

    DisabledObjects 

    <Object Name="Object"/>

    Available attributes:

    • Starred
    • Ticket
    • Change Request
    • Approval Request
    • Knowledge Base Article
    • IT Assets
    • Knowledge Base Article
    • Computer
    • Inventory Item
    • Consumable
    • Contract
    • Library Item
    • Equipment Reservation

    The section contains disabled object classes and areas. When an item is disabled, its link disappears from the home screen and the area is nor available in the mobile app.

    By default, the DisabledObjects section contains all areas and object classes, and the whole section is disabled (commented out). To hide unwanted items from mobile users, leave only those items inside the <DisabledObjects> and </DisabledObjects> tag pair and uncomment the section.

    TIP: You may want to adjust the workflow not to send push notifications on changes to disabled object classes. Otherwise, mobile app users would still receive push notifications with links to objects they cannot access.

    Views 

    <Object Name="Object">
    <View Name="View Name">
        <Fields>
            <Field Name="Field_Name"/>
            ...
        </Fields>
        <Sorting>
            <SortBy FieldName="Field_Name"/>
            ...
        </Sorting>
        <Filter>
            <SQL WHERE clause>
        </Filter>
    </View>
    ...
</Object>

    The section defines views for displaying lists of objects. Views are grouped by the objects they apply to.

    • Object Name: Object class name (Incident, Change Request, etc.)

    • View Name: Name of the view, as it appears in the Alloy Navigator mobile app.

    • Fields: List of object fields the view shows (as columns). You can add new fields, change their display order, and remove unwanted fields from the view.

      TIP: For correct field names, go to General > Fields > [Object Class] in the Settings App and open the desired field. The physical field name is in the Field Name field.

    • Sorting: List of object fields by whose values to sort the view. By default, field values are sorted in the descending order, from largest (latest) to smallest (earliest). To sort in the accenting order, add Reverse="1" after the field name; for example:
      <SortBy FieldName="Due_Date" Reverse="1"/>.

    • Filter: Filtering expression, specified as a valid SQL WHERE clause (without the word WHERE) that the Alloy Navigator mobile app uses to select records to display.
    Forms 
    <Objects>
    <Object Name="Object">
        <Fields>
            <Field Name="Field_Name"/>
            ...
        </Fields>
    </Object>
    ...
</Objects>

    The section defines forms for displaying object details (field values). Every object has a single view form.

    • Object Name: Object class name (Incident, Change Request, etc.)

    • Fields: List of object fields the form shows (as values). You can add new fields, change their display order, and remove unwanted fields from the form.

  3. In most cases, leave the URL Mask field blank. This field stores the API URL associated with the Alloy Navigator mobile app. When you have a single API backend associated with this mobile app, there is no need to specify the URL here.

    However, if you need to have different configurations for different API endpoints, you can explicitly specify the API endpoint URL or its significant part in the URL Mask field. This requires you to have more than one API modules configured.

  4. Click OK to close the window and save your changes, if any. Alloy Navigator Express will check the syntax of the XML configuration file before saving.

The difference between disabled objects and unsupported objects

Every new version of Alloy Navigator Mobile App adds new features, including support for new Alloy Navigator Express object classes.

Mobile app users access Alloy Navigator Express objects by tapping their links on the home screen. If you want to block mobile access to some functionality, you can disable unwanted object classes by adding them to the DisabledObjects section in the mobile configuration. Links to disabled objects will disappear from the Alloy Navigator mobile app home screen.

The home screen displays links to all mobile-accessible non-disabled objects and areas, even when your current version of Alloy Navigator Express API or the mobile configuration does not provide support for some of them. Such unsupported objects would display a red "Do not enter" icon next to their links.

If there are any unsupported object classes, the Alloy Navigator mobile app will inform about them. See the table below for different situations that may occur on the home screen and how to resolve them.

Situation Description Solution

A red icon appears next to the link. Attempts to open the link throw this error message:

The Alloy Navigator server needs to be upgraded to version 2026 or later to support these objects.

 Your version of Alloy Navigator Express API is earlier than expected. The expected version is 2026 or later. Upgrade your Alloy Navigator Express to the latest version.

A red icon appears next to the link. Attempts to open the link throw this error message:

The Alloy Navigator server is not configured to support these objects. Contact your administrator to request a configuration update.

 The API has the expected version (i.e., 2026 or later), but the mobile configuration lacks settings for the objects. Contact our Support Team to obtain the latest mobile configuration and import it to Alloy Navigator Express.
There is no link to objects on the home screen. The object class is disabled. If you do not want those objects disabled, remove them from the DisabledObjects section in the mobile configuration.

Related Information:

Mobile App User's Guide: Home Screen

Mobile App user's Guide: Understanding Views

Web Configuration Manager

Workflow management

Alloy Navigator Express API User's Guide (On-Prem Only)

Alloy Navigator Express Mobile App User's Guide