SetFieldWithName
Description:
Set a Field on the current Document that has a Name matching the specified Text.
Format:
SetFieldWithName (integer Session ID (optional), string Text, integer Occurrence (optional))
|
Parameters: |
Integer |
Session ID (optional) |
Browser Occurrence Number.
First Browser occurrence is 1
Default value is 1 |
|
String |
Name |
Name of the Field.
Wildcards ('*') are allowed |
|
String |
Value |
Value to place in Field |
|
Integer |
Occurrence (optional) |
Name Occurrence Number.
First Name occurrence is 1
Default value is 1 |
|
Return Value: |
Boolean |
Success Ind |
Success Indicator.
TRUE – Field was set
FALSE – Field was not set |
Usage:
Use this function to set a Value in a Field (textbox) that has a name specified in Name on the current Document. Name is the internal HTML Name, not what is displayed on the Document.. For a way to set a Field by using its Label use the SetFieldWithLabel function. Wildcards can be specified in the Name Text string to match on partial displayed Name Text on the Document. The wildcard character is the asterisk ('*') and can be used on the beginning and/or end of the Name Text string. Use the optional Name Occurrence Number when more than one Name on the Document matches the Name Text string. Matches are not Case Sensitive.
Example 1:
Set a Field that has the Name of 'Password'.
SetFieldWithName ('Password', 'Cactus')
Example 2:
Set a Field for the second Name that displays the word 'Bird'.
SetFieldWithName ('Bird', 'Robin', 2)
Example 3:
Set the third Field that has the Name 'Product' at the beginning of the Name Text in the second occurrence of the Browser.
SetFieldWithName (2, 'Product*', 3)