Target Application Settings

The last step in creating a new project is to define your target application. Following type of target applications are supported:

• Server / Web Application
• Local / Desktop Application

Server / Web Applications

Server applications are typically applications that are deployed in a J2ee application server such as WebLogic / WebSphere etc. AppPerfect supports communication with server application via HTTP and HTTPS protocols. Following values need to be specified to completely define a server application.

URL Settings

• Starting URL : The first page from where you want to start interacting with your server application. This can be either an HTTP or HTTPS URL. You can provide the URL from where you want to actually test your project instead of providing the first page of your web application.
• Authentication Basic/Digest/NTLM): For applications that need to be authenticated, please select the appropriate Authentication mechanism and then provide values for Username, Password and Domain name as per the authentication setting selected.
  Basic/Digest/NTLM authentication is implemented in the Web browser itself. If you are using this kind of security mechanism, username and password need to be specified here so that AppPerfect can connect for the first time and record the page.
• Two way SSL Authentication : For applications using two way authentication, please select this checkbox and then provide values for password and client certificate file.
• Configure Proxy Settings: If your application requires a proxy server, then you need to provide those instructions here.

AppServer Settings

• AppServer : Select the Application / Web Server from dropdown provided here. (BEA WebLogic 8.1; IBM WebSphere 5.1; Tomcat 5.5; etc.) In case you find that your application server is not present in the list then select the "Other" option from the list.
• Server Home: Folder location where app server is installed.
• Startup file: All app servers use some kind of startup batch file. Refer to your app server documentation for name and location of your startup file.
• Config file: Most app servers require a system configuration file (often called config.xml). Provide the path for same here
• Instance Name: Often app servers support multiple instances of the app server running on the same machine. If your app server supports this kind of configuration, specify the instance name where your application is deployed. Refer to your app server's documentation for more details.
• Debug port: Debug port is used by AppPerfect Java Unit Test to generate functional test cases. You need not change it unless the default port 8680 used is being already used by some other application. If you need to generate Function Test Cases, the server should be started passing command line arguments - -Xdebug -Xrunjdwp:transport=dt_socket,address=8680

Launch Server automatically (when required): AppPerfect can detect if the required app server is not running, and can start it for you automatically when needed. AppPerfect will also shut down the server automatically.

Local / Desktop Applications

Local/desktop applications typically run on your local machine as a single user system. Following values need to be specified to define a local/desktop application. AppPerfect will construct the necessary command and invoke your application. 

• Work folder: This is the folder location from where your application will be launched. Most desktop applications assume some default startup directory to locate resources.
• JVM Arguments: Arguments you wish to pass to the JVM (such as -MX, etc.)
• Launch Target application automatically: This option is disabled by default and is enabled only if you provide the Main class for your application or HTML file in case of Applet. If selected appperfect launches the target application on its own. In case this option is deselected then you will need to manually launch the target application.

Desktop Applications

• Main class/Executable jar: Class file name that launches your application. Class that contains the main() method. You can also specify a jar file and the JVM will automatically extract the main class file name.
• Main class arguments: Arguments you wish to pass to your application at startup. Note that on the Mac OS X, you will need to specify startup arguments with commas.

Applets

AppPerfect can test your applets-based applications. Specifying the necessary information below to define the applet type project in AppPerfect. 

• HTML File Name: The html file that contains the applet. This is the Web page that the browser will request.