> 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/competitions.md). # Competitions A Competition is defined as a game with multiple participants but a clear winner (with runners-up) within a set period. {% hint style="info" %} **Example** A Competition is created to select the operator with the highest pick rate for the week. {% endhint %} A competition requires the assignment of: * A Metric which defines what the competition will be evaluating. * A Goal to which the winner will be judged by. * The Timeframe during which the competition will run. * The Participants of the competition who will be evaluated for a winner. A winner of a Competition will be presented with a virtual Medal, which can have an associated reward if the game organiser chooses. ## Create a new competition From the EWM warehouse monitor, double click on node `Games > Competitions` and click on **Execute** in the selection popup:

From the Competitions report toolbar, click on `More Methods > Create Competition`:

Enter the following fields for the new competition and click on OK: | **Field** | **Use** | | ----------------------- | -------------------------------------------------------------------- | | Game Title | Short game description | | Competition Description | Additional game description | | Game Metric | Currently only WTCONF (confirmed warehouse tasks) is supported | | Medal Name | Short medal name | | Medal Description | Long medal name | | Reward Exists | (Optional) Activate checkbox if a reward will be given to the winner | | Reward Description | (Optional) Reward description, if applicable |

The competition is created with a new ID number and is displayed in the monitor. The initial status is PREPPING:

### Configure the metric and goal The Metric defines what the Competition will be evaluating, based on warehouse task attributes. The Goal defines the game objective. The first player to reach this goal will be the winner. Highlight the Competition and click on the **Configure Metric** button:

A popup is displayed to define the Metric filters and the Goal. In the Metric filters, enter the warehouse task attributes that the system should track for the game. {% hint style="info" %} **Example** The Competition is only focused on picking tasks (WPT 2010) where the source storage type is RK01. {% endhint %}

In the Goals section, enter the following fields:

Field	Use
Field	Use
Goal Type	Select how the goal is defined: · MOST – Winner has highest score · THRESHOLD – Winner reaches threshold first · LEAST – Winner has lowest score
Goal Threshold	Only applicable if Goal Type = THRESHOLD.
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 scores in the warehouse monitor and the PreBilt app.

{% hint style="info" %} **Example** A Competition will give a prize to the winner with the highest score (Goal Type = MOST), will track score based on confirmed task quantity (Score Calculation = 2) and the Metric unit will be ‘Cases’ since you only pick full cases from RK01. {% endhint %}

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

### Define the timeframe Highlight the Competition and click on the **Add Timeframe** button:

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

The Competition Timeframe is updated:

{% hint style="info" %} **Note** Multiple Timeframes can be added for a Competition, if required. {% endhint %} ### Add participants Highlight the Competition 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 Competition:

### Start the competition Once your Competition is fully defined (i.e. Metric, Timeframe, Participants), click on **Set to Ready** button to release it.

The status changes to READY:

Once the Competition start time is reached, the status automatically changes to IN\_PROC and the system starts tracking scores for each Participant. ## Change competition You can change the Competition header attributes by clicking on `More Methods > Change Competition`:

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

### Change the metric To change the Metric, first ensure the Competition status is set back to PREPPING. Then, click the **Configure Metric** button:

Update the Metric as required and click on **Execute**:

### Change the timeframe {% hint style="info" %} To change or delete a Timeframe, first ensure the Competition status is set back to PREPPING. {% endhint %} Highlight the Competition and click 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, first click on the **Participants** button, then highlight the required participant and click on the **Delete** button.

### Finish the competition manually A Competition can be finished earlier if needed, by clicking on `More Methods > Set to Finish`. The status must be IN\_PROC (In Process).

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