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

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:

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.

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.

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

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