Work with Records in the Mobile App
On this page
In the Alloy Navigator mobile app, a record's detail page shows the record, and its Actions page lists the workflow actions available on the record. Choosing an action opens the action's form. For workflow actions in general, see Workflow Overview.
In the Mobile App
View a record
A record's detail page shows the record on tabs. Which tabs appear depends on the record's class: General, Activities, Sub-Tasks or child work orders, Relationships, Approvals, and Attachments. For how approvals work, see Approvals.
- Tap the preview of a long text or HTML field to open it full-screen for reading. Images embedded in the text load from the server you're signed in to.
- To copy a value, long-press it and choose Copy; the message Copied confirms it. Almost every value on a record page can be copied this way.
- On the pages of My Tasks, announcements, tickets, approval requests, and knowledge base articles, long-press the page title and choose Copy ID to copy it. The title of an asset-type record page can't be copied.
- An encrypted field shows a masked value; long-pressing it opens no menu and copies nothing.
- An attachments list or a lookup search with no entries shows There are no items to display.
- On a knowledge base article, you see its star rating, from zero to five whole stars, but you can't rate the article in the app.
Run an action
- On the record's page, tap Actions at the top right, next to the record's title. The Actions page lists the actions available on the record.
- Tap an action. The list closes, and the action's form opens, titled with the form's caption.
- Fill in the form's fields; see Field controls.
- If the action is a wizard, move between its steps with Back and Next. Next appears on every step of a wizard except the last.
- Tap Apply, the checkmark button at the bottom right of the form. On a form that isn't a wizard, Apply is always the button shown there; in a wizard, it appears on the last step in place of Next. The server checks the form before the action runs.
- If a message appears, respond to it: close an information message, answer Yes or No to a confirmation, or close an error message. When several messages appear, they show one after another, and the last one decides: closing an information message or answering Yes runs the action, while closing an error message or answering No leaves it unrun. After you answer No, the form shows no further messages.
When the action completes, the form closes, and the record's page reloads and opens on its first tab.
To leave the form without running the action, tap the close icon at the top right of the form. On a form that isn't a wizard, Back also closes the form.
Create a record
- In the bottom bar, tap New. The app lists the create actions, grouped and captioned the same way as the actions on a record's Actions page.
- Choose an action. Its form opens for a new, blank record.
- Fill in the form and complete the action as described in "Run an action" above.
When the action completes, the app opens the page of the record it created.
Field controls
- Depending on its type, a lookup field opens a list dialog, a search screen, a two-step class-and-record picker, or a multi-value dialog.
- An unfiltered multi-value field with five values or fewer shows its values directly on the form. Otherwise, a dialog lists the values with a check box for each, with the field's current values already checked; turn on Selected items to show only the checked values.
- The class-and-record picker first opens a page listing the classes the lookup spans, with Please wait... shown while the list loads; tap a class to search for a record in it. The field then shows the class name, the record's ID when it has one, and its value, separated by commas.
- If a lookup search fails, the search screen is replaced by an Error page that shows the error.
- A long text or HTML field shows a three-line preview. Tap it to edit the text full-screen, then tap the checkmark to return the text to the form. A read-only field opens the same page with the text disabled and no checkmark.
- A currency field shows amounts in your server's currency format, with any decimals, symbol, or format that the field sets for itself taking precedence. Extra decimals are cut off, not rounded. A value that can't be read shows invalid value.
- For an attachments field, see Attach files and photos. For an AI-control field, see Use AI assistance.
Attach files and photos
A record's Attachments tab lists its attachments, and the detail page shows how many there are. To reach the tab, swipe across the record's tabs, or use More in the bottom bar.
Each row shows the file name, the file size, and up to three lines of the attachment's description. An attachment added with an activity also shows the activity's number, as Activity Num followed by the number. A link has no size.
- To open an attachment, tap it. The app downloads the file from the server to its own documents folder on your device and opens it in an app on your device that can open it. If there is no such app, the message No app found to open this file. appears. A link opens in your device's external browser. There is no separate download command: a file is saved to your device only to open it.
- To change an attachment's description, long-press it and choose Description. The Description dialog shows the current text; edit it and tap OK to save the new description on the server, or tap CANCEL.
- To delete an attachment, long-press it and choose Delete. In the Confirm dialog, which asks Delete "<file name>"?, tap YES to delete the attachment on the server, or tap NO.
Above the list, the paperclip adds a file picked from your device, and the camera icon adds a photo you take with the camera. The new attachment appears on the tab without a manual refresh. The photo is deleted from your device once its upload succeeds; a picked file stays on your device.
When an action's form has an attachments field, you can attach files to the action. The field is required when the form marks it as required. In the field:
- The paperclip opens your device's file picker.
- The camera icon opens the in-app camera. There is no option to choose a photo from your device's gallery. When the flash mode can be set, the camera offers Auto, Off, On, and Torch, and remembers the mode you choose. Taking a photo plays a shutter sound.
- Each file or photo is checked against the maximum attachment size set on your server.
- If the camera can't be opened, an Error page shows the camera's error description. If taking the photo fails, the camera closes and an error message shows the error text.
A photo taken with the in-app camera is deleted from your device once the action completes, when you remove it from the pending attachments, or when you leave the form. A new photo that fails the size check, or that you decide not to attach, is deleted as well. A file you choose with the file picker stays on your device.
IMPORTANT: If you edit the description of a photo taken with the in-app camera while the photo is still in the pending attachments, the photo's file is deleted from your device, and the photo stays in the pending attachments.
Use AI assistance
An action form can include an AI-control field: the field's caption, and below it the AI-generated answer, shown as it streams in.
- If the field has no value when the form opens, it asks for an answer once.
- Each finished answer is written into the field right away; there is no separate step to accept it. A regenerated answer replaces the field's value the same way.
- While an answer is generating, a spinner replaces the buttons. When the answer is ready, Copy copies it as plain text and shows Copied, and Regenerate asks for a new answer; Regenerate is disabled when the field is read-only. Open chat appears when chat is enabled for the field.
- A link in the field's answer opens in your device's external browser.
To refine the answer in a chat:
- Tap Open chat. The AI Chat Assistant opens with the field's current answer as its first message.
- Type your message in the box that reads Ask AI assistant anything... and send it. The send button does nothing when the box is empty, and it doesn't send until the previous answer has finished loading. The answer to your message is requested with the conversation so far.
- Each answer after the first offers Copy and Use this response. Tap Use this response to write that answer into the field and close the chat. Nothing else in the chat changes the field.
If a request fails, in the field or in the chat, an Error dialog shows the error text; close it with CLOSE. Tapping outside the dialog doesn't dismiss it. The answer keeps whatever part had arrived before the failure. In the field, that partial text replaces the field's earlier value, and the field is left empty if nothing had arrived. Nothing is retried automatically.
Browse the knowledge base
- On the home screen, tap the Knowledge Base card. The Knowledge Base page opens and lists the knowledge base folders under Browse Articles.
- Tap a folder. A page for the folder opens, titled with the folder's name alone, and lists its subfolders first and then its articles.
- To go further down, tap a subfolder.
While a page loads, Please wait... is shown. If a page can't load, an Error page shows the error.
If your server isn't configured to support knowledge base articles, the Knowledge Base card is gray, and tapping it shows the message The Alloy Navigator server is not configured to support these objects. Contact your administrator to request a configuration update.