start program

Launch a specified application on the test machine.
NameDescriptionTypeModifier
program

The program to be started, prepended with its execution path, if necessary.

StringNone
parameter

(Optional) A parameter or string, such as the name of a data file, to be passed to the launched program.

Notes: 
parameter is an invisible argument. To use it, you must specify both the value and parameter header in the column to the right of the program argument.

StringNone
None
This action may be used within the following project items: test modules and user-defined actions.
The following settings are applicable to this action: remove double quotes from cells.
Example - Case 1: Starting an application
Action lines
        
          	program
start program	C:\Program Files\LogiGear\TestArchitect\sample\CarRental\CarRental.exe
&nbsp	
	window
check window exists	login
        
    
Result
Example - Case 2: Starting an application that accepts an argument

Say you want to open a text file with the Notepad++ application. Since Notepad++ accepts the path of a text file as a command line argument, we can specify the file when we launch the application. We have two options for doing this.
Option 1: Using the parameter argument:

Action lines
      
        	program	parameter
start program	"C:\Program Files (x86)\Notepad++\notepad++.exe"	"d:\test.txt"
&nbsp		
	window	
check window exists	home	
      
  
Result

Option 2: Including the argument to the application in the program argument:

Action lines
      
        	program
start program	"C:\Program Files\Notepad++\notepad++.exe" "d:\test.txt"
&nbsp	
	window
check window exists	home
      
  
Result
  • parameter argument:
    • parameter is an unsupported argument and hence invisible. To use it, you must specify both its value and header, in the cell to the right of last visible argument.
    • An alternative to using the parameter argument is to simply append its contents to the program argument, delimited by a space.
  • For the execution path, you may use the standard execution file path format of the operating system (e.g., in Windows: C:\Program Files\Acme\foo.exe). The execution file path may also use the forward slash delimiter (C:/Program Files/Acme/foo.exe), regardless of operating system.
  • A full path is not required if the directory in which the program resides is listed in the execution search path environment variable of the operating system (%PATH% in Windows, $PATH in Linux). For example, full paths need not be specified for such applications as Windows’ Notepad, Calc, and cmd, because the directory in which their executables reside is always included in the system %PATH% variable.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Copyright © 2024 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1 (650) 572-1400