GUI: Launch Application

Description

Launch Application opens a Windows desktop application at runtime by specifying its full file path. Use this step when your workflow needs to start an external application — such as a desktop tool, installer, or line-of-business app — before performing further GUI automation on it. You can configure an application startup time to wait for the application to fully load, and enable the Fail If Error Occurs option to validate that the application opened successfully by checking its window path or title. If validation fails, an optional Close Application on Failure setting can automatically shut down the application.

Configurations

Field Name	Description
Step Name	Name of the step. The name must be unique in a single workflow.
Path of Application	Specify the full path (including full path and filename with extension) of an application to launch.
Button: Browse	Click to browse the Application path.
Application Startup Time (In Seconds)	Specify a waiting period in minutes for application startup as specified in the Windows Path/Title above. Note: - You may manually check time taken by the application to load and come up with a better approximation of Application startup time. - If the user specifies the value as blank or 0, then the default value is 10
Fail If Error Occurs	Check Fail If Error Occurs to specify the property for application validation. Notes: 1. If Fail If Error Occurs is selected: • The Window Path/Title field will be enabled and required. • The Application Startup Time (In Seconds) will be an implicit wait time. • The Close Application on Failure will be enabled. • A run time error will occur if the Window Path/Title value or the environment variable is blank. 2. If Fail If Error Occurs is cleared: • The Window Path/Title field will be disabled and not required. • The Application Startup Time (In Seconds) will be treated as explicit wait time. • The Close Application on Failure will be disabled.
Properties for validation:	Note: The following fields are available only if you select the Fail If Error Occurs checkbox. Provide the following field values that you want to validate:
Windows Path/Title	Windows Path and Title are explained as follows: Windows Path is the relative path of the desktop application on which element exists. Enter Windows path manually in Step Configuration. Windows path may be provided as a String or regex. Sample of Windows Path as string: w[Desktop]/w[Application Name] OR Sample of Windows Path as regex: w[Desktop]/w[/Application N/], w[Desktop]/w[/Application .*/], If you are putting partial application name then put ii as a regex between / and /. Also, if the Application name changes dynamically, it is a good idea to provide it as a regex. Window Title is the title of the Windows Application. (i.e. Application Name). Note: When specifying ‘Window Path/Title’ make sure that no other application, window or folder with the same title is open, else it may lead to confusion at runtime. If you get an error like “Window is not available or not loaded in specified time”, make sure that the Windows Path/Title, Path and application startup time are correctly specified.
close application on failure	Select the checkbox to close the application if the property validation is unsuccessful.