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

2. Import the Application Bundle

1. Navigate to the Skylight web portal. Select Applications on the sidebar and clickin 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:

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.

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

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.

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

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.

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.1.0 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.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