Managing automatic test screenshot settings

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분
  • Capturing many screenshots can impair test performance. You can control which types of screenshots the system captures to minimize this effect.

    By default, the system captures a screenshot every time it executes a form test step. This information can be useful for understanding test results, but may slow down how fast the system executes the test.

    You can change automatic test framework settings so that the system captures all screenshots (as it does by default), no screenshots, or just screenshots for failed test steps.

    You can change these settings to affect all tests run on this instance, or to affect just the current client test runner session. To affect all tests run on this instance, set the automatic test framework property from the automatic test framework properties page. To affect just the current client test runner session, set the screenshot mode from client test runner browser window.

    Set the system property to control when the Automated Test Framework captures screenshots

    To control how often this instance captures screenshots for form test steps, set the screenshot capture mode on the automatic test framework properties page.

    시작하기 전에

    Role required: atf_test_admin or admin

    이 태스크 정보

    Setting the screenshot mode from the automatic test framework properties page affects any new client test runners started on this instance. This setting does not affect currently-running test-runners.

    프로시저

    1. Navigate to All > Automated Test Framework > Administration > Properties.
    2. Set the Enable or disable screenshot capture property from the drop-down menu.
      • 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.
    3. Set the Screenshot timeout time interval, in seconds.
      The Client Test Run does not take a screenshot capture if the length of the attempt exceeds this value. Users should review performance settings and browser caches on affected client systems before increasing this value.
    4. Click Save.

    Set the client test-runner property to control when the Automated Test Framework captures screenshots

    To control how often the current client test runner captures screenshots for form test-steps, set the screenshot capture mode on the client test runner browser window.

    시작하기 전에

    Role required: atf_test_admin or admin

    이 태스크 정보

    Setting the screenshot mode from the client test-runner browser window affects only this client test-runner and persists until this test-runner session is closed. This setting does not affect any other running test-runners or any future test runners.

    프로시저

    1. From the client test-runner browser window, click the form preferences icon (Form preferences icon).
    2. Click the Screenshot mode option.
      • 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.
    3. Click Save.