Setting TrueLog Options

Enable TrueLogs to capture bitmaps and to log information for Silk4J.

Logging bitmaps and controls in TrueLogs may adversely affect the performance of Silk4J. Because capturing bitmaps and logging information can result in large TrueLog files, you may want to log test cases with errors only and then adjust the TrueLog options for test cases where more information is needed.

The results of test runs can be examined in TrueLog Explorer. For additional information, refer to the Silk TrueLog Explorer Help for Silk Test.

Note: To reduce the size of TrueLog files with Silk Test 17.5 or later, the file format for TrueLog files has changed from .xlg to the compressed .tlz file format. Files with a .xlg suffix are automatically appended with a .tlz suffix. To parse result data from a .tlz file, you can unzip the .tlz file and parse the data from the included .xlg file.

To enable TrueLog and customize the information that the TrueLog collects for Silk4J, perform the following steps:

  1. Click Silk4J > Edit Options. The Script Options dialog box opens.
  2. Click the TrueLog tab.
  3. In the Basic Settings area, check the Enable TrueLog check box.
    • Click All testcases to log activity for all test cases, both successful and failed. This is the default setting.
    • Click Testcases with errors to log activity for only those test cases with errors.
  4. In the TrueLog location field, type the name of and optionally the path to the TrueLog file, or click Browse and select the file. The path is relative to the machine on which the agent is running. The default path is the path of the Silk4J project folder, and the default name is the name of the suite class, with a .tlz suffix. To ensure that TrueLog files are not overwritten, for example when you perform parallel testing, you can add placeholders to the TrueLog file name. These placeholders are replaced with the appropriate data at execution time.
    Note: The path is validated at execution time. Tests that are executed by Silk Central set this value to the Silk Central results directory to enable the screenshots to be shown in the result view.
  5. Select the Screenshot mode. Default is On Error.
  6. Optional: Set the Delay. This delay gives the operating system time to draw the application window before a bitmap is taken. You can try to add a delay if your application is not drawn properly in the captured bitmaps.
  7. Click OK.