Alloy Inventory Scanner
On this page
Alloy Inventory Scanner is a separate, store-distributed mobile app for technicians doing physical inventory. It runs on Android and iOS. Once connected to your Alloy Navigator server, you can scan or type an asset's code, run an inventory action on the asset, and submit it right away. You can also work with no connection and record scans in an offline queue that you upload later.
The inventory actions the app offers come from the scanner's configuration record in Alloy Navigator, which is a list of workflow actions the app may run; see Inventory Scanner Configuration. In a new 2026.1 database created with the Default Workflow (see Default Workflow Configuration), the scanner's configuration includes the Inventory action. An upgraded database need not have this action, and an administrator may have changed it.
Before you begin
- You need a technician account. In the supplied configuration, no security role limits the Inventory action, so any technician account can run it.
- The server's API must be configured for Access Token authentication.
- To scan barcodes or QR codes with the camera, the app needs camera access on your device.
In the Inventory Scanner app
Connect and sign in
When the app starts, it reads the saved connection settings. If they are complete (a server URL together with a user name or a saved single sign-on credential), the app shows "Connecting the server... Please wait." and signs in with them; on success it opens Scan Barcode. You can tap CANCEL to stop and open Connection Settings instead. If the settings are incomplete, the app opens Connection Settings at once. If the server's security certificate cannot be verified, the Confirmation dialog described below appears, and tapping NO opens Connection Settings. If connecting fails with any other error, the app shows the error in an Error dialog and then opens Connection Settings.
To open Connection Settings later, choose Settings in the menu of Scan Barcode.
- On Connection Settings, enter the server address in Server URL, or tap SCAN to read it from a QR code.
- Tap GO. The app contacts the server and asks which sign-in methods it offers. The app follows one redirect: if the server answers with a redirect to an address that starts with HTTP or HTTPS, that address replaces the URL and the Server URL field shows it. After this step the field is read-only; tapping it discards the result and returns to the first form.
- Sign in with one of the methods the server offers:
- Type your user name and password in the username and password
fields and tap SIGN IN. The password field has a show/hide toggle.
The user name is required; an empty one gives "Required field". To
sign in with a Windows domain account, type the user name as
DOMAIN\userand use your domain password. The server checks the name against its Domain Credentials record for that domain and requires an active technician account whose login is thatDOMAIN\username. - Tap the Sign in with row for a single sign-on provider. The provider's sign-in page opens inside the app.
- Type your user name and password in the username and password
fields and tap SIGN IN. The password field has a show/hide toggle.
The user name is required; an empty one gives "Required field". To
sign in with a Windows domain account, type the user name as
Server URL and QR codes
- A QR code can carry the server URL alone or the URL and a user name. A scanned user name is filled in with an empty password. A code that yields no URL gives "Invalid QR Code". If camera access is refused or scanning fails, the app shows the same error as on Scan Barcode (see step 1 of Scan and inventory an asset online) and stops.
- An empty URL gives "You must provide a server URL", and a URL that does not start with HTTP or HTTPS gives "Invalid scheme, use HTTP or HTTPS".
To open the offline queue without contacting a server, tap WORK OFFLINE. See Work offline: queue scans and upload them.
If the server's security certificate cannot be verified, whether at launch, when you tap GO or SIGN IN, or when you upload the offline queue, a Confirmation dialog reads "Your connection may not be secure. The security certificate cannot be verified. Do you want to connect anyway?" Tap YES only if you know and trust the server you are connecting to; otherwise tap NO to stop. After YES, the app accepts any certificate from then on and retries. When the app starts more than seven days after you tapped YES, it asks again. On Android, the app also trusts the certificate authority certificates that you installed on the device.
The settings you enter are saved on the device before each sign-in attempt, including the password, or the single sign-on credential when you use single sign-on. The app uses them to sign in at the next launch. On Android, an upgrade from an older client of Alloy Inventory Scanner starts with empty connection settings, so you enter them again.
IMPORTANT: Anyone with access to the device can read the saved connection settings, including the password or the single sign-on credential.
While the app is connecting on Connection Settings, you can tap CANCEL to stop the attempt. A second attempt started while one is still running is refused with a message that another operation is still in progress.
Signing in also loads the scanner's inventory actions and the list of active locations. A location added on the server after you sign in is not offered until the app connects again.
If connecting or signing in fails, the app shows one of these messages:
- "Failed to connect to" and the server address: the server refused the connection.
- "The specified URL does not point to Alloy Navigator API version 8.0.0 or later. Make sure the URL is correct.": the app could not read the server's answer.
- "Unable to access this address. Make sure the URL points to Alloy Navigator API configured for Access Token authentication.": the address asks for Windows authentication when the app signs in.
- "HTTP protocol is not supported. All requests must be made over HTTPS."
- "Authorization failed", or the server's own text when the refusal concerns a license: the sign-in was refused.
If the app cannot use the server's answer about single sign-on providers, only user name and password sign-in is offered. The same happens when that request fails, unless the server answers it with HTTP status 505 (HTTP Version Not Supported).
Scan and inventory an asset online
- On Scan Barcode, tap the round camera button and scan the asset's
barcode, or tap ENTER BY HAND, type the code in the Enter Barcode
dialog, and tap SEARCH. The dialog requires a value. The code can be an
Asset ID, Asset Tag, Serial Num, Barcode, or product's Part Number.
- If camera access is refused, a "No camera access" error asks you to grant the app camera access in the device's application settings. Any other scanning failure shows "Unknown error:" and the error. After either error, the app still runs a search, for an empty code.
- A scanned value that contains
http://orhttps://is not searched. A Web link dialog opens instead, with Close and LAUNCH LINK. A typed value is always searched.
- The app looks the code up in each of those fields and merges the matches.
On iOS, a 13-digit code that starts with 0 and finds nothing is searched
again without the leading 0.
- If nothing matches, a Code not found dialog reads "Could not find" followed by the code and "in the database.", and offers Close and SEARCH WEB, which searches the web for the code.
- Otherwise the Assets page shows the code as a heading and one expandable panel per asset. A single match opens expanded.
- Review the asset in its panel. The header shows the asset's type icon, name, ID, and status. The body shows the description; the Asset Tag, Serial Num, and Barcode; the Owner, Organization, Location, Stock Room, and Last Inventory Date; the Product, Manufacturer, Part Number, and Model; and the notes. Tap the notes preview to open the notes formatted; a link in them opens in an external app. With a server of version 2021.1.0 or earlier, or when the app could not read the server's version, the notes show as plain text with no link.
- Tap the button for the inventory action you want to run, such as INVENTORY for the Inventory action. Each configured action has its own button, captioned in upper case. The button opens a form titled with the action's caption.
- Choose a Location, which is required: tap the locate button to open Choose Location, which lists the active locations as a tree. Tap a location without sublocations to choose it, or expand a location that has sublocations and tap CHOOSE. An active location whose parent location is not active does not appear in the tree. The field starts with the last location you submitted since the app started. Without a location, the form shows "Please choose a location".
- Optionally, edit the Comment. It starts with the last comment saved on the device.
- Tap SUBMIT. The app saves the comment for next time.
- A retired asset is refused on the device with the message Asset "<asset ID>" is retired, and nothing is sent to the server.
- Otherwise the app runs the action on the server. On success it shows the action's response message, and the asset's Last Inventory Date reads "Just now". For Inventory, the response message is set to "Inventory completed" in the supplied configuration. On failure, an Error dialog shows the server's error text.
Of the fields on the action's form, the app fills only the location and the comment. Any other field on the form gets no value from the app.
Work offline: queue scans and upload them
- Open the Offline Queue: tap WORK OFFLINE on Connection Settings, or choose Offline Scan Queue in the menu of Scan Barcode. Until something is queued, it reads "The offline scan queue is empty."
- Tap the add button to open the Offline Scanning form. Type or scan (with the camera button next to each of the two code fields) the asset's code in Asset ID, Asset Tag, Serial Num, Barcode, or product's Part Number and a location code in Location ID; both are required, and an empty one gives "Required field". Optionally, add a Comment.
- Tap SAVE. The app confirms that the code has been recorded in the
offline scan queue. The form stays open and clears only the asset code,
so the location and comment carry over to the next asset. The last
location code and comment are also saved on the device for the next
launch.
- A code already in the queue gives Duplicate Code: the code "is already in the queue. Scan another asset."
- To change or remove a queued entry, tap its row to show EDIT and
DELETE. Only one row is open at a time.
- DELETE removes the entry at once, with no confirmation.
- EDIT opens the entry in the Edit Entry form; tap APPLY to save your changes. The duplicate check runs only when you change the asset code.
- To send the queue, tap the upload button in the bar, which appears only
when the queue is not empty, and tap PROCEED in the Upload dialog.
- If the saved connection settings are incomplete, the app shows "Server connection settings are missing." with Close and SETTINGS. Tap SETTINGS to open Connection Settings; the upload is retried with what you enter.
- The app connects to the server in full, which reloads the inventory
actions and the active locations. While it connects, you can tap
CANCEL to stop. If the server's certificate cannot be verified, the
same Confirmation dialog as at sign-in appears.
- With more than one inventory action, choose one in the Choose Action list. With exactly one, the app applies it without asking.
- With none, the app shows "There are no inventory actions configured on the server!"
Upload results
The app works through the queue one entry at a time. For each entry it looks up the asset code and the location code again, then runs the action with the location and the comment. The location code is looked up among the active locations just loaded, including an active location that the Choose Location tree leaves out because its parent is not active.
- An entry that succeeds is removed from the queue.
- An entry that fails keeps its error, shown on its row: Asset "<code>" not found; Found multiple assets matching the "<code>"; Asset "<asset ID>" is retired; Location ID "<code>" not found; or the error the server returned. Nothing is retried on its own; the entry stays until the next upload or until you delete it.
A queued entry stores only the asset code, the location code, and the comment, not which action will be applied or when it was scanned. The queue is saved on the device, but an entry's error is not kept when the app restarts.
Change display options
- Choose Display Options in the menu of Scan Barcode, the Offline Queue, or the Offline Scanning form.
- Turn the Dark theme switch on or off.
- In Text size, choose System Default, Small, Normal, Medium, or Large. System Default uses the text size set on your device.
Each change is saved on the device, and the app uses the saved options when it starts. When you first start the app, it uses the light theme and System Default. The startup screen and the About screen do not follow the text size.
View information about the app
Choose About in the menu of Scan Barcode, the Offline Queue, or the Offline Scanning form. The About screen shows the app name, a one-line description of the app, and the Alloy Software web address, www.alloysoftware.com. It always has a white background and the default text size, whatever your display options.
In the Web App
Check the result of an inventory
In the supplied configuration, the Inventory action sets the asset's Last Inventory Date to the current time and Inventoried by to you, saves the location you chose, and adds an activity "Physical inventory performed" whose details carry your comment. In that configuration, the action carries a condition that offers it only when the request comes from the Inventory Scanner app. To check the results, you need View permission on the assets.
In the Web App, the default forms show the result as follows:
- On the Asset form, the General tab shows Last Inventory Date and Inventoried by in its Details section and Location in its Ownership Information section. The Activity tab lists the activity.
- On the Computer, Hardware, and Software License forms, Last Inventory Date and Inventoried by are in the Additional Dates section of the Finance tab.
Related topics
- Inventory Scanner Configuration - configure the scanner's inventory actions.
- Default Workflow Configuration - the content of a new database created with the supplied configuration.