Share via


How to: Author User Defined Constraints

In the Settings and Constraints Editor, you can specify a user-defined constraint with a custom error message.

Note

Many settings and the corresponding constraint values are treated as strings. Therefore, the format of the user-defined constraint values associated with such settings must match exactly in the casing, order, and punctuation of characters and white space for the compiler to detect that the constraint has been met. For complex settings with constraint values that consist of multiple values, all values must match for the constraint to be met.

To create a user-defined constraint

  1. Select the application, endpoint, zone, or logical server for which you want to define the constraint.

  2. Open the Settings and Constraints Editor.

  3. Select the User Defined check box.

  4. Under User Defined, select additional check boxes as needed to access groups of settings.

  5. For each group of settings, select the check box for individual settings to include them in the constraint.

  6. Specify the appropriate operator in the Operator column.

  7. Specify required setting values in the Value column.

    For each setting value, you have the option to specify a custom error message that will appear if the constraint fails as a result of this setting. How to set error messages is explained in the following procedure.

To set a custom error message

  1. Under Error Message, click the ellipsis.

    The Error Text dialog box appears.

  2. Enter the text of the custom error message.

    Use the macros provided to enter placeholders for items such as setting name, required value, Help URL, and current value.

  3. Click OK to set the custom error message.

See Also

Concepts

User Defined Constraints