Raising a Trigger's Optional Declaratively-Configured Error Message
In contrast with a validation rule where the declarative error message is mandatory, when you write a trigger it is optional.
Since any return value from a trigger's script is ignored, the way to cause the optional
error message to be shown to the user is by calling the adf.error.raise()
method, passing null
as the single argument to the function. This causes the
default declarative error message to be shown to the user and stops the current transaction
from being saved successfully. For example, you trigger would look like this:
// Assume this is in a Before Insert trigger
if (someComplexCalculation() == -1) {
// raise an exception using the default declarative error message
adf.error.raise(null)
}