System Configuration

The Tools -> Options dialog box lets you specify a number of important properties to control Java Unit Test behavior. Properties configured here are applied to all the projects in the test. Following is a description of the various tabs and properties found in them.



Number of Recent Project Files: Specify the number of project files to show in the most recently used menu list. The default is 5.

Number of Recent Result Files: Specify the number of result files to show in the most Recently used menu list. The default is 5.

Highlight Row/node on mouse over:This setting is for highlighting the current row you are browsing or the current node you are visiting in AppPerfect product.

Save Result: Define your results-save strategy here. You can configure to save result for each project run automatically or to save just last run of the project. Default value is to not save result automatically.

User Name: Shows the name of the user configured in AppPerfect Test Manager. Multiple users can be configured with AppPerfect Test Manager and each client AppPerfect product can use unique user name to submit results/ projects to Test Manager. This user name is used as identifier and is helpful in generating user based reports in Test Manager. In case connection to Test Manager is not configured Or if there is only single user configured in Test Manager then this field is un-editable.

Garbage Collector Settings

To control the memory usage of application during execution you can configure Garbage collector settings here. AppPerfect takes care of forcing the garbage collection once the specified limit is reached. You can also configure how often AppPerfect should check for memory consumption.

Font Settings

You can set your own font for AppPerfect Java Unit Test.

Update Schedule

Application can be configured to check for new updates/release of the AppPerfect product. On finding one application notifies the user about the availability of same. Keeping this feature enabled ensures that you are using latest version of the product.

Browsers, JDKs & DBs

Browser Settings

Here you can configure browser which application should use to open Help files and exported results/reports. You should have proper browser configured for application to work correctly.

JDK Settings

Specify your JDK's name and path here. AppPerfect will use the default JDK specified at the time of installation. You may want to use other JDKs for your applications and those can be defined and used from here.

DB Connections

You can configure Database related properties like Database name, Connection URL, JDBC driver, User Name, password etc. here.

Custom Certificates

In case your application uses a custom SSL certificate (i.e. certificate not provided by Verisign or Thawte), then either you need to make that custom certificate trusted by the JVM running AppPerfect product or you may select the option to "Accept Self-signed or untrusted custom SSL certificates."

To make the custom certificate trusted by the JVM running AppPerfect product, you need to add the SSL certificate here. AppPerfect uses this certificate when running your test. Certificates provided by Verisign or Thawte are automatically trusted by the "trust file" within the JVM. All other certificates are considered custom SSL certificates. If you are using a Custom certificate, you will need to import that certificate into AppPerfect. In case you don't have the certificate file, open your HTTPS link in a browser and then click on the "lock" icon. This will pop up a dialog box with "Certificate" title & General tab selected. Go to Details tab and select "Copy to File..." option. Proceed with the wizard. On Export file format select "Base-64 encoded..." radio button. Save it to some temporary location and import this certificate file. Please note that you will be required to restart AppPerfect product after registering custom certificate.


License related settings are done here. You can configure license for either single client machine or can configure the product to pick the license from Floating license server in case you have purchased Floating license. Floating licenses are managed using License Manager in AppPerfect Test Manager.

Log Settings

AppPerfect maintains logs of fatal exceptions for all the products. You can change this setting here to log all messages. This option is very useful for debugging purposes. It is recommended that you use this feature in case you are facing any issues with the product and send us the log files. By default log files are saved at: <AppPerfect_Home>/logs. You can configure to change the log path and save logs at different location.

Proxy Settings

General Settings

Select this option in case you are unit testing Server application and need to record http requests as you navigate though them in browser during recording. Application uses Proxy Recording to record these requests.

AppPerfect Proxy Server Settings

AppPerfect starts its local proxy server and sets same in target browser. By default Application uses localhost and port 8690 to start the local proxy server. In case default port is in use by some other application you can change it to some other value here.

AppPerfect can automatically launch and configure proxy settings in your web browser wherever possible. If you want to do that yourself, deselect the checkbox 'Automatically launch and configure browser for recording.'

Target Proxy Server Settings

These settings are required if you do not have a direct connection to the Internet and you normally use a proxy server to access your application. The browser's current proxy settings have to be specified here. By default AppPerfect assumes a direct connection to the Internet.

Filter Settings

These settings are required in case of Proxy Recording. All the patterns which are marked as excluded here are not recorded while recording. Application by default adds common update services installed on machine which are not part of your application and these requests should be dropped while recording tests. You can extend this list to add more patterns which you would like to exclude during recording.

Server Connection

Test Manager Settings

AppPerfect Test Manager settings are done here. AppPerfect Test Manager provides functionality of requirement, project, results and issues management. It allows to schedule various project executions, view results, export them to various formats, add/manage test requirements and add/manage issues in the product. AppPerfect Test Manager by default runs on port 8744 and can be accessed as http://HOST_NAME:8744/AppTestManager.

Product's Service Settings

Product related service settings are configured here. Each Java Unit Test product also installs a product service which listens to requests from other Java Unit Test product installations on remote machines while performing remote execution. This service by default runs on port 8814 and can be accessed as http://HOST_NAME:8814/AppService

Repository Settings

AppPerfect Repository Settings is required to share AppPerfect projects across the team. AppPerfect provides support for Subversion(SVN) server for sharing projects across team. AppPerfect Repository server by default runs on port 8747 and can be accessed as svn://HOST_NAME:8747/AppRepository in case repository is created with "AppRepository" as the root folder. For complete details on configuration of Team or Repository Server refer to Team Server Configuration

Java Unit Test

Port Information

Various ports are used by the AppPerfect Java Unit Test to generate, compile and execute test cases for your project. You can change the default port numbers here.

Report Settings

For Exceptions and Assertion Failures, generally you do not need to go through the stack trace to know the reason for the failure.Hence, by default AppPerfect Java Unit Test does not show the stack trace. But you can view the stack trace to get more details by selecting this option and re-running the project after that.

Improve Code Coverage

Specify the values to improve code coverage. Application maintains a repository of objects used in all the test classes of your project. Application will show the test status wizard after executing the test classes if the code coverage achieved is less than the Code coverage cut off. In the Test status wizard, application will show a Top 'n' instances along with instances that application added with default values. You can edit these instances to achieve more Code coverage.

Test Class Generation

Show classes which are used as method parameters in the source code before test class generation: If this option is selected then application shows a dialog before Test Class generation. This dialog shows the classes (and count) which are used as method parameters in the source code. Application will create valid objects for these classes during generation but it may not be able to create correct objects if class needs some values which cannot be identified deterministically like if class is reading some file or opening some URL etc., then application may not be able to find the exact file to pass or exact URL to open. In such cases or in general as well if you can specify how to create instance of any class accurately then it will help in generating more accurate test cases. Please note that providing details on how to instantiate these classes is optional, if you do not provide these details then application will take care of creating valid objects for the classes using some predefined default values.