---
alias: user-guide-create-data-collection-limit-set
tags:
- data collection
description: "Create a data collection limit set by defining warning and error thresholds within a change set"
---

# Create Data Collection Limit Set

:lock: DataCollectionLimitSet.**Create**

## Overview

This operation is used to create and define warning and error limits to be applied to a given **Data Collection** at a given Step or Resource context.

## Setup

No specific setup is required other than to meet the precondition of the transaction.

## Preconditions

* The Data Collection exists and is active in the system.

## Sequence of Steps

There are several ways to create a new versioned object. Depending on the level, follow these steps to get started:

* Entity - in the landing page of this entity type in the **Business Data** menu or in the details page of an existing entity of the same type, select **New** on the top ribbon. For more information, see [Creating Entity Objects](../../general/creating_entity_objects.md).
* Revision - if you want to create a new revision, go to the **New** dropdown button on the top ribbon and select **Revision**. For more information, see [Revisions](../../general/revisions/index.md).
* Version - if you want to create a version associated to an existing revision, go to the **New** dropdown button on the top ribbon and select **Version**. For more information, see [Versions](../../general/versions/index.md).

### Step 1: Change Set

1. Select an existing **Change Set** or select **Create New** to create a new Change Set to be used for this purpose. If the support of Implicit Change Sets has been configured beforehand, it is also possible to check the option Use Automatic Change Set.
2. Optionally, select an Approver Role.

### Step 2: General Data

1. Enter a name for the **Data Collection Limit Set**.
2. If you are creating a new version, the revision that was selected when you started the process will be the revision to which this version will be associated. If you are creating a new entity or revision (with a new version associated to it), provide a name for the revision or it will be automatically generated for you. For more information, see [Revision Naming](../../../general/revisions#Naming/).
3. Optionally, enter a description.
4. Select the **Data Collection Limit Set** type. The list of possible values is taken from the lookup table `DataCollectionLimitSetType`.
5. Select the **Data Collection** to which the **Data Collection Limit Set** belongs. If the operation is called from the **Data Collection** wizard, the selection is automatic.

![create_data_collection_limit_set_step_one][create_data_collection_limit_set_step_one]

### Step 3: Parameters Limits

1. Manage the **Data Collection Limit Set** parameters (by using the :material-plus: and :material-trash-can: grid buttons to add and remove parameters), defining for each parameter:

    * Parameter name.
    * Whether to override the default Parameter validation range.
    * Optionally, the minimum possible value for the Parameter (applicable if the option to override the default Parameter range is set).
    * Optionally, the maximum possible value for the Parameter (applicable if the option to override the default Parameter range is set).
    * The limit type (Absolute or Relative). Relative limits always relate to the **Material** primary quantity.
    * Optionally, the lower error limit.
    * Optionally, the lower warning limit.
    * Optionally, the target.
    * Optionally, the upper warning limit.
    * Optionally, the upper error limit.
    * Optionally, select whether to include sample limits (only valid if the limit type is set to Absolute).

    ![create_data_collection_limit_set_step_two][create_data_collection_limit_set_step_two]

2. The following features are also available in this screen:

    * **Synchronize** - this option will enable the synchronization (by removing excessive parameters and adding the missing ones) between the **Data Collection Limit Set** parameters and the **Data Collection** parameters.
    * **Copy** - this allows you to copy the parameters from an existing **Data Collection Limit Set** by selecting the **Copy** button to later apply them to another **Data Collection**.

    ![create_data_collection_limit_set_step_three][create_data_collection_limit_set_step_three]

3. If you choose to include Sample Limits, these sample limits can be defined in the next dialog. Select the :material-plus: and :material-trash-can: buttons to add and remove sample limits for each parameter, defining for each sample limit:
    * Sample Id (mandatory)
    * Lower Error Limit
    * Lower Warning Limit
    * Target
    * Upper Warning Limit
    * Upper Error Limit

    ![create_data_collection_limit_set_step_four][create_data_collection_limit_set_step_four]

4. Select **Create** to complete the transaction and create the **Data Collection Limit Set**.

!!! warning
    After the creation of a version, the version will be in the state Created. To make it Active, the associated Change Set must be approved. To make it effective, the version must be Set Effective.

[create_data_collection_limit_set_step_one]: images/create_data_collection_limit_set_step_one.png
[create_data_collection_limit_set_step_two]: images/create_data_collection_limit_set_step_two.png
[create_data_collection_limit_set_step_three]: images/create_data_collection_limit_set_step_three.png
[create_data_collection_limit_set_step_four]: images/create_data_collection_limit_set_step_four.png