Exception

 

Description

Raises a fatal exception with a specified message at time of parsing to be used to abort a process and raise an exception handler.

 

Arguments

1.Exception - Name of the Macro.

2.Message - A message to throw inside of an exception when the macro is parsed.  If blank no exception will be thrown.

3.Case Sensitive - If true the comparison is case-sensitive; anything else is case-insensitive (the default).

4.Input Value - A value expression to test for a match and to pass through if no match is detected.

5.Match Value 1 - A match value that will cause the message expression to be thrown as an exception if it is equal (case-sensitive) to the input expression.

6.Match Value N - A match value that will cause the message expression to be thrown as an exception if it is equal (case-sensitive) to the input expression.

 

Examples

[Exception|This is an error]

Throws a fatal exception with the text This is an error in the message

 

[Exception|[Blank]]

Does nothing because the message is empty after the [Blank] macro resolves.

 

[Exception|[CASE|[DateFormat||dd]|WHEN|01|THEN|Cannot be run on the 1st|ELSE|]]

Throws a fatal exception with the text Cannot be run on the 1st in the message only if it is the 1st of the month

 

[Exception|This is an error|false|[Option|Code]|None]

Throws a fatal exception with the text This is an error in the message if the [Option|Code] equals None otherwise returns an the value of [Option|Code].

 

[Exception|This is an error|false|[Option|Code]|None|All]

Throws a fatal exception with the text This is an error in the message if the [Option|Code] equals None or All otherwise returns an the value of [Option|Code].

 

Notes

Use this to implement business rules to stop a process or cause an action to fail.

 

Copyright © 2024 pasUNITY, Inc.

 

Send comments on this topic.

Created with an evaluation copy of HelpSmith.
To remove this notice, you should purchase the full version of the product.