DisplayVariables

Item Description

Use with:

All

SecureLogin Version:

All

Type:

Action

Usage:

DisplayVariables [User Prompt] [Variable [Variable]...]

Arguments:

[User Prompt]


[Variables]

Optional, customized text to be displayed in the Enter SecureLogin Variables dialog box.

The name of the variables you want the user to be prompted for. If you don't specify the name of the variables, SecureLogin prompts for all variables that the script uses.

Description:

Displays a dialog box that lists the user's stored variables (for example, $Username and $Password) for the current application. The user can edit the variables from this dialog box.

For example, if the login is unsuccessful because of an incorrect username or password, the DisplayVariables command prompts the user to edit the stored username or password values. From that point, the login process proceeds as usual.

You can specify a particular variable to display. If the variables parameter is specified, DisplayVariables prompts only for the variables specified.

To replace the default prompt text in the Enter SecureLogin Variables dialog box, enter the replacement text in quotation marks after the DisplayVariables command. Limit the text to 90 characters.

If no variables are stored for the user the first time SecureLogin attempts to apply single sign-on to the application, the prompt will not be customized.

After variables are stored for the user, the prompt is customized when the script is run.

You can also customize the text in the prompt by using the SetPrompt command. See SetPrompt.

HINT:  You can use the OnException EnterVariablesCancelled command to prevent a user from canceling the DisplayVariables prompt.

Syntax Examples:

DisplayVariables
DisplayVariables "Enter your details"
DisplayVariables "Enter a new password" $Password
DisplayVariables "Enter your username and password" $Username $Password
DisplayVariables "" $Username $Password

Example:
Windows script
The Wrong Password dialog box is detected. SecureLogin prompts the user to enter a new username and password for it to use. After these have been specified, SecureLogin enters them into the dialog box and clicks OK.

 
# Wrong Password Dialog Box 
Dialog  
   Class #32770 
   Title "Wrong Password" 
EndDialog
DisplayVariables "Enter a new username and password" $Username $Password 
Type $Username #1001 
Type $Password #1002 
Click #1