Picking

Picking Quick Start Application
Overview
The picking quick start application provides users the ability to run through a retail picking flow. The application can be used in two different data source modes: demo data and integrated data.
When configured for demo data, the picking data comes from a static data set that is embedded in the application. Any data changes would require publishing a new version of the application.
When configured for integrated data, the picking data comes from an external data source and requires a Skylight extension (aka data connector). This allows for the data to be dynamic and customized to each deployment's specific needs and data source.  
Deployment Guide
1. Download the Application Bundle
PickingQuickStartApplication-v1.4.zip
2MB
Binary
Picking Quick Start Application v1.4
2. Import the Application Bundle
1.Navigate to the Skylight web portal. Select Applications on the sidebar and click
in the lower right corner to add a new application.

2.Select Import file, then choose the application bundle .zip file you downloaded.
 
 

3.The application will now appear in the application list. Hover over the application and click Open Dashboard to configure further.
3. Add Users & Configure Application Roles
The picking quick start application includes the following roles, which give different application permissions:
Role
Permissions
User
Start/complete picks with data integrated from an external source.
Demo User
Start/complete picks with the built-in demo data.
Manager
Set the data in a picking session. (⚠
This role should only be used for the Extension when the application is configured for integrated data)
To add users to the application:
1.Open the Application Dashboard, and select Permissions on the sidebar.

2.Click the 
 button to Add users.

3.Type the name(s) of the user(s) or group(s) you wish to add and choose a role. Then select ADD USERS(s) to give them access to the application.
 
 
If a user is granted both the User and Demo User roles, the Demo User role takes priority.
4. Publish the Application
The application must be published in order for it to be sync'd to users' devices. To publish the application:
1.Open the Application Dashboard.

2.Click the publish button.
 
 

3.A confirmation dialog will appear. Click PUBLISH to make the application available to all users.
Integration Guide
If you are only using the application with demo data, and not integrated data, then you can skip this section.
Users must be assigned the User role and removed from the Demo User role in order to view picking data from an external source.
The Picking Quick Start application can also be configured to populate pick walk data from an external data source. In this case, an "extension" (aka data connector), authored using Skylight's C# Integration SDK, is used to transfer data between Skylight and the external system. NET Core 3.1 is required to use this extension.
1. Install the Skylight C# SDK
If you haven't already, follow the steps to install the C# Skylight SDK on your machine.
2. Download the Extension Bundle
The Picking Extension is a .NET Core 3.1 console app. Download the bundle and extract it into a working directory.
PickingDataConnector-v1.4.zip
36KB
Binary
Picking Quick Start Data Connector v1.4
3. Configure the Data Source
By default, PickWalkManager reads pick walk data from an included JSON file and generates a CSV file for each completed pick walk.
To integrate with a different data source, update PickWalkManager.PickWalkManager(), PickWalkManager.GenerateReport() and PickWalkManager.GetPickWalk() as required to access your data source.
4. Configure Extension User Credentials
​Create a dedicated Skylight user account for the extension, add it to the application, and ensure it is assigned a Manager role for the application.
Configure the user credentials in the Extension using the following env variables:
SkylightUsername: Username for the Extension's Skylight user account
SkylightPassword: Password for the Extension's Skylight user account
SkylightRealm:  Skylight domain name
SkylightWebUrl:  Skylight web URL
If more than one extension will be running on the same host machine, the name of the env variables will need to be modified to avoid conflict since each extension should use a different set of credentials. For example, instead of SkylightUsername, change it to be SkylightRoutingUsername. SkylightRealm and SkylightWebUrl can be shared by multiple extensions if they are connecting to the same Skylight instance.
5. Build & Run the Extension
Build the extension console app and run it with the dotnet run command.
User Guide
Tote & Item Barcodes
If your application is deployed to use the built-in demo data, you can download the following document which includes barcodes that can be scanned for each tote and item.
Picking Quick Start Demo Barcodes.pdf
204KB
PDF
Picking Quick Start Barcodes
Screen glare can prevent the scanner from correctly recognizing the codes. Best practice is to print the document.
If your application is deployed to use data from an external system with the extension, then the barcodes are determined by the items in that system.
Starting a Pick Walk
1. Open the application and scan a tote barcode to start the pick walk.
 
 
2. Wait while the tote is validated. If the tote is invalid, the Invalid cart number error message will be displayed. 
 
 
3. If the tote barcode is valid, the first item in the pick walk is displayed and you can begin the begin the pick walk.
 
 
Picking Items
If the item is available:
1. Scan the item UPC with the barcode scanner to confirm the item. If the UPC is invalid, the Incorrect UPC scanned error message will be displayed.  
2. If the pick quantity is 2 or more, use the device controls or voice commands to enter the item quantity picked. For example, to input a quantity of 5, you would say Select five, then Commit entry.
 
 
3. Scan the tote barcode to confirm the item was placed in the correct tote, or say Confirm deposit. If an invalid tote is scanned the Incorrect tote scanned error message will be displayed.
 
 
If the item is unavailable:
1. Say Item unavailable or use the device controls to select, display the options menu, and select the Item unavailable.
 
Ending a Pick Walk
After all the items are picked, you will see the Item complete message. 
 
At any time during the pick walk, you can end the pick walk by saying End pick walk, or opening the navigation menu and selecting End pick walk.
 
Other Information
Requirements
Smart Glasses Client 7.4.1 or newer
Bluetooth Barcode Scanner
​.NET Core 3.1 (for integrated data)
​C# Integration SDK (for integrated data)
Known Limitations
Designed for the Smart Glasses client form factor.  Images are not centered on the mobile client.
Release Notes
1.4
Application
New setting to enable/disable voice picking on the confirm deposit screen. After the barcode is confirmed, the enter quantity menu is bypassed. This enables the user to confirm the picked quantity on the deposit screen by saying "picked #". 
To disable, edit the application data and set voiceQTYDepositEnabled to false.
To enable, edit the application data and set 
voiceQTYDepositEnabled
 to true.
New feature to call for remote assistance from the action menu. 
Item pictures may now be referenced from the Application Media Library. 
Use skylight://<Media ID> in lieu of an external URL
New feature for preview next item
Custom events for picking performance metrics are now included
Summary Events
Items Picked: SUM(Picked item QTY)
Pickwalk Duration: (Pick Complete) - (Initial Tote scan)
PickRate: (Items Picked)/(Pickwalk Duration)*60
Number of Incorrect Scans: SUM(Incorrect UPC Scan)
For each item
Travel/Seek Duration: (Item Display Time)-(Item Scan Time)
Deposit Duration: (Tote Display Time) - (Tote Scan Time)
1.3
Application
New setting to enable/disable the “scan tote” screen.
To disable, edit the application data and set skipScanTote to true.
To enable, edit the application data and set skipScanTote to false.
New setting to disable the “deposit” screen.
To disable, edit the application data and set skipDeposit to true.
To enable, edit the application data and set skipDeposit to false.
1.2
Data Connector
Add nuget.config file
Application
Update the UI to work with Skylight for iOS
1.1
Extension
Renamed the PickingExtension project to PickingDataConnetor
Changed the namespace from Skylight.Extension.Picking to Skylight.DataConnetor.Picking
Application
Changed the view mode from native to gallery
1.0
Initial release of the Picking Quick Start Application
0.0
Pre-release of the Picking Quick Start Application
Calling
Wire Harness Insertion
Last modified 1yr ago
Role	Permissions
User	Start/complete picks with data integrated from an external source.
Demo User	Start/complete picks with the built-in demo data.
Manager	Set the data in a picking session. ( ⚠ This role should only be used for the Extension when the application is configured for integrated data)