See Extending an Existing Web Scenario for details on how to add new steps to an existing web scenario.

When you first record a scenario, the authentication information specified in the Security Preferences are used first. If you want to record a scenario on a web application that requires Kerberos authentication, you need to specify the Kerberos authentication credentials in the Security Preferences before recording the scenario. For details on how to do this, seeConfiguring Kerberos Authentication in SOAtest.

  1. Right-click your project and choose Add New> Test (.tst) File...

    You can also click the Add Recorded Scenarios button in the toolbar.

  2. Specify a name and the directory for the file in the wizard and click Next.
  3. Choose Web> Record web scenario and click Next. 

  4. Choose one of the following options to specify a starting point for the web scenario and click Next.

    Record starting from a referenced scenario allows

    Choose this option to start recording a new web scenario that builds on an existing (reusable) web scenario. For example, you can record one scenario that captures the steps to log into your application, and then reference this when creating new scenarios. This way, you don’t need to record the login steps every time that you want to create a new scenario that requires a log in. If the login steps change, you just need to update the one login scenario. All related scenarios will automatically use the updated information.

    If you choose to record starting from a referenced scenario that is set to play back with WebDriver in Internet Explorer or Safari, the Browser option will automatically be set to Chrome by default, but you can change the default selection.

    Record new web scenarioChoose this option to record a new scenario from scratch.
  5.  Complete the next Record Web Scenario wizard page.

    Test Suite NameSpecify the name of the test suite that the scenario should start from
    Start Recording From / Test Suite ReferenceEnter the URL of the site where you want to record. To record applications that "live" on the same machine as SOAtest, do not use localhost—instead, use the machine name (e.g., or the IP address (e.g., If you are recording a scenario based on a referenced scenario, specify the name of the test suite containing the reference.
    Generate Functional TestsEnable this option if you want SOAtest to record user actions on the page, and generate a test suite that will allow you to replay the entire scenario for cross-browser testing. Enable the Auto Generate Response Stubs sub-option if you want SOAtest to automatically generate stub outputs for functional tests that have asynchronous responses.
    Generate Asynchronous Request TestsIf the web site uses the XMLHttpRequest object or hidden IFrame calls to asynchronously request data from a server, enable Auto Generate Asynchronous Request Tests to capture those requests and their responses. SOAtest will also generate and autoconfigure tests to validate these requests. For more information, see Exploring the Asynchronous Test Requests Generated.
    BrowserChoose the browser used to record the scenario. For Chrome, the path may be set automatically (e.g., from system settings or browser playback preferences).
    Generate Test Maintainability ReportSpecifies whether you want SOAtest to generate a  report that helps you gauge the maintainability of a test suite. See Creating a Report of Test Suite Maintainability for details.
  6. Click Next and Complete the Create Environment page (Optional).
  7. Click the Finish button. The designated start page will open in the selected browser. If you configured recording to start from a referenced scenario, that scenario will be played back in the browser before you can start recording the new scenario steps.
  8. Specify the functionality that you want to capture by interacting with the browser. You can click links, complete and submit forms, use the navigation bar to enter open URLs, access shortcuts, go forward or back, and so on.
  9. When you are finished recording, click Stop Recording. A new 

Test Suite will appear in the Test Case Explorer.This new Test Suite will contain different tests depending on your selections from the wizard’s Test Type field. For more information, see the following subsections.