> For the complete documentation index, see [llms.txt](https://docs.theconfigteam.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theconfigteam.com/prebilt-ewm/user/games/challenges.md). # Challenges A Challenge is similar to a Competition, but is associated with the individual participant only. {% hint style="info" %} **Example** A personal Challenge is achieved when the participant picks 5000 cartons. {% endhint %} A Challenge has one or multiple *Levels*. These Levels allow the Challenge to gradually increase in difficulty. {% hint style="info" %} **Example** Entry Level is reached after the first pick, Beginner Level is reached at 500 cartons, Intermediate at 1000 cartons, and so on… {% endhint %} When a Challenge Level is reached, the participant will be presented with a Trophy. Like Medals, a Trophy can also have a reward associated with it, determined by the game organiser. Defining a new Challenge involves maintaining the following objects: * A Participation Type which is used to define whether the Challenge is automatically available to all users, manually assigned to a user, or manually selected by an applicable user. * A Metric configuration which defines what the Challenge will be evaluating. * One or multiple Levels, each with a unique Goal at which point the sub-Challenge finishes and a Trophy is awarded to the user. * The Timeframe during which the Challenge is valid. This can either be open ended or defined within a specific start and end period. ## Create a new challenge {% embed url="" %} From the EWM warehouse monitor, double click on node `Games > Challenges` and click on **Execute** in the selection popup:

From the Challenges report toolbar, click on `More Methods > Create Challenge`:

Enter the following fields for the new Challenge and click on OK:

Field	Use
Field	Use
Challenge Title	Short game description
Challenge Description	Long game description
Participation Type	Controls which participants are applicable for the challenge: · AUTO - Available for all users · PROMPT - Ask applicable participants to join from the PreBilt app. · MANUAL - Manual selection of participants
Game Metric	Currently only WTCONF (confirmed warehouse tasks) is supported

The Challenge is created with a new ID and status PREPPING:

### Configure the metric {% embed url="" %} The Metric defines what the Challenge will be evaluating, based on warehouse task attributes. Highlight the Challenge and click on the Configure Metric button:

A popup is displayed to define the Metric filters and the Goal’s score calculation. In the metric filters, enter the warehouse task attributes that you want the system to track for the game. {% hint style="info" %} **Example** Your Challenge is only focusing on picking tasks (WPT 2010) where the source storage type is RK01. {% endhint %}

In the Goals section, enter the following fields:

Field

Use

Score Calculation

Defines how the system tracks scores:

· 1 – Each confirmed task is a score point

· 2 – Score points are based on confirmed quantity

Game Metric Unit

Free text to indicate the Metric unit. This is displayed in game scores in the warehouse monitor and the PreBilt app.

{% hint style="info" %} **Example** The Challenge will track score based on confirmed task quantity (Score Calculation = 2) and the Metric unit will be ‘Cases’ because only full cases are picked from RK01. {% endhint %}

Click on the Execute button. The Metric Ok? column is flagged:

### Define levels {% embed url="" %} A Challenge can have one or multiple Levels, each with a unique Goal at which point the Challenge finishes and a Trophy is awarded to the participant. To create a Level, highlight the Challenge and click on the Add Level button:

A popup is displayed to define the Level. Enter the following fields and click on OK:


Field	Use
Level Number	Freely definable Level number
Level Title	Short Level description
Level Description	Additional Level description
Rewards Exists	(Optional) Activate checkbox if a reward will be given to the participant when the Level is reached
Reward Description	(Optional) Reward description, if applicable

The Level is saved and the current maximum Level Number is updated against the Challenge:

Highlight the Challenge and click on the Levels button, to display the newly created Level.

Highlight the Level and click on the Configure Goal button:

Enter the Goal Threshold for this Level and click on Execute:

{% hint style="info" %} **Note** Repeat the same process to create as many Levels as required in the Challenge. {% endhint %} ### Define the timeframe {% embed url="" %} Highlight the Challenge and click on the Add Timeframe icon:

Enter the start and end date/time for your Competition and click on OK. The start date/time must be in the future.

### Add participants {% embed url="" %} {% hint style="info" %} **Note** This step is not required if the Participation Type of the Challenge is set to AUTO. {% endhint %} Highlight the Challenge and click on the Add Participant button:

A popup is displayed to add participants. Click on the Multiple Selection button to add multiple participants:

Enter the username of all Participants and click on Execute twice:

The Participants can be displayed by clicking on the Participants button against the Challenge:

### Start the challenge {% embed url="" %} Once a Challenge is fully defined (i.e. Metric, Levels, Timeframe, Participants), click on Set to Ready button to release it.

The status changes to READY:

Once the Challenge start time is reached, the status automatically changes to RUNNING and the system starts tracking scores for each Participant. ## Change the challenge The Challenge header attributes can be changed by clicking on `More Methods > Change Competition`:

{% hint style="info" %} **Note** The Metric and Level Threshold can only be changed if the Challenge status is set to PREPPING. {% endhint %} ### Set to prepping To change the Challenge status back to PREPPING, click on `More Methods > Set to Prepping`:

### Change the metric {% hint style="info" %} Note To change the Metric, first ensure the Challenge status is set back to PREPPING. {% endhint %} Click on the Configure Metric button:

Update the Metric as required and click on Execute:

### Change the levels {% hint style="info" %} **Note** To add, change or delete a Level, first ensure the Challenge status is set back to PREPPING. {% endhint %} Highlight the Challenge and click on the Levels button, to display the newly created Level.

To change the Goal Threshold, highlight the Level and click on the Configure Goal button:

Edit the Goal Threshold value and click on Execute:

To change a Level title, description or reward, highlight the line and click on Change Level:

Edit the required data and click on Execute:

To delete a Level, highlight it and click on Remove Level:

### Change the timeframe {% hint style="info" %} **Note** To change or delete a Timeframe, first ensure the Challenge status is set back to PREPPING. {% endhint %} Highlight the Challenge and click on the Time Frames button, then click on the Change or Remove buttons.

### Add or remove participants To add a Participant, follow the same steps as described in [Add Participants](#add-participants). To remove a Participant, highlight the Challenge and click on the Participants button, then highlight the required Participant and click on the Delete button.

If required, a Participant’s status or score can be changed by clicking the Change Participant button.

Update the score and/or status and click on OK:

### Close the challenge manually {% embed url="" %} A Challenge can be finished early if needed, by clicking on `More Methods > Set to Closed`.

### Delete the challenge {% embed url="" %} A Challenge in status PREPPING can be deleted by clicking on `More Methods > Delete Challenge`: