Action Properties

The Action Properties window has two tabs, the General tab and the Advanced tab. The buttons associated with each tab are described below. Clicking the Skip Wizard button in any Action Wizard dialog box will open the Action Properties dialog box.

If you provide an Action Name or Action Type, then click Skip Wizard, the name or type is transferred to the action editor. If an Action Type is not selected, by default Function is selected.

General Tab

The General tab allows you to view and/or edit basic action properties.

Button Text

This value will be displayed as the text for the button, unless a button image is provided.

Name

Use this field to specify a name for the action. This name will appear in the Action List window and is used internally. Action names cannot contain spaces and must be unique.

Description

This field contains a description of the action. It is optional and only used for informational purposes. If the action is created through the wizard, it is automatically created.

Pop-up Value

You can specify a pop-up value for actions. When you move the mouse over this button at runtime a pop-up will appear with this value.

Action Type

The Action Type indicates how the action is used. Valid action types are described in the Action Wizard Overview.

Additionally, any custom action created using the Skip Wizard button on the Action Wizard dialog box will have an action type of Function. This indicates a completely custom action.

Action types are also used to organize and filter actions in the Actions List.

Image

Actions can be displayed as images rather than standard buttons by providing the name of an image file.

Browse

Click the Browse button to navigate to a desired image file.

Image Width and Image Height

If the action is being displayed as an image, the image height and width fields are used to set the size of the action image.

Advanced Tab

The Advanced tab allows users to view and/or edit more advanced action properties.

Confirm Action

This allows you to specify that at runtime a user must confirm the action. If this box is selected, the text field becomes active and allows you to specify what message appears in the runtime confirmation dialog. The default message is:

Are you sure?

and the user must click Yes to proceed.

Automatically Branch to Next Logical Page when Action is Clicked

Selecting this check box causes Genesys Agent Scripting to generate a branch condition when the action button is clicked. It will either branch to the next script page or a page referenced in a branching condition on the current page. The branch occurs after any code defined for this action has been executed.

Skip Validation

Select this box if you want Genesys Agent Scripting to skip over all validation at runtime. This allows you to leave a page that has required fields without providing values for these fields (for example, when working with cancel buttons).

Note: If this option is checked and the action is called in a page unload action, the validation will not be skipped.

Show this Button If

Actions can be shown or hidden based on the value of a specific field. You may select a field from the first drop-down list and Genesys Agent Scripting will automatically determine the valid operators and range of values based on the type of field selected.

For example, if you select a check box type field, then only the equal and not equal operators will be selectable, and only the true and false values will be selectable. Similarly, if you select a radio button type field, then only the equal and not equal operators will be available, however, the Values drop-down list will list all possible values for the radio button. You can then select either a field or static value to compare it against.

Both the General and the Advanced tab include the following buttons:

Code

Clicking the Code button opens the Code for Action <action> dialog box, where <action> represents the Action Name previously selected.

Cross Reference

Clicking Cross Reference will bring up a list of all of the objects that use the field.

OK

Click OK to apply the changes you made.

Cancel

Click Cancel to cancel the operation.