Defining Validate Approver rules


Use a Validate Approver rule to verify approver names when they are manually entered on an approval request. This rule applies to either an Ad Hoc process type or an ad hoc override.

This rule validates the approver name at the time of entry by searching for a match to the entered name on a specified form, for example, a signature authority form such as AP-Sample:Signature Authority in the sample application.

You can define any number of Validate Approver rules, which allows you to search more than one form to validate an approver name. 

Warning

Approver names in Validate Approver rules are case-sensitive. Make sure approver names are entered correctly by providing a menu of names for requesters to select from. For more information, see Defining-application-menus.

To define a Validate Approver rule

  1. Complete the basic information about the rule.
    For more information, see Creating-a-rule.
    • Select Validate Approver from the Rule Type list.
    • (Optional) The rule condition in the Run If text box. Use this field to define a conditional statement that controls whether the rule is executed.
  2. Click the Set Fields tab.
  3. In the Set Fields Type field, select the appropriate action type. For more information, see Defining-actions-for-a-rule.
  4. For a query, select a form name from the From Form menu.
    This value indicates in which form to search for the query.
  5. In the On Server field, select the server where the form is located.
    • Current—The form exists on the current server.
    • Alternate—The form exists on another server. Enter the remote server name in the Server field.
  6. Depending on the action type, enter the qualification statement or command line in the Qualification area.
  7. In the Fields Data area, enter the name of the field or fields to receive the data in the Field Name column, and a value statement or the name of each source form field in the Value column.
  8. Click Save.

Example of a Validate Approver rule

The following figure illustrates an example of a Validate Approver rule from the Get Agreement sample application. On the Set Fields tab, the qualification condition causes the rule to search the Login Name field of the User form to find a match for a name entered in the approver field ($Approver$) of the approval request form (AP-Sample2:Get Agreement).

Example of a Validate Approver rule

22_1_approval_rule_validate_approver.png


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*