Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Properties

On the Properties form, you can set parameters that control how the system executes automated tests and test suites.

Field / ElementDescription

Enable test/test suite execution

sn_atf.runner.enabled

If checked, enables running tests and test suites on this instance. This setting is unchecked by default to prevent users from unintentionally running tests on production instances.
Enable scheduled test suite execution sn\_atf.schedule.enabledIf checked, enables scheduling test suites on this instance.
Field / ElementDescription

Enable additional debugging functionality

sn_atf.debug

Enables additional debugging functionality, including adding a debugging tab on the client Test Runner UI page and saving UI Test Result JSON to the test result record.
Field / ElementDescription

Enable or disable screenshot capture during test execution.

sn_atf.screenshots.mode

Note: For additional information, see Set the system property to control when the Automated Test Framework captures screenshots

  • To capture screenshots for all steps, select Enable for all steps.
  • To capture screenshots only for failed steps, select Enable for all failed steps.
  • To capture no screenshots, select Disable for all steps.

Enable the GlideScreenshot feature

sn_atf.screenshots.use_glide_screenshot

Improves the fidelity of screenshots on Workspaces and other interfaces.Note: IE and Safari don't support this property.

If this property is disabled or your current browser doesn't support it, html2canvas is used to take screenshots.

If you are upgrading to a new release version, this property is set to false by default.

Enable capturing the full page when taking a screenshot

sn_atf.screenshots.capture_full_page

Enables dynamic resizing of the test frame and capturing the full page while taking a screenshot.Note: By default, the property is set to false because it can significantly slow test execution time

If the property is disabled, only the portion of the page that is visible in the test frame is captured.

Screenshot timeout

sn_atf.atf_test_runner.screenshot_timeout

Skips a screenshot capture attempt in the Client Test Runner if it exceeds this value in seconds. Users should review performance settings and browser caches on affected client systems before increasing this value.

Number of pixels for screenshot height

sn_atf.atf_test_runner.testframe.min_height

Numeric value representing the number of pixels for the screenshot height. Default value: 600

Number of pixels for screenshot width

sn_atf.atf_test_runner.testframe.min_width

Numeric value representing the number of pixels for the screenshot width. Default value: 800
Field / ElementDescription

Enable tests with Custom UI steps to capture page data each time they are run.

sn_atf.page_data_capture.enabled

When true, Custom UI test steps retrieve page data every time the test runs. Set this property to true when developing custom UI pages to always run tests on the most recent page version.

When false, Custom UI test steps do not retrieve page data unless the test designer manually selects Retrieve Components during test design. Set this property to false when UI development is complete to enable faster test runs.

Field / ElementDescription

Test runner timeout

sn_atf.runner.heartbeat.timeout

If there is no heartbeat from the test runner within this period of time in seconds, the status changes from online to offline. The value of this property should be between 120 and 1800. Default value: 120

Test runner heartbeat interval

sn_atf.runner.heartbeat.interval

Time interval in seconds for sending a heartbeat from the test runner to the server.

Offline test runner retention interval

sn_atf.runner.offline_retention.timeout

If an offline test runner does not communicate with the system for this period of days, the system deletes that test runner.
Field / ElementDescription

Test suite report properties

sn_atf.schedule.reports.suite.aging_threshold

The number of test suite results to display in the test suite aging report.
Field / ElementDescription

Boolean value for results displayed in scheduled suite result emails.

sn_atf.schedule.suite_result_email.only_show_failed_results

When true, the scheduled suite test result emails only show results that failed. When false, displays all results.

Maximum number of test results to be displayed in scheduled suite result emails.

sn_atf.schedule.suite_result_email.max_test_history

Maximum number of test results to be displayed in scheduled suite result emails.

Maximum depth when printing suite results in suite result emails.

sn_atf.schedule.suite_result_email.max_depth

Maximum depth when printing suite results in suite result emails.

Color to indicate an ATF test failed in scheduled suite result emails.

sn_atf.schedule.suite_result_email.fail_color

Hexadecimal code for color to indicate an ATF test failed in scheduled suite result emails.

Color to indicate an ATF test errored in scheduled suite result emails.

sn_atf.schedule.suite_result_email.error_color

Hexadecimal code for color to indicate an ATF test errored in scheduled suite result emails.

Color to indicate an ATF test passed in scheduled suite result emails.

sn_atf.schedule.suite_result_email.pass_color

Hexadecimal code for color to indicate an ATF test passed in scheduled suite result emails.

Color to indicate an ATF test was skipped in scheduled suite result emails.

sn_atf.schedule.suite_result_email.skip_color

Hexadecimal code for color to indicate an ATF test was skipped in scheduled suite result emails.

Color to indicate an ATF test was canceled in scheduled suite result emails.

sn_atf.schedule.suite_result_email.cancel_color

Hexadecimal code for color to indicate an ATF test was canceled in scheduled suite result emails.

Parent Topic:Administration