DisplayVariables

Item Description

Use with:

Startup scripts, Terminal Launcher, Web, Windows

SecureLogin Version:

All

Type:

Action

Usage:

DisplayVariables [User Prompt] [Variables]

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.

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:  Sometimes you will need to enter "dummy" variables in the script, depending on the placement of the DisplayVariables command. For the command to operate optimally, some $Variables must be listed after the command.

The OnException EnterVariablesCancelled command can be used to prevent a user from cancelling 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  
   Title "Wrong Password"  
   Class #32770 
EndDialog
DisplayVariables "Enter a new username and password" $Username $Password 
Type $Username #1001 
Type $Password #1002 
Click #1