Want to extend an existing scenario (instead of recording a new one)?
See Extending an Existing Web Scenario for details on how to add new steps to an existing web scenario.
Configuring Authentication Settings
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
.
Right-click your project and choose Add New> Test (.tst) File...
You can also click the Add Recorded Scenarios button in the toolbar.
- Specify a name and the directory for the file in the wizard and click Next.
Choose Web> Record web scenario and click Next.
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.
Selenium WebDriver Note
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 be automatically set to Firefox or Chrome, based on what browser is configured for scenario playback. If the scenario is set to play back in Chrome, Chrome is selected. Otherwise, Firefox is selected. You can change the default selection if desired.
Record new web scenario Choose this option to record a new scenario from scratch. Complete the next Record Web Scenario wizard page.
Test Suite Name Specify the name of the test suite that the scenario should start from Start Recording From / Test Suite Reference Enter 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., mymachine.parasoft.com) or the IP address (e.g., 10.10.11.11). If you are recording a scenario based on a referenced scenario, specify the name of the test suite containing the reference. Generate Functional Tests Enable 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 Tests While navigating a web site in Firefox, the site may use the XMLHttpRequest object, or hidden IFrame calls to asynchronously request data from a server. Selecting Auto Generate Asynchronous Request Tests will prompt SOAtest to capture those requests and their responses, and then generate and autoconfigure tests to validate these requests. For more information, see Exploring the Asynchronous Test Requests Generated. Browser Choose the browser used to record the scenario. For Firefox or Chrome, the path may be set automatically (e.g., from system settings or browser playback preferences). Generate Test Maintainability Report Specifies 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. - Click Next and Complete the Create Environment page (Optional).
The controls in this page allow you to specify whether environment variables automatically get added to recorded scenarios.For functional tests, they get used in the URL of the first navigate test. For asynchronous request tests, they get used in the endpoint and the HTTP header "Referer" of each Messaging Client that gets generated for each asynchronous request.
- These variables are generated by default. If you do not want these variables generated into the recorded scenarios, disable the Add url variable to your existing environment option.
- Name specifies the name that will be used for the environment if a new environment is created. (A new environment is created if one does not yet exist for that scenario).
- Prefix specifies the prefix that will be used on the environment variables that get generated into the environment and that are referenced by the scenarios. The text below the prefix field demonstrates what the environment variable name will look like based on the specified prefix.
- 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.
- 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.
To ensure that recording works properly, wait until each page has fully loaded before performing an action. For example, if you click on a link and this causes a page load, you should wait for the page to finish loading so that SOAtest
can detect that a page load occurred.
When beforeUnload dialogs open during recording, SOAtest will always record "Accept Script Dialog." However, if you want the test to cancel the dialog instead, then you need to modify the recorded test case to use "Dismiss Script Dialog" instead.
- 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.Tips