Advanced rules for request types
You can create advanced rules that include logic to automatically populate a specific request field based on user entries. You can also use advanced rules to automatically change field attributes such as whether the field is visible or hidden and editable or read-only.
Before configuring advanced UI rules
Configuring advanced default rules requires knowledge of SQL or JavaScript.
We recommend that you review the following before you configure advanced UI rules:
Create advanced request type rules
Follow steps below to create advanced UI rules for request types.
-
Log on to PPM.
-
On the Open menu, click Administration > Open Workbench to open the PPM Workbench.
-
On the shortcut bar, click Demand Mgmt > Request Types.
-
Open a request type for which you want to create an advanced rule.
-
In the Request Type window, click the Rules tab.
-
Click New to open the Request Type Rules window.
-
In the Rule Name field, type a name for the rule.
-
In the Description field, type a short description of the rule.
-
To implement this rule, in the Enabled? field, select Yes.
-
From the Rule Event list, select an event to trigger the rule. For details on the selectable events, see Rule Event Behavior on the Request Details Page.
-
From the Rule Type list, select Advanced and click Yes to continue.
The Request Type Rules window switches to the advanced mode.
-
If the results of the new rule might trigger rules defined for the same event (same dependency) that occur later in the rules sequence, and you want to prevent that from occurring, select No for the Processing cascading rules? option.
-
To set up a dependency:
-
In the Dependencies section, click New.
-
Use the Field list to select a field to trigger the rule.
Tip: After the Validate window opens, expand it to the right so that you can view all displayed columns.
Note: You cannot configure request default rules to trigger from a multiple select auto-complete. Do not select a multi-select auto-complete field.
After you select a field, the following read-only fields are populated:
-
Field Type. Displays the type of field you selected.
-
Validation Name. Displays the type of validation (such as CRT - Assigned To - Enabled) for the field you selected.
-
Visible Token. Displays the name of the visible token (such as
REQ.ASSIGNED_TO_NAME
) for the selected field. -
Token. Displays the name of the token, (such as
REQ.ASSIGNED_TO_USER_ID
) for the selected field.
The field you select determines which items are available in the Condition list.
-
-
From the Condition list, select one of the following:
-
A condition such as is null,contains any value, or is not null.
-
A condition to use to compare the value in the selected field with a constant, which you must then specify.
-
A condition to use to compare the value in the selected field with a value in a different field, which you must then specify.
-
-
If you selected a condition other than is null, contains any value, or is not null, then from the list displayed to the right, either leave constant value selected or select another field value.
-
Do one of the following:
-
If you selected constant value, provide the value for comparison in the Value field. The format of the Value field varies depending on the specific field, such as a list, auto-complete, or text box.
Caution: If your PPM instance supports multiple languages, and you specify a numeric field as a dependency, make sure that you always use the English format to specify field values.
Example: Suppose a request type includes a numeric field, and you want to create a rule that triggers an event when the field is set to the constant value 1234.56. In this case, make sure that you use the English variant without a group separator.
-
If you selected another field value, use the Field auto-complete to select the field for value comparison.
Caution: If your PPM instance supports multiple languages, and the other field value you specify is a numeric field, make sure the values for the other field use the English format.
-
-
Click OK.
The dependency you created is listed in the Dependencies table.
-
-
In the Results section of the Rules window, click New.
-
Use the Field auto-complete to select a field for automatic population or to change attributes like read-only or hidden as specified by the rule.
-
Click OK to close the window, or click Add to continue specifying another field.
The Result Fields table lists the fields you selected.
-
To specify a rule that controls the behavior of the field(s) listed in the Result Fields table, do one of the following:
-
To specify an SQL-based rule to populate the fields:
-
In the Logic list, select SQL Default.
-
In the Logic field, enter the SQL statement that loads values into the field(s) you added to the Result Fields table section.
Each
SELECT
value is loaded into its corresponding column in the Results table in order. The system validates the SQL statement to ensure that it includes the correct tokens:[SYS]
tokens,[AS]
tokens, or tokens corresponding to the fields in the Dependencies section. If the SQL statement is invalid, an error message is displayed. -
To specify a JavaScript-based rule that changes field behavior (for example, showMessage, setFieldRequired, or setFieldVisible) but does not populate fields with values:
-
In the Logic list, select UI Rules.
-
In the Logic field, enter the JavaScript function.
Caution: For the validation purposes, you cannot just type any JavaScript in the Logic text box in the Rules window. You must use a function defined in the RequestRulesSystemLibrary.js or RequestRulesUserLibrary.js file.
Tip: To view a list of the available JavaScript functions, their descriptions, syntax, and usage, to the right of the Logic list, click ?. This list automatically includes all functions defined in both the RequestRulesSystemLibrary.js and RequestRulesUserLibrary.js files.
-
-
-
Click OK.
-
Click Save.
See also: