Track Application Launch Page

Applies to TestComplete 15.70, last modified on December 17, 2024

The Report Generator can track errors in applications that are started externally, for example, from another application. To do this, you need to specify the target application on the Track Application Launch page of the Report Generator. The Report Generator will then track all the started applications and attach to the matching application.

Page Visibility

To open the Track Application Launch page:

  1. Launch the Report Generator.

  2. On the first page of the wizard, click Advanced options.

  3. On the resulting page, click Track application launch.

Page Description

The Track Application Launch page contains the following settings:

  • Application name - Required. The application’s file name without the extension. For example, notepad for Notepad or msword for Microsoft Word.

  • Track multiple launches of the application - Optional. Select this option if several instances of your application will be started, and you want to track errors in all of them. This is useful, for example, when working with multi-process browsers like Google Chrome. This will start a separate instance of the Report Generator for each application process.

  • Use legacy tracking features (not recommended) - Optional. Select this option if you prefer using a preceding version of the tracking feature. This mode does not support automatic tracking of launched applications and has some other specific restrictions mostly applied to multi-process applications (like Google Chrome, as mentioned above).

Click Next to continue, or Back to return to the Choose Option page. Cancel will exit the Report Generator wizard without saving any changes.

Requirements

Note: This section contains information on settings that are specific for the legacy tracking feature. Skip it if you do not use this feature.

  • The parent process should start the application by using its fully-qualified path. For example, C:\Windows\notepad.exe instead of notepad. This helps you avoid issues when there are several running applications with the same name, or when a short path cannot be resolved.

  • The tracked application will report incorrect Handle and ID values. The parent process should not use them.

  • If the tracked application runs under another user account (for example, if it is a service), the current user must have administrator privileges and the following user rights:

    • Adjust memory quotas for a process (SE_INCREASE_QUOTA_NAME)

    • Replace a process level token (SE_ASSIGNPRIMARYTOKEN_NAME)

    To grant these rights:

    • Open Control Panel, select Administrative Tools, and then select Local Security Policy.

    • In the tree on the left, select Local Policies | User Rights Assignment.

    • In the right-side list, double-click Adjust memory quotas for a process.

    • In the dialog that opens, click Add User or Group.

    • Enter your current user name or group name and click OK.

    • Click OK to close the dialog.

    • In the right-side list, double-click Replace a process level token.

    • In the dialog that opens, click Add User or Group.

    • Enter your current user name or group name, and click OK.

    • Click OK to close the dialog.

See Also

Choose Option Page
Generate Report Page
Report Generator Pages
Working With the Report Generator

Highlight search results