How to create a custom script

1. Script Syntax
2. Text Commands
3. Mouse Click Emulation
4. Delay Execution
5. Submit Marker
6. Clear Text Field
7. Switch to Active Window
8. Script Example
9. Using GoTo URL and Match URL in a Login

NOTE: In order to use custom scripts in RoboForm, you will first need to add a Script field. To view our tutorial on adding a Script field to a Login, click here.

After adding a Script field, write a script in the space provided. You can program the sequence of keyboard key presses and mouse clicks to be executed by the "Fill Form" and "Fill & Submit" / "Login" commands (see below).

For example:

$u
ENTER
$p
SUBMIT:
ENTER

Script Syntax

A Script is a sequence of commands, separated by space characters (spaces, tabulation, new lines):

<command1> <command2> <command3>

‘#’  is a comment symbol. Part of the string from '#' to the end of the line is ignored.

Text Commands

Text commands are used to send characters to the application window, emulating keyboard input.

1) Literal string

"<text_string>"

A quoted character string, ANSI or UNICODE is sent to the application window.

Escape codes like \n, \r, \t are not supported.

2) Password and User ID fields

$p – a string from Password field

$u – type value of the User ID field

3) Other Login fields

%<field_name>%

<field_name> can be specified partially, i.e., only control ID or caption.

4) Special keys

Available key names:

SPACE, TAB, ENTER, ESC,

UP, DOWN, LEFT, RIGHT,

HOME, END, PGUP, PGDOWN,

 INS, DEL, BACK, F1- F12

SHIFT CTRL ALT

<key_name>  

press and release key
 

<key_name>+

press a key
 

<key_name>-

release a key

Mouse Click Emulation

*<x>,<y>

Mouse click at coordinates specified relatively to left top corner of window.

Delay Execution

DELAY <seconds>

<seconds> – a number of seconds, it can have a fractional part. Fraction must be separated with a point. There must be a space between the command and the number.

Submit Marker

SUBMIT:

This label separates filling and submitting parts of the script. The part after the label is executed only by the "Fill & Submit" command and not by "Fill Forms."

Clear Text Field

CLEAR

This command is a shortcut for the following sequence of script commands:

HOME SHIFT+ END SHIFT- DELETE

Switch to Active Window

POPUP

To prevent the typing of private/sensitive information into the wrong window, RoboForm prevents typing and mouse click to any windows other than the window selected as the target of the "Fill Forms" or "Fill & Submit" commands. The POPUP command switches the target to the current active window.

Script Example 

*100,200     # click at (100,200) in the window

"uoydellortI" TAB # type string and press TAB key

$u TAB        # type value of User ID field and press TAB key

$p TAB        # type value of Password field and press TAB key

DELAY 1.5   # delay for 1.5 seconds

SUBMIT:      # next lines are used to submit the data

SHIFT+ ENTER SHIFT- # press SHIFT+ENTER

Using GoTo URL  and Match URL in a Login

GoTo URL 

Is used to start the application and provide command-line parameters. 

Format: 

exe://"<path_to_executable>" <command_line_arguments>

The 'exe://' prefix specifies that this Login is used for fill data in a Windows application and not in a web browser.

<path_to_executable> – full path to the application executable file. RoboForm uses this path to start the application. E.g.: C:\WINDOWS\explorer.exe

<command_line_arguments> – command line arguments that should be passed to the application.

 

Match URL 

Is used to find the exact window for the Login.

Format:

exe://<name_of_executable>/<window_title>

<name_of_executable> – file name of the application executable file without extension. E.g: explorer

<window_title> – text of the window title.  It can contain '*' as a wildcard at the start or the end.

Samples:

exe://<name_of_executable>/<window_title> – exact match

exe://<name_of_executable>        – any title

exe://<name_of_executable>/*     – any title

exe://<name_of_executable>/*<substring>*

exe://<name_of_executable>/<substring>*

exe://<name_of_executable>/*<substring>