Skip to content

RAW - NON POSITIVE

Description

The NON POSITIVE validator checks if an item is a positive number, and if so, it throws a violation. It is designed to ensure that numeric data points do not contain positive values, allowing only negative numbers or zero. This validator is particularly useful for scenarios where only non-positive values are acceptable.

Supported Data Types

The NON POSITIVE validator supports all numeric data types, including:

  • Integer
  • Decimal
  • Double

Config Location

The configuration for the NON POSITIVE validator is defined within the <rawDPValidator> element of a schema data point. This section is crucial for specifying the logic that the validator will execute to determine if the data item meets the specified criteria.

Config Requirements

For the NON POSITIVE validator, the <config> element is not required. This means that the validator can be applied directly to numeric data types without the need for additional configuration parameters.

Example Config

Below is an example of a NON_POSITIVE raw validator configuration. This validator checks if the current item is not positive, and throws a violation if the condition is not met.

1
2
3
4
5
<dataPoint name="QUANTITY" dataType="INTEGER">
    <rawDPValidators>
        <rawDPValidator name="CHECK_NON_POSITIVE" execPriority="10" entity="NON_POSITIVE"/>
    </rawDPValidators>
</dataPoint>

Example Results

Consider a scenario where the NON_POSITIVE validator is applied to a data item named "QUANTITY" with a value of -5. Since the value is negative, the validator will pass successfully without throwing a violation.

On the other hand, if the value of "QUANTITY" were 3, the validator would throw a violation because the value is positive, which is not acceptable according to the validation criteria.

Common Mistakes

  • Ensure that the data type of the data item being validated is numeric. The NON POSITIVE validator is designed to work with numeric data types only.
  • Remember that the NON POSITIVE validator does not require a <config> element, so ensure that the validator is correctly applied to the data item without additional configuration.
  • Verify that the entity attribute of the <rawDPValidator> element is correctly set to "NON_POSITIVE" to apply the NON POSITIVE validation logic.