LESSON INFO

Audience

  • Floor users who use the Android App to find items and update item information.
  • Supervisors who need consistent, repeatable Android app workflows.
  • Android app administrators who set up devices and support user access.

Prerequisites

  • A Android App instance is configured on the device using the Setup screen and a valid setup QR code (first launch only).
  • You have Android App login credentials (Username and password).
  • Your user account has access to the relevant screens:
    • Find Item
    • Update Item

Skills you’ll build

  • Log in to the Android App and recognize when facility context affects results.
  • Navigate between the Main Menu, the in-screen Menu Drawer, and key workflows.
  • Use Find Item to locate an item, including handling the “multiple customers” case.
  • Use Update Item to safely update an item’s manual location, measurements, or status, and confirm that required fields are satisfied.

LESSON OUTLINE

What is the Android App?

  • The Android App is the mobile app used on Android phones and scanner devices.
  • After you log in, it shows only the screens your role is allowed to use.
  • It is designed for fast work on the floor (scan barcodes, find items, and update item info) without needing a computer.
  • Most actions run in a specific Facility context, so what you see and can do depends on the facility you’re logged into.
  • Facility context matters:
    • Several actions are executed against a specific facility (for example, item finding and location lookups use a facility identifier).
  • Barcode input is a convenience mechanism:
    • Scanning can populate a field and trigger the same lookup/validation you would get by typing.

Get to a usable home screen

  1. Log in
    • On the Login screen, populate the required fields:
      • User ID
      • Password
      • Facility (may be hidden when only one facility is available)
    • Select Login.
      • If any required field is missing, expect an “all fields are required” user prompt.
      • If login credentials are wrong, expect an “invalid user ID or password” user prompt.
  2. Confirm you can navigate
    • Confirm you land on the Main Menu.
    • From any screen:
      • Use the Home icon to open the Menu Drawer.
      • Use the top-bar logo action to open the Menu Drawer.

Safe edits

Find an item

  1. Open Find Item from the Main Menu or the Menu Drawer.
  2. Provide an Item ID by either:
    • Typing into Item ID, or
    • Using the Barcode button to scan.
  3. If the Item ID is associated to more than one customer:
    • Use the Customer dropdown to select the correct customer.
    • (The dropdown is read-only if the Item ID has only one customer.)
  4. Confirm the location fields populate as read-only (if the item in question is in a manual, unstructured location):
    • Bay
    • Row
    • Position
    • Level

Update an item

  1. Open Update Item from the Main Menu or the Menu Drawer.
  2. Complete the required fields:
    • Item ID *
    • Customer * (behaviour varies; dropdown is used when multiple customers exist)
    • Item Info Selection *
  3. Choose a low-risk update for training:
    • Location update, OR
    • Status update, OR
    • Measurements update
  4. Before you submit:
    • If you change the Item Info Selection while you have edits in progress, expect a prompt to discard changes or cancel.
  5. Submit using Update Item.
    • If required fields are missing, expect a prompt to complete required fields.
    • If submission fails due to system or network error, expect an error prompt and your inputs should be maintained so you can retry.

Verification

  • Use Find Item to confirm you can retrieve an item and see location fields populated.
  • After an Update Item submission, check that you receive a confirmation prompt.
  • If you have web app access, validate that the updated field is reflected on the inventory item record.

COMMON ISSUES

    • Symptoms

      • Prompt indicates required fields are missing.

      • Prompt indicates invalid user ID or password.

      • Prompt indicates selected facility is unavailable.

    • Likely cause

      • Incorrect credentials.

      • Facility selection is not available.

    • Checks

      • Confirm Username and Password are entered.

      • If a Facility dropdown is shown, confirm a facility is selected.

    • Fix

      • Re-enter required fields and retry Login.

      • If the facility is unavailable, select a different facility (if available) or escalate to support.

    • Symptoms

      • Location fields stay blank.

      • Validation occurs when “Find Item” is tapped without an Item ID.

    • Likely cause

      • Item ID is empty.

      • Item ID is invalid.

      • The Item ID has multiple customers and a customer selection is required.

    • Checks

      • Confirm Item ID has a value.

      • If the Customer dropdown becomes active, confirm you selected a customer.

    • Fix

      • Scan again or type the correct Item ID.

      • Select the correct customer when prompted.

    • Symptoms

      • Prompt says required fields are missing.

      • Scan fails or scanned data is not valid for the field.

      • Submission fails due to system or network error.

    • Likely cause

      • Missing required fields (Item ID, Customer, Item Info Selection).

      • Barcode scan produced invalid or unrecognized data.

      • Connectivity issue.

    • Checks

      • Confirm required fields are filled.

      • If scanning, confirm you are scanning the correct barcode type for the field.

      • Confirm device connectivity.

    • Fix

      • Complete required fields and retry.

      • Re-scan or enter the value manually.

      • Restore connectivity and retry; inputs should be retained for a retry.