Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

DownloadFile

This action clicks the link/element which will populate a download window, and then downloads the file.

The action supports and is explicitly tested for FF3, IE7, IE8. The action will not wait till the file is downloaded, this have to be handle externally by the user.

This action requires AutoIt to be installed.

  1. Install AutoIT from the location http://www.autoitscript.com/site/autoit/downloads/
  2. Click on Download AutoIt v3.
  3. Choose full installation.
  4. After the set up is completed, AutoIT installation path should be set against the Qualitia's configfile key "AutoITPath"

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

folderName

The path where the file is to be download. Please check Table 1 "Parameter Mandate" to validate in the situation where this parameter will be mandatory. In case the parameter Mandatory; the user should take care that the folder path exists. The action does not validates whether the folder exist

Yes

String

Filename

The filename of the downloadable file, to be given incase the user requires to give specific name and not depend on the default name of the file. In case, the file already exist, similar window like below will appear. Such windows are not handled by the action. Incase, the user does not provide this data, the action will pick the default file name available while download. This parameter is not mandatory

Yes

String

Expand
titleImportant Notes:
1. During execution, IE blocks download window. You will get a similar message below. 
Image Removed 
Because of this IE restriction, the download window will not appear, leading to unexpected behavior. To avoid this, please follow the settings below: 1. From Internet Explorer, click Tools, and then click Internet Options. The Internet Options dialog box appears. 2. Click the Security tab. The Internet Options dialog box shows your security levels and zones. 3. Select the Internet zone, and then click Custom Level. The Security Settings dialog box file downloads. 
For further details, please check: http://msdn.microsoft.com/en-us/library/dd565669 
2. When a download window is populated, the following window will also exist. 
Please make sure to check the checkbox "Close this dialog when download completes". Usually, the checkbox is checked by default. If not, please check it manually once. Qualitia action "DownloadFile" does not handle this window. The execution will not be hampered by this, but it's just that unwanted window will be open.
Image RemovedImportant Notes for Firefox: 
Firefox uses the default Firefox instance:- 
Image Removed 
Above will be the default download setting for the default firefox instance. Hence, according to the setting the files will be downloading into the predefined location, here its "Desktop". During execution, the action will select "Save file" from a window similar to below and accordingly the file will be downloaded to desktop by firefox.
Image Removed 
Table 1: Parameter Mandate

Browser

locator

folderPath

fileName

Internet Explorer

Mandatory

Mandatory

Not mandatory

Firefox [Default instance invoke my Selenium]
Image Removed
Above is the default download setting in the default Firefox instance invoke my Selenium.

Mandatory

Mandatory

Not mandatory

Example 
DownloadFile               "C:/ProgramData"           "Qualitia" 
Note:This action is tested on IE8,FF& chrome. This action is not supported on IE9,IE10,chrome<16.
Multiexcerpt include macro
nameDownloadFile
pageWebButton Actions

On this page:

Table of Contents
maxLevel2
minLevel2
absoluteUrltrue

VerifyExistence

This action verifies the existence of the specified object. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

existence

Data type of this parameter is can be true or false.
If True – checks if the page exists
If False – checks if the page does not exist

Yes

TRUE

Example:
VerifyExistence                        "True"

VerifyVisibility

This action verifies the visibility of the specified object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

visibility

Data type of this parameter is can be true or false.

If True – checks if the page is visible
If False – checks if the page is not visible

Yes

String

Example
VerifyVisibility            "True"

Click

This action clicks the specified object

Example:
Click

StorePropertyValue

This action stores the property value of the specified object against a key name. The stored value can be retrieved by using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

key

Variable in which the property value will be stored

Yes

String

Property

Property/attribute name of the object whose value needs to be stored.
This can be any apt attribute of that html object.
This action also supports "text" as the property. "Text" property will retrieve the inner text of an element.

Yes

String

Example:
StorePropertyValue                          "value"          "name"

MouseOver

This action simulates the user hovering mouse over the specified object.

Example:
MouseOver

MouseDown

This action simulates user pressing the left mouse button at the specified location.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

MouseDown              "5"        "10"

MouseUp

This action simulates the event that occurs when the user releases the mouse button.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

MouseUp              "50"           "38"

ClickAt

This action clicks at the particular point on the object.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

X

The x-coordinate to click.

Yes

String

Y

The Y-coordinate to click.

Yes

String

Example:

ClickAt            "60"         "67"

SetFocus

This action moves the focus to the specified web element.

Example:

SetFocus

Multiexcerpt include macro
nameVerifyExistence
pageWebButton Actions


Multiexcerpt include macro
nameVerifyVisibility
pageWebButton Actions


Multiexcerpt include macro
nameClick
pageWebButton Actions


Multiexcerpt include macro
nameStorePropertyValue
pageWebButton Actions


Multiexcerpt include macro
nameMouseOver
pageWebButton Actions


Multiexcerpt include macro
nameMouseDown
pageWebButton Actions


Multiexcerpt include macro
nameMouseUp
pageWebButton Actions


Multiexcerpt include macro
nameClickAt
pageWebButton Actions


Multiexcerpt include macro
nameSetFocus
pageWebButton Actions


Multiexcerpt macro
nameDoubleClick

DoubleClick

This action double-clicks the particular web element.

Example:
DoubleClick


Multiexcerpt macro
nameRightClick

RightClick

This action right-clicks the specified web element.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

option

The context menu option number that needs to be clicked.

Yes

String

Example:
RightClick             "3''

This will select the third option from the context-menu. 

WaitForObject

This action waits for the object to exist or not exist for the maximum no of seconds specified.

If the object is found or not found before the maximum time specified, the action shall stop waiting.

If the wait time is "" then the wait time shall be the "Sync Time" time set on the Qualitia Configuration (Execution) window.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

waitTime

The maximum no of seconds to wait for the object to exist or not exist
This has to be 0 ,"",or a positive integer value

Yes

String

existence

Boolean value to specify if the object should exist or not.

Yes

String

Example
WaitForObject           "10"            "true"
The action shall wait for maximum 10 seconds for the object to exist. If the object exists before 10 seconds elapses, the wait shall be over.

WaitForObject         "15"          "False"
The action shall wait for maximum 15 seconds for the object not to exist. If the object does not exist before 15 seconds elapses, the wait shall be over.

ClickAndWait

This action clicks the page object and waits.It waits for the maximum sync time set in the Qualitia Configuration (Execution) window for key Sync Time. If the page page loads before the maximum sync time, then the action will stop waiting.

Example:
ClickAndWait

NoteIn Webdriver we wait for the document to come in ready state. If it is in ready state it is assumed that the page is loaded completely and Webdriver will stop waiting. The condition to wait till the document is in ready state and assume that the page is loaded could however not work as expected at all times.


Multiexcerpt include macro
nameWaitForObject
pageWebButton Actions


Multiexcerpt include macro
nameClickAndWait
pageWebButton Actions


Multiexcerpt macro
nameDragandDrop

DragAndDrop

This action drags and drops the specified web element at the specified location. 

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

offsetX

Offset in pixels from the current location to which the element should be moved. The offset parameter can be as +100,100 , -100, 10,…

Yes

String

offsetY

offset in pixels from the current location to which the element should be moved The offset parameter can be as -100,100 , +100

Yes

String

Example:
DragAndDrop            "

-

100"           "500"

StoreExistence

This action stores the existence of an object under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the existence (true/false) of the object is stored.

Yes

String


Example:
StoreExistence                             "Key"

StoreChildCount

This action stores the child count of the specified object under the key name. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

Key

The variable in which the child count will be saved.

Yes

String

Example:

StoreChildCount                               "Key"

ScrollIntoView

This action scrolls to view the specified object. 

This action does not have any parameters. 

Example:

ScrollIntoView

true
Insert excerpt
WebButton ActionsWebButton Actionsnopanel
Multiexcerpt include macro
nameStoreExistence
pageWebButton Actions


Multiexcerpt include macro
nameStoreChildCount-withoutlocator
pageWebButton Actions


Multiexcerpt include macro
nameScrollIntoView
pageWebButton Actions


Multiexcerpt include macro
nameClickJS
pageWebButton Actions


Multiexcerpt include macro
nameActionClick
pageWebButton Actions