Identity Management Service › User Console Design Guide › Validation Rules › How to Configure Validation Rules

How to Configure Validation Rules

Configure a validation rule by integrating it with Identity Management, and by directly or indirectly associating it with a task screen field.

How you configure a validation rule determines whether you want the rule applied to a field in a particular task screen (task-level validation) or a field in any task screen (directory-level validation), as follows:

• With task-level validation, you make a direct association between the rule and a field in a particular task screen. Validation is performed on the field in the context of that task screen only.
• With directory-level validation, the association between the rule and the task screen field is indirect, as follows:
  • In directory.xml, you specify the validation rule, add the rule to a rule set, and associate the rule set with a managed object attribute.
  • In the User Console, a field that is configured with the managed object attribute is validated against the rule set mapped to the attribute.

Validation is performed on any field configured with the attribute, regardless of the task screen that contains the field, and regardless of the Identity Management environment that contains the task screen.

How to Configure Task-Level Validation

Configure task-level validation in the User Console, when defining field properties on a profile task screen. The basic steps are as follows:

1. Navigate to the Field properties section of the profile configuration screen containing the field to be validated.

   Note: For more information about field properties, see the Administration Guide and the User Console online help.

2. Specify a value in one of the following fields, depending on how the validation rule is to be implemented:
   • Validation Expression. Contains a regular expression that performs the validation.
   • Validation Java Class. Contains the fully qualified name of a Java class that performs the validation, for example:

     com.mycompany.MyJavaValidator
     

     Identity Management expects the class file to be located in the root directory designated for custom Java class files.

   • Validation JavaScript. Contains the complete JavaScript code that performs the validation.

     You must provide JavaScript code in this field. With task-level validation, you cannot reference a file containing JavaScript code.

Note: For information about defining other field properties on a profile configuration screen, click the Help button on the screen.