Set Form Field Command


Navigation:  Agent Commands > Action Commands >

Set Form Field Command

Use this command to set input fields in a web form. The command supports the following types of web form fields:

Input fields

Select boxes

Text area fields

Check boxes

Radio buttons.


Note: Some web sites use advanced JavaScript to make web elements emulate standard form fields, and the Set Form Field command does not support those web elements.


Use a normal Navigate Link command to click on a submit button to submit the web form. The submit button can be a standard web form submit button or any other web element that uses JavaScript to submit the web form. A Navigate Link command is not required if one of the form fields automatically submits the web form when an input value changes.


  default data provider for standard text box  

        default data provider for radio button


        default data provider for a select box

Command Configuration

The configuration screen for the Set Form Field command has four tabs - Common, Action, Data and Properties. Use the Common tab to set the command name and select the data provider that provides the input values for the form field. The default data provider for a standard input form field or a radio button is a simple data provider that provides the input values. The input values for a radio button or check box must be either On or Off. The default data provider for a select box form field is a selection data provider. The default selection data provider will attempt to select all appropriate values in the drop-box (select-box), and the Set Form Field command uses those values as input values.


Use the Action tab to control how the web browser loads the URLs. See Action Configuration for more information.


Use the Data tab to configure a data provider that can provide the form field input values. The Set Form Field command can use the data provider configured on the Data tab, or it can use a data provider configured by a parent command. The Data tab is not available if the command uses a data provider from a parent command. See Using Data Input for more information about data providers.


Command Properties

The following properties are available to Set Form Field commands:



Data Consumer

Specifies the data provider, input parameter, or agent data that provides the input values for the command.

Set Select Box Text

If the chosen form field is a select box, then each of the input values will be set as a text attribute for each corresponding select options.

Set Value

Choose True if you always want the command to set the form field value. If you leave it as Default, the command will set the form field value if it is set to fire events - unless the form field is a checkbox or a radio button. We recommend that you leave this property set to Default unless an event function - such as sendtext() - is setting the form field value.

Only Execute Action on Value Change

Only executes the command action if the form field value changes. That is if the current input value is different from the current form field value.

Handle Web Browser Dialogs

When interacting with a file upload web browser dialog box, the command will cause a clicking of a dialog button having the name that is in the value of this property (&OPEN).

Download Document Command

Attempts to download a document when the form field value changes, and uses the Download Document command to capture and export the document.


These properties are also available to the Set Form Field command:

Data List Command Properties

Action Command Properties

Web Selection Properties

List Command Properties

Container Command Properties

Command Properties