Editing Task Properties

• [File name of the current project suite] - (Default) The name of the project suite to be run on the remote computer is considered the same as the name of the current project suite. The path to the target project suite is specified by the Base path property of the selected host. That is, the full path is determined as a concatenation of the host’s Base path and the current project suite name.

  For example, if the current project on the master computer is C:\Tests\MasterProjectSuite.pjs, and the host’s Base path is set to C:\DistributedTests\, the name of the project suite to be executed on the remote host is C:\DistributedTests\MasterProjectSuite.pjs.

  Use this default value if your current project stores both master and slave tests.

  If the Base path property of the host already contains a fully qualified name (not recommended) of the project or project suite on the remote computer and the Project file name property is not specified, the default value of the property is not used and the name of the project or project suite to be executed is specified by the Base path property only.

• Name (with the path) of the project (project suite) residing in a shared network folder - For example, \\TestServer\Tests\ProjectSuite.pjs.
• Name (with the path) of the project (project suite) residing on the host computer - The project file path must be specified in the terms of the remote computer. For example, C:\Tests\ProjectSuite.pjs. Note that instead of entering the project (project suite) path manually, you can click the ellipsis button and browser for the desired project in the subsequent Select Remote Project dialog.

  If the Base path is set for the host where the task is run, Project file name must be specified relative to the Base path. The full path is determined as a concatenation of the host’s Base path and the task’s Project file name values. For example, suppose that the project suite’s path on the host is C:\Tests\ProjectSuite.pjs. If the host’s Base path is set to C:\Tests\, the task’s Project file name should be ProjectSuite.pjs.

Tips:

• If several tasks are configured to run on the same host and use slave projects (project suites) located in the same folder, the project file name property of these tasks may contain partially or fully duplicated parts. To make it easier to edit and maintain these paths, you can remove the common part of the path from the tasks Project file name property and specify it in the Base path property of the host instead.

• If you want several tasks running on different hosts to use the same slave project, copy the project (project suite) to each slave host rather than use the common shared project (project suite). It is not recommended to use the common shared project (project suite) for several hosts since the slave hosts may fail to open the shared project (project suite) simultaneously.

• If the project (project suite) you want to run on the remote computer resides on the master computer, you can do any of the following:

  • Copy the desired project (project suite) from the master host to the remote host. For more information on this, see Copying Slave Projects to Remote Computers.

  • Share the master computer’s folder that contains the project or project suite (not recommended).

• [Always] - TestComplete copies the results to the master computer at the end of the task execution. Copying results increases the task execution time and uses some disk space, but you can review the results at anytime, even if the remote computer is not available. Copied results are kept on your computer until you delete them.

• [When status is not OK] - TestComplete copies the results to the master computer only if the log on the task execution includes errors and/or warnings.

• [Do not copy] - The task results remain on the remote computer. To view them, you must have access to the results folder. Storing results on the remote computer saves disk space on your computer, but you may not be able to view them, since the remote computer can be offline or the results folder may be inaccessible.

• [Nothing] - Do nothing (do not close TestComplete or TestExecute either). Use this value in combination with the Use value for the Use previous TestComplete instance option in order to reduce the workload of the remote computer. In this case, after finishing the task the TestComplete (TestExecute) instance on the remote host will not be closed and it will be used for running the next task.

• [Close driven instance] - Close TestComplete (TestExecute) instance on the remote computer. Default value.

• [Log off from computer] - Log off from the Host computer.

• [Shut down computer] - Shut down the Host computer.

• [Reboot computer] - Reboot the Host computer.

To run the entire project, enter the project name only.

To run the entire project suite, keep the column empty.

Note: The tasks cannot run separate test items (the ones you specify on the Test Items page of your project). They can only run test items as part of the project.

Below are several examples of the possible column values:

To select an execution entity of the remote project specified by the Project file name property, you can click the ellipsis button and choose the desired entity from the Select Remote Test dialog.

Note: If Test specifies a script routine, that routine must have no parameters.

• [Use previous TestComplete instance] - Use the running instance of the remote TestComplete (TestExecute). Use this value in combination with the Nothing value for the Action after run option in order to reduce the workload of the remote computer. In this case, after finishing the task, the TestComplete (TestExecute) instance on the remote host will not be closed and it will be used for running the next task.

• [Show error message] - Display the error message. Default value.

• [Restart TestComplete] - Close and restart the remote TestComplete (TestExecute) instance. Use this value to ensure that the task will not fail if previous tasks or test runs caused critical errors in the remote TestComplete (or TestExecute) instance.