The Argument Builder provides a dynamic graphical interface that enables you to construct complex argument expressions for use within Rule Builder.
Figure 3-3 Argument Builder
The Argument Builder consists of six separate sections:
Nouns: Contains a list of all of the available noun tokens. Double-click a noun token to add it to the Expression pane. See Noun Tokens for more information.
Verbs: Contains a list of all of the available verb tokens. Double-click a verb token to add it to the Expression pane. See Verb Tokens for more information.
Description: Contains a brief description of the selected noun or verb token. Click the Help icon to launch additional help.
Expression: Contains the argument that is being built. Multiple noun and verb tokens can be added to a single argument. Tokens can be arranged in different orders through the Expression pane.
Editor: Provide the values for the nouns and the verbs in the Editor pane.
Toolbar: Allows you to manipulate the noun and verb tokens. See Table 3-2 for a list of all of the options in the toolbar.
Table 3-2 Argument Builder Toolbar Options
Option |
Description |
---|---|
Delete |
Deletes the selected token. |
Cut |
Cuts the selected token to the Clipboard. |
Copy |
Copies the selected token to the Clipboard. |
Paste |
Pastes the token from the Clipboard into the Argument Builder. |
Move Up |
Moves the selected token up. |
Move Down |
Moves the selected token down. |
Help |
Launches the help. |
Append noun |
Appends a noun token to the end of the argument as a sibling token. |
Insert noun |
Inserts a noun token into the argument. |
Append noun to child token list |
Appends a noun token as a child token instead of as a sibling token. |
Insert noun at beginning of child token list |
Inserts a noun token into the argument as the first child in the token list instead of as a sibling token. |
Append verb |
Appends a verb token to the end of the argument as a sibling token. |
Insert verb |
Inserts a verb token into the argument. |
Append verb to child token list |
Appends a verb token as a child token instead of as a sibling token. |
Insert verb at beginning of child token list |
Inserts a verb token into the argument as the first child in the token list instead of as a sibling token. |
You can select to trace each token or disable the tracing of the token in the Argument Builder. To disable tracing:
Click the trace icon to disable tracing.
To enable tracing:
Click the disable trace icon to enable tracing.
To launch the Argument Builder, select one of the following actions, then click the Edit the arguments icon .
Clear Destination Attribute Value (when the selected object is DN or Association)
Clear Source Attribute Value (when the selected object is DN or Association)
Delete Destination Object (when the selected object is DN or Association)
Delete Role (when the selected object is DN or Association)
Rename Destination Object (when the selected object is DN or Association and Enter String)
Rename Source Object (when the selected object is DN or Association and Enter String)
Set Destination Attribute Value (when the selected object is DN or Association and Enter Value Type is not structured)
The following example creates an argument for a username from the first letter of the first name and the entire last name:
Double-click Attribute from the list of nouns.
Specify or select the Given Name attribute.
You can browse the Identity Vault attributes, the application attributes, or launch the variable browser. For more information on the variable browser, see Variable Selector.
Double-click Substring from the list of verbs.
Type 1 in the Length field.
Select the Given Name attribute, then click the Move Down icon.
Double-click Attribute from the list of nouns.
In the Name field, specify or browse to the Surname attribute.
The argument takes the first character of the Given Name attribute and adds it to the Surname attribute to build the desired value.
Click Finish to save the argument.