| Cogitek RIATest 3 Documentation | Copyright © Cogitek Inc. |
A set of test scripts for your application is called a project. The Project defines the scripts themselves and in what order they will be executed. The Project View shows the Project Tree where all scripts contained in the project are shown. You can combine scripts into groups. You can change the ordering of the scripts (and thus execution order) by drag'n'dropping script items in the tree.
To create a new project
Select this option if you want a browser window (or your application) to be launched when project execution starts. This option may be disabled if you are testing something other than an application that can be loaded in a browser window. For example RIATest includes a RIAScript self-test project the purpose of which is verifying the syntax and operation of the RIAScript language itself. This sample project does not need a browser window.
You have 5 choices, which depend on your decision about which application loading scheme to select:
In browser application (RIATest Agent embedded)
If you have statically compiled the RIATest agent and automation libraries with your
application then select this option and in the Application URL or File field enter the location of your
application's wrapper HTML file (e.g. http://localhost/myapp/bin/app.html)
or file path of the wrapper HTML file (e.g. C:\My Projects\My
App\bin\app.html).
In browser, using local loader
If you want to use RIATest Loader and your application SWF file is located on
a local drive select this option. In the Application
SWF File field type the file path of your application SWF file. The path
can be absolute or relative to the project file location.
In browser, using remote loader
If you want to use RIATest Loader but your application is located on a web server
then select this option. In the Remote Loader URL field type the URL of RIATestLoader.html file that you uploaded to your server. In the Application SWF File URL field type the URL of your SWF file. This URL may be relative to the RIATestLoader.html file location on your server.
AIR application
Select this option for AIR applications and in Application XML File field type the file path your of your AIR application XML file. This file is usually located in "bin" or "bin-debug" folder of your application project and the name of the file usually matches your application name.
This option, if selected, will mean that RIATest will attempt to close the browser window (or application) after project execution finishes. You may want to unselect this option if for some reason you want to leave the browser window open after the test finishes. Note that for RIATest to be able to close the browser window it should have a separate process. This is usually the case for Internet Explorer. For Firefox all browser windows and tabs usually run under same process id which is not known to RIATest. It is possible to configure Firefox to use a separate process when opening a new window. For more details read about "profiles" in Firefox documentation.
This option, if selected, will mean that RIATest does not start executing script commands until it receives an incoming RIATest Agent connection. RIATest Agent normally connects to the RIATest IDE after the browser window opens and your application is loaded and initialized.
This option, if selected, will mean that RIATest can work with multiple Flex applications each with its own copy of Agent embedded. When this option is enabled the execution of scripts will not be terminated upon disconnection of an Agent (which is the default behavior when this option is not enabled).
Normally RIATest only accepts Agent connections when a project is running. When this option is enabled RIATest will accept Agent connections even if the execution is stopped. This option allows you to use RIATest as a developer productivity tool.