Alloy Navigator Mobile App
On this page
The Alloy Navigator Mobile App is the technician app for viewing and acting on tickets and other records. It is available for Android and iOS.
In the Mobile App
Get the app
Install the Alloy Navigator Mobile App from your device's app store.
Connect and sign in
To sign in for the first time, you need the address of your organization's
Alloy Navigator API module, for example https://navigator.example.com/api,
plus your credentials or single sign-on.
- Open the app. Enter the API address, or tap Scan QR code next to the
address field and scan a QR code that contains it.
- A QR code that carries only the address leaves you to enter your user name and password or use single sign-on; a code that also carries a user name fills it in for you.
- A code that yields no address is rejected with the message Invalid QR Code.
- Enter your user name and password, or use a single sign-on provider. The app asks the server whether password sign-in is allowed and which single sign-on providers to offer; if it cannot get this answer, it offers password sign-in alone.
- If your account already has a session elsewhere, the app may show a
Confirm dialog with the server's message.
- Tap YES to end the other session and sign in.
- Tap NO to keep the other session. If the server allows both sessions, you are signed in and both stay active; otherwise you return to the sign-in form.
If the address you enter redirects to another address, the app follows that one redirect and keeps the address it was redirected to.
If the address points to an Alloy Navigator API older than version 8.7.0, the app refuses it with the message The specified URL does not point to Alloy Navigator API version 8.7.0 or later.
While the app checks how the server authenticates, exchanges your credentials, or completes a sign-in after the Confirm dialog, the sign-in screen is dimmed behind a spinner with a CANCEL button.
- While the app checks how the server authenticates or exchanges your credentials, CANCEL cancels that step.
- After the Confirm dialog, CANCEL returns you to the sign-in form with no error shown, but it only stops the wait. The rest of the sign-in keeps running in the background: the session request you answered, the registration of your device, and the saving of your sign-in data can still take place. Only the loading of the home screen is skipped.
If you accept an untrusted certificate, the app keeps that exception for seven days and then asks again. On Android, the app also trusts the CA certificates installed by the user on the device; if it cannot load them, it shows no message.
The app remembers up to five server addresses, together with every user name signed in through each one, and offers them on the sign-in screen. When you sign in to a sixth address, the address used least recently is dropped. Choosing a remembered address fills in one user name stored for it, which is not always the one you used last. The user name field suggests every remembered user name.
The password and the single sign-on credential are kept in the device's secure storage. When keep me signed in is off, the app does not keep them.
The home screen
The home screen is titled Alloy Navigator and lists the record types you can open, grouped, with the last view you used for each. It also has a notification bell with a badge for unread notifications, a refresh control, a sign-out button, and an About link to the app description and links to documentation, privacy and security information, and the store review prompt. Two tabs, All and Favorites, show every record type or only your favorites.
Every screen shares one bottom bar: Home, Search, New, Go to, and More when the current record has tabs.
Tap New to see the create actions available to you, grouped as on a record's actions page. Choosing one runs the action for a new, blank record; when you complete it, the app opens the record it created. Viewing records and running actions are covered in Work with Records in the Mobile App.
Record types are grouped as follows:
| Group | Record types |
|---|---|
| My Work | My Tickets, My Tasks, Starred, My Followed Items |
| Service Desk | Announcement, Incident, Service Request, Change Request, Work Order, Approval Request, Knowledge Base Article |
| Asset Management | Asset, Contract, Library Item, Equipment Reservation, Consumable |
| Configuration Management | Computer, Hardware, Network, Document, Configuration |
| Software Asset Management | Software License |
Incident, Service Request, Change Request, and Work Order are ticket types; see Tickets. For approval requests, see Approvals. Project Task is not on the home screen; you reach it through My Tasks.
A record type that the app cannot open, because the server's configuration has no view or form for it or because the server version does not support it, stays on the home screen with a gray chip. Tapping it shows the message The Alloy Navigator server is not configured to support these objects. Contact your administrator to request a configuration update. A record type disabled in the app's configuration does not appear on the home screen; see Mobile App Configuration.
Lists and cards
A list shows one view of a record type, page by page, with each record as a card. The view settings of a list hold a sort field and direction (ascending or descending) and a filter field and pattern; the app keeps them for each view on your device. Identifier fields are not offered for sorting or filtering.
Most cards share one shape:
- A bold identity field at the top. Equipment Reservation and Library Item cards have none.
- Fields in the app's accent color, most often the owner, the requester, or a date.
- Plain fields for the type or category.
- For a record type that has a status, a status icon next to the status text.
Some cards differ:
- Ticket cards (Incident, Work Order, Service Request, Change Request, and My Tickets) show the ticket number in bold, the requester and creation date in the accent color, the due date and summary below a divider, and priority and status icons.
- The Announcement card shows the start date and title, colored as an alert when the announcement is high priority, with up to three lines of its content below. It has no status icon.
- Computer, Hardware, and Software License cards have no status icon.
On a record's Approvals tab, the approval chain shows each approval stage with its name, status, type, and rank, and each approval request, indented, with its approver, decision date, type, status, and rank.
Search
Tap Search on the bottom bar for a full-text search across the record types on your home screen.
Go to a record by ID
- Tap Go to on the bottom bar.
- Enter the ID in the ID to search for... box and tap GO TO.
- If exactly one record matches, it opens directly.
- If more than one matches, the app lists each match with its ID and record type; tap one to open it.
- If the box is empty, no result appears.
Go to searches only the record types on your home screen. A record type that is not on your home screen cannot be found this way, even if you can otherwise open it.
Find an asset or library item by barcode
On an Asset or Library Item list, you can scan a barcode to filter the list:
- On a Library Item list, the scan filters on the barcode, and the first match opens.
- On an Asset list, the scan checks the barcode, asset tag, serial number, ID, and part number. If exactly one record matches, it opens; if more than one matches, you see a Matching assets list.
- If nothing matches, the app shows the message No matching item found for the scanned code, followed by the code.
Favorites
- On the home screen, press and hold a record type's card.
- Choose Add to favorites, or Remove from Favorites if it is already a favorite.
On the Favorites tab, drag a card to reorder it. Your favorites and their order are saved on the device and kept after the app restarts.
End a session
- On the home screen, tap the sign-out button.
- Confirm Are you sure you want to sign out?
Signing out ends the app's session on the server.
If the server reports that your session is no longer active, the app shows the server's reason in a message, or a general message when the server gives no reason. When you dismiss it, the app signs you out and returns you to the sign-in screen.