PROMPT

From iMacros
Jump to: navigation, search

Displays a popup to ask for a value. This value is stored in variable_name. This command can be used to change the variables !VAR1, !VAR2 or !VAR3, but not built-in variables like !DATASOURCE or dynamically generated variables.

Syntax iMacros Browser IE Plug-in Firefox Chrome

PROMPT prompt_text variable_name [default_value]

Note: Using the PROMPT command with IE

Parameters

  • prompt_text
    The text which is to be displayed above the input text field. If the text includes embedded spaces, surround the text with double-quotes *or* replace spaces with <SP>.
  • variable_name
    Name of the variable to save the user input in (!VAR1, !VAR2 or !VAR3)
  • default_value
    Default value which will be displayed in the input field when the dialog comes up. Must not be a value of a built-in variable except !VAR1, !VAR2 or !VAR3.

Examples

If you do not want to save passwords (even encrypted) on your computer then use the following code to ask for the password:

PROMPT "Please enter your password:" !VAR1

However this requires the following SET and TAG commands to make use of the PROMPT input of a password

SET !ENCRYPTION NO
PROMPT "Please enter your password:" !VAR1 
TAG POS=1 TYPE=INPUT:PASSWORD FORM=NAME:loginbox ATTR=ID:pass CONTENT={{!VAR1}}

Note: the Set !ENCRYPTION is required in the script to turn off password encryption and the TAG command is required to enter the value into the password field, note the use of "{{}}" (double closed braces) on the variable name. For this sample to work on your site the POS, FORM and ATTR values may be different, just use the macro record feature to capture these values from your site and paste them into your macro.

Suppose you would like to ask for more then three inputs from the user. Since you only have three variables to use the PROMPT command for you might run into problems. The solution is to navigate to the site where you are going to fill the values in, then ask for the first three inputs, fill them into the website, ask for the next three values, fill them in etc.

The PROMPT command is also useful for debugging: Use it to show the values of variables. The dialog resizes with the length of the prompt_text input, so you can also use it show longer text.

PROMPT {{!EXTRACT}}
PROMPT {{!myvar}}

or

PROMPT  Extracted<SP>data:{{!EXTRACT}} !VAR1 myvar:{{!myvar}}

See Also

SET, CMDLINE, PAUSE, !SINGLESTEP