How to fix it

  1. Navigate to Automated Test Framework > Test Results and open your most recent failed test execution.
  2. Click the Step Results tab and identify the first failing step. Note the exact error message and step type.
  3. If error mentions missing records, go to Automated Test Framework > Tests, open your test, and verify all referenced records still exist in the target tables.
  4. Check the Run As field on your test record. Navigate to User Administration > Users and verify this user has all required roles for the test actions.
  5. For timing issues, edit your test and add Wait for Condition steps before assertions that depend on async operations like workflows or business rules.
  6. Configure wait conditions to check for specific field values, record states, or UI elements that indicate the operation completed.
  7. If field names or choice values changed, click Test Steps tab and update the Field name and Value fields in affected steps.
  8. Add cleanup steps at the end of your test to delete created records using Delete Record or Server Side Script steps.
  9. For form-based tests, use Form UI test steps instead of direct database operations to handle client-side logic and validation.
  10. Enable Debug mode on your test record and run it again to capture detailed execution logs in System Logs > System Log > All.
💡

After making changes, run your test in isolation first, then run the entire test suite to ensure no other tests are affected by your modifications.