Overview
Truck Loading Demo is a sample application that demonstrates one method of implementing a workflow on WS50, Zebra's Android wearable computer. The workflow involves moving from area to area and scanning packages within each area to load onto trucks.
Note: This sample keeps the screen turned on while running, which can impact device power consumption.
Requirements
- Android 11 or later
Downloads
Download the following:
- Truck Loading Demo source code for the sample app.
- DataWedge configuration file to configure barcode scanning with DataWedge.
- Sample barcodes for badge, door and package scanning.
Configuration
This sample app uses DataWedge to capture barcode data. The DataWedge configuration file is provided, which must be imported to the WS50. See Downloads.
Import Configuration
Follow the steps to import the DataWedge configuration file to a WS50 device:
Copy the configuration file
dwprofile_truckloadingdemo.db
to the WS50 device in folder location:/storage/emulated/0/Android/data/com.symbol.datawedge/files
Open DataWedge.
Tap on the top right menu and select Settings.
Scroll down and select Import.
Browse and select the desired profile or configuration file to import.
The file is imported. If the import is successful, a confirmation message appears.
The imported profile "truckloadingdemo" is listed in the DataWedge Profiles screen.
How to Use
This section walks through a workflow of the Truck Loading Demo app after it is installed on the WS50. The user moves from one area to the next, scanning packages at each area to load onto trucks.
When arriving at an area, the user scans the "door" barcode to identify the user location. Then the user scans the barcode of the package to load onto the truck. This process is repeated until the user is ready to logout.
1. Login
Run the app to display the Scan Badge screen.
- To login, scan the Badge barcode.
- To simulate a "bad" scan, scan a barcode other than Badge.
- Press Go Back to navigate back to the Badge Scan screen.
- Contact Supervisor opens the Contact Supervisor screen.
Scan good badge | Scan bad badge |
2. Go to Area
After login, a Scan Door screen appears indicating to go to Door 21 and scan the "Door 21" barcode.
- Scan the "Door 21" barcode to simulate a successful check-in.
- Scan the "Door 22" barcode to simulate a check-in to the wrong door.
- Press Go Back to navigate back to Scan Door screen
- If the "Badge" barcode is scanned, it brings the user to the Log Out page, giving the user the option to sign out or go back.
- If any other barcode is scanned, a red-x is flashed for 1 second, then the screen returns to the Scan Door screen.
Scan good location | Scan bad location |
3. Scan Packages
The user is directed to the Scan Packages screen.
- Scan any barcode that contains the word "package" to simulate a successful scan.
- Scan the "Door 21" barcode to check-out and go back to the Scan Door screen.
- If "Badge" is scanned, it brings the user to the Log Out page, giving the option to sign out or go back.
- Scan any other barcode to simulate a bad package scan.
- Press Done to navigate back to the Scan Package screen.
- Contact Supervisor opens the Contact Supervisor screen.
Scan good package | Scan bad package |
Note: Typically, barcodes scanned are sent to a back-end host, which logs the barcodes scanned by the user. Based on this use-case, the host sends back information to the user on what action to perform with the scanned item. For example, the user may be instructed to add the item to one of the totes they are filling. Often, they are colour-coded, and the app may turn on the device LED to the appropriate color for ease of distinction. For example, the picker may be instructed to put the item into one of two trucks - the app can flash the left or right LED as appropriate to indicate which vehicle to load. This demo app flashes the Left red LED to demonstrate this behavior.
4. Logout
While in either the Scan Door or Scan Package screen, the "Badge" barcode can be scanned to log out. Alternatively, tap and hold the screen to log out. The Logout screen gives the option to go back to where you were just before or to log out, which returns back to the Badge Scan screen.
Log out
Optional: Contact Supervisor
The user has the option to contact a supervisor when a badge scan or package scan fails.
Badge Scan
When a badge scan fails, the user can tap the Contact Supervisor button.
Bad badge scan |
The Contact Supervisor screen appears, offering canned answers for errors, as well as an option to enter a custom message.
Contact Supervisor screens |
To enter a custom message, tap the Custom button. Tap "..." and enter the message using the input panel. When complete, tap the check button to send the message. A confirmation message appears indicating the message is sent.
Send custom message |
Package Scan
When a package scan fails, the user can tap the Contact Supervisor button.
Bad package scan |
The Contact Supervisor screen appears, offering canned answers for errors, as well as an option to enter a custom message with the Custom button.
Contact Supervisor screens |
To enter a custom message, tap the Custom button. Tap "..." and enter the message using the input panel. When complete, tap the check button to send the message. A confirmation message appears indicating the message is sent.
Send custom message |
See Also
- WS50 Programmer's Guide - guidelines for application development on WS50.
- DataWedge WS50 Programmer's Guide - guidelines for data capture and application development using DataWedge for WS50.