Skip to content

RAW - POSITIVE

Description

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

Supported Data Types

The POSITIVE validator supports all numeric data types, including:

  • Integer
  • Decimal
  • Double

Config Location

The configuration for the 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 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 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_POSITIVE" execPriority="10" entity="POSITIVE"/>
    </rawDPValidators>
</dataPoint>

Example Results

Consider a scenario where the POSITIVE validator is applied to a data item named "QUANTITY" with a value of 5. Since the value is positive, 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 negative, which is not acceptable according to the validation criteria. Similarly, if the value were 0 or null, the validator would also throw a violation.

Common Mistakes

  • Ensure that the data type of the data item being validated is numeric. The POSITIVE validator is designed to work with numeric data types only.
  • Remember that the 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 "POSITIVE" to apply the POSITIVE validation logic.