Validation
When you save a Planning Engine Definition (PED), the class definition, optimization definition, workflow definition, and variable name defined for the engine are validated to ensure that correct AP language text syntax is used. You can also validate the Planning Engine details using the option.
The applicable error message is displayed for an invalid definition. These are the examples of the error message:
-
Invalid Planning Engine Definition {0}. Classes has invalid definition. Error: {1}. -
Invalid Planning Engine Definition {0}. Optimization {1} has invalid definition. Error: {2}. -
Invalid Planning Engine Definition {0}. Workflow {1} has invalid definition. Error: {2}. -
Invalid Planning Engine Definition {0}. Query {1} has invalid definition. Error: {2}. -
Invalid Planning Engine Definition {0}. Variable {1} has invalid name. Error: {2}.
A validation successful message is displayed if all the definitions are valid.
Cyclic validation
In addition to the existing validations, the application also performs cyclic property validation when you save or validate a PED. This ensures logical consistency and prevents runtime errors.
Example of cyclic properties: the properties refer to each other in a loop directly or indirectly creating an interdependent cycle.
- Cyclic properties through direct reference: direct cyclic property = direct cyclic property + non cyclic property;
- Cyclic properties through indirect reference:
- indirect cyclic property 1 = indirect cyclic property 2;
- indirect cyclic property 2 = indirect cyclic property 3;
- indirect cyclic property 3 = indirect cyclic property 1;
Note: When new validations are added, initially, the validation failure are reported as warning, to ensure users can rectify any errors. After a grace period (next GA), these validations are moved from warning level to error level. Please see latest release notes for any validations.
When you upgrade the application and new validations are introduced, all existing PEDs are re-validated. The status is updated, and any failures (warning or error) are recorded in the audit log.