class staticbo.commonRules. DependencyRule
Source: common-rules/
The rule ensures that the changes of the property value start the rule checking on the dependent properties as well.
Property
new DependencyRule(primaryProperty, dependencies, message[, priority][, stopsProcessing])
Creates a new dependency rule object.
Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
primaryProperty |
|
The property definition the rule relates to. |
|
|
dependencies |
(bo.shared.PropertyInfo or Array of bo.shared.PropertyInfo) |
|
A single dependent property or an array of them. |
|
message |
string |
|
Human-readable description of the rule failure. |
|
priority |
number |
Yes |
The priority of the rule. |
|
stopsProcessing |
boolean |
Yes |
Indicates the rule behavior in case of failure. |
- Extends
- bo.rules.ValidationRule
- Throws
-
Argument error: The primary property must be a PropertyInfo object.
-
Argument error: The dependencies must be an array of PropertyInfo objects or a single PropertyInfo object.
-
Argument error: The message must be a non-empty string.
Property
read-onlyruleName
string
The name of the rule type. The default value usually the name of the constructor, without the Rule suffix.
- Inherited from
- bo.rules.RuleBase#ruleName
Methods
addAffectedProperty(property)
Adds an additional property that is influenced by the rule.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
property |
|
|
An affected property influenced by the rule. |
- Inherited from
- bo.rules.ValidationRule#addAffectedProperty
- Throws
-
Argument error: The affected property must be a PropertyInfo object.
addInputProperty(property)
Adds an additional property to the rule that will use its value.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
property |
|
|
An input property that value is used by the rule of. |
- Inherited from
- bo.rules.ValidationRule#addInputProperty
- Throws
-
Argument error: The input property must be a PropertyInfo object.
abstractexecute(inputs) → (bo.rules.ValidationResult or undefined)
Ensures that the changes of the property value start the rule checking on the dependent properties as well.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
inputs |
Array of any type |
|
An array of the values of the required properties. |
- Returns
-
(bo.rules.ValidationResult or undefined)Information about the failure.
protectedgetInputValues(getValue) → object
Returns the values of the properties that are used by the rule. This method is called by the rule manager internally to provide the values of the input properties for the execute() method.
Parameter
| Name | Type | Optional | Description |
|---|---|---|---|
|
getValue |
|
|
A function that returns the value of a property. |
- Inherited from
- bo.rules.ValidationRule#getInputValues
- Throws
-
Argument error: The getValue argument must be a function..
- Returns
-
An object that properties hold the values of the input properties of.
initialize(primaryProperty, message[, priority][, stopsProcessing])
Sets the properties of the rule.
Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
primaryProperty |
|
|
The property definition the rule relates to. |
|
message |
|
|
Human-readable description of the rule failure. |
|
priority |
|
Yes |
The priority of the rule. |
|
stopsProcessing |
|
Yes |
Indicates the rule behavior in case of failure. |
- Inherited from
- bo.rules.ValidationRule#initialize
- Throws
-
Argument error: The primary property must be a PropertyInfo object.
-
Argument error: The message must be a non-empty string.
result([message], severity) → bo.rules.ValidationResult
Returns the result of the rule executed.
Parameters
| Name | Type | Optional | Description |
|---|---|---|---|
|
message |
|
Yes |
Human-readable description of the rule failure. |
|
severity |
|
|
The severity of the failed rule. |
- Inherited from
- bo.rules.ValidationRule#result
- Returns
-
The result of the validation rule.