Use the
TrueLog Options - Classic Agent dialog box to enable TrueLog for the Classic Agent and to customize the information that the TrueLog collects for
Silk Test Classic.
Click
.
Logging bitmaps and controls in TrueLog may adversely affect the performance of
Silk Test Classic. 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.
Note: By default,
TrueLog Explorer is enabled when you are using the Open Agent, and disabled when you are using the Classic Agent. When
TrueLog Explorer is enabled, the default setting is that screenshots are only created when an error occurs in the script and only test cases
with errors are logged.
For additional information about
TrueLog Explorer, refer to the
Silk TrueLog Explorer Help for
Silk Test.
Logging Settings tab
Enables the TrueLog capture and configures the TrueLog.
- Enable TrueLog
-
Captures TrueLog data and activates logging settings. You can also enable or disable TrueLog each time you run a test case
by checking this check box in the
Run Testcase dialog box. When you enable or disable TrueLog in the
Run Testcase dialog box,
Silk Test Classic makes the same change in the
TrueLog Options dialog box. Likewise, when you enable or disable TrueLog in the
TrueLog Options dialog box,
Silk Test Classic makes the same change in the
Run Testcase dialog box.
- All testcases
- Logs activity for all test cases, both successful and failed.
- Testcases with errors
- Logs activity for only those test cases with errors.
- TrueLog file
- Designates the location and name of the TrueLog file. This path is relative to the machine on which the agent is running.
The name defaults to the name used for the results file, with an
.xlg extension. The location defaults to the same folder as the test case
.res file.
Note: If you provide a local or remote path in this field, the path cannot be validated until script execution time.
- Log the following for controls
- Logs certain types of information about the controls on the active window or page.
- Control information
-
Logs the GUI control’s hierarchy, name, type, and other attributes for the active window or page. This information appears
on the
Controls tab of the
Information window in
TrueLog Explorer. This is selected by default when you enable TrueLog. If you choose to log control information, you may optionally decide
to log:
- Control creation/deletion
- Tracks the creation and/or deletion of controls on the active window or page. TrueLog updates the control hierarchy after
each action. Choosing this option may adversely affect performance.
- Include static text controls
- Includes the static text controls in the logged hierarchy. To keep TrueLogs small, leave this option turned off for browser
testing.
- Track low level events
- Logs keyboard and mouse events. For each mouse click and key press a new
Action node is created on the Tree List in the TrueLog. Use caution when selecting this option for browser applications, as you
can significantly impact performance.
- Log the following for browsers
-
Identifies the browser events you want to capture.
- Download events
- Captures all events that trigger page downloads. Selected by default.
- Navigate events
- Captures all events that cause new pages to appear. Selected by default.
- Terminate events
- Captures all events that cause a browser to close. Selected by default.
- New window events
- Captures all events that cause a new browser window to appear. Selected by default.
- MouseMove calls
- Logs all scripted
MouseMove calls. This is useful for tracking JavaScript
MouseOver events. By including this information in TrueLogs, you may significantly affect performance. This information appears as
an
Action node in the Tree List.
- TrueLog delay
- Allows Windows time to draw the application window before a bitmap is taken. The delay can be used for browser testing. You
can insert a
Browser.WaitForReady call in your script to ensure that the
DocumentComplete events are seen and processed. If
WindowActive nodes are missing from the
TrueLog, you need to add a
Browser.WaitForReady call. You can also use
TrueLog Delay to optimize script performance. Set the delay as small as possible to get the correct behavior and have the smallest impact
on script execution time. The default setting is 0.
- Enable bitmap capture
-
Controls when TrueLog captures screenshots of the application under test. Bitmap files are included in TrueLog (.xlg) files. Selected by default.
- As specified on action settings tab
- Enables the capture of bitmaps for each action type you select on the
Action Settings tab. This setting also causes a bitmap capture each time a window becomes active in your application.
- On error
- Captures a bitmap when an error occurs in your test case.
- Window only
- Saves the bitmaps for the active window.
- Desktop
- Saves a bitmap of the entire desktop.
- Before error bitmap
- Captures the bitmap before the error occurred.
- TrueLog Presets
-
Sets pre-determined logging levels.
- Minimal
-
Logs test cases with errors; enables bitmap capture of desktop on error; does not log any actions.
- Default
- Logs test cases with errors; enables bitmap capture of window on error; logs data for
Select and
SetText actions; enables bitmap capture for
Select and
SetText actions.
- Full
-
Logs all test cases; logs all control information; logs all events for browsers except for
MouseMove events; enables bitmap capture of the window on error; captures bitmaps for all actions.
If you enable Full logs and encounter a
Window Not Found error, you may need to manually edit your script.
Action Settings tab
The
Action Settings tab on the
TrueLog Options - Classic Agent dialog box selects the scripted actions you want to include in the TrueLog. When enabled, these actions appear as nodes in
the Tree List view of the TrueLog.
- Select actions to log
-
- Enable
-
Selects the action to log. Each action corresponds to a
4Test method, except for
Click and
Select.
- Click
-
Records mouse clicks on many controls, such as
PushButton,
ScrollBar,
TextField, and
HtmlLink. To record
Click methods on a
CheckBox, choose
Select, not
Click.
- Select
-
Records actions on multiple methods of multiple types of controls, including ListBox, TreeView, ComboBox, RadioButton, and
CheckBox. Here is a partial list of what Select records:
- Select (ListBox, TreeView, ComboBox, RadioButton)
- DoubleSelect, SelectList, SelectRange (ListBox, TreeView)
- Click (ListBox, TreeView, ComboBox, RadioButton, CheckBox)
- Check, Uncheck, Toggle, SetState (CheckBox)
- Bitmap
-
Selects the point in time you want bitmaps to be captured:
- None
- Never captures bitmaps.
- Before
- Captures bitmaps before errors occur.
- After
-
Captures bitmaps after errors occur.
- Both
-
Capture bitmaps both before and after errors occur.