4.3 Argument Builder

The Argument Builder provides a dynamic graphical interface that enables you to construct complex argument expressions for use within Rule Builder.

Figure 4-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 4-2 for a list of all of the options in the toolbar.

Table 4-2 Argument Builder Toolbar Options

Option

Description

Delete icon Delete

Deletes the selected token.

Cut icon Cut

Cuts the selected token to the Clipboard.

Copy icon Copy

Copies the selected token to the Clipboard.

Paste icon Paste

Pastes the token from the Clipboard into the Argument Builder.

Up arrow Move Up

Moves the selected token up.

Down arrow Move Down

Moves the selected token down.

Help icon Help

Launches the help.

Append noun Append noun

Appends a noun token to the end of the argument as a sibling token.

Insert noun icon Insert noun

Inserts a noun token into the argument.

Append noun Append noun to child token list

Appends a noun token as a child token instead of as a sibling token.

Insert noun 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 Append verb

Appends a verb token to the end of the argument as a sibling token.

Insert verb Insert verb

Inserts a verb token into the argument.

Append verb Append verb to child token list

Appends a verb token as a child token instead of as a sibling token.

Insert verb 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:

  1. Click the trace icon to disable tracing.

    Disable tracing

To enable tracing:

  1. Click the disable trace icon to enable tracing.

    Enable tracing

4.3.1 Launching the Argument Builder

To launch the Argument Builder, select one of the following actions, then click the Edit the arguments icon Edit arguments icon.

4.3.2 Argument Builder Example

The following example creates an argument for a username from the first letter of the first name and the entire last name:

  1. Double-click Attribute from the list of nouns.

    Attribute token
  2. Specify or select the Given Name attribute.

    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 Section 3.6, Variable Selector.

  3. Double-click Substring from the list of verbs.

    Substring token
  4. Type 1 in the Length field.

    Length field
  5. Select the Given Name attribute, then click the Move Down icon.

    Move down icon
  6. Double-click Attribute from the list of nouns.

  7. In the Name field, specify or browse to the Surname attribute.

    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.

  8. Click Finish to save the argument.