Edit Parameter Mapping dialog

Use this dialog to edit the action parameters associated with an action.

For more information, see:

• "New Action Link dialog"

• "Action Link Properties dialog"

• "What Are Action Parameters?"

This dialog is also displayed as:

Add Existing Action dialog

Components

Define Parameters

Use this area to define the action parameters. It includes the following components:

• Name — Use this column to view or enter the name of the parameter.

  For Navigate to a Web Page or Invoke an HTTP Request actions, to embed a parameter value anywhere within the URL, enter the token @{Name} where 'Name' is the value specified in the Name column below. There is no limit to the number of parameters that can be embedded.

• Prompt — Use this column to enter the prompt to be displayed to users, if the user is to provide the parameter value.

• Value — Use this column to enter the parameter value. Click the Change type of value button to select one of the following types of value and then specify the value:

  • Value — Select this option to specify a value and then enter the value in the field.

  • Session Variable — Select this option to use the value of a session variable, and then enter the name of the session variable in the field, or click the Show popular Session variables button (to the right of this field) and select a session variable from a list of commonly-used variables.

  • Repository Variable — Select this option to use the value of a repository variable and then enter the name of the repository value in the field.

  • Request Column — Select this option to display the "Choose Request Column dialog", where you select the column in an analysis whose value is to be used as the value of an action parameter.

    This option is available only when you are editing the parameters for an inline action added to an agent that is conditionally executed based on an analysis.

  • Column Value — Select this option to use a column value in your analysis criteria and then click the Column Value button and select the column.

    For example, suppose you have the Region and District columns in your analysis criteria and define an action link on the District column that maps a parameter to the Region column. When you execute that action link (by clicking on a district), the region value for that district is used. Note that in a pivot table, the mapped values depend on the current layout or state of the table.

    This option is available only when you are adding an inline action to an analysis.

  For more information on session and repository variables, see "Using Variables".

• Fixed — Use this column to specify whether to allow users to see but not set the parameter. Select this box to allow users to see but not set the parameter. Deselect this box to allow users to see and set the value.

• Hidden — Use this column to specify whether to hide the parameter from users. Select this box to hide the parameter from users. Deselect this box to show the parameter to users.

• Optional — Use this column to specify whether the parameter requires a value before the action can be executed. Select this box to make the value optional. Deselect this box to make the value required.

• Add Parameter — Use this button to add a parameter. (Whether you can add a parameter for an action, depends on the action type.)

• Delete Parameter — Use this button to delete a parameter.