In this section:

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, see Configuring Kerberos Authentication for Tools for additional information.

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: 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.

   • Record web scenario: Choose this option to record a new scenario.

5.  Complete the next Record Web Scenario wizard page and click Next.

   

   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 selected Record starting from a referenced scenario, specify the name of the test suite containing the reference. You can enable the Persist as relative path option, which configures SOAtest to generate artifacts relative to the reference suite. To reference tests in another project, use the ${project_loc} variable.
   Browser	Choose 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 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.

6. (Optional) Enable the Add url variable to your existing environment option and specify a variable name and prefix in the fields provided. If enabled, this option automatically adds a variable for the URL to the scenario. Environment variables in Parasoft can be used to set conditions around scenarios that may change depending on the testing stage. For functional tests, environment variables are used for the URL of the first navigation test. For asynchronous request tests, they are used in the endpoint and the HTTP header "Referer" of each Messaging Client that is generated for each asynchronous request.

7. Click Finish and 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. Interact with the application in the browser. 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 full page loads can be detected. 

   Recording Clicks in a Text Input Field (e.g., in a Calendar Widget)?

   See Recording Clicks for Calendar Widgets for tips.

   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.

   Completing Forms

   To complete forms, enter the values directly into the GUI controls as if you were actually navigating the site. For instance, type in your user name and password, select radio buttons, check or clear check boxes, and so on. 

   • Password recall and auto-completion in Internet Explorer’s Internet Options Advanced settings are not supported during recording.
   • Google Toolbar's Auto Fill feature is not supported.
   • A "type" action may not be recorded if you type the beginning of a term into a field, but then click on a suggestion from a drop down.

9. Click Stop Recording when you are finished 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.

Additional Information

• Extending existing scenarios: See Extending an Existing Web Scenario for details on how to extend an existing web scenarios with additional steps.
  • Recording Clicks in a Text Input Field (e.g., in a Calendar Widget): See Recording Clicks for Calendar Widgets.
  • Completing Forms: To complete forms, enter the values directly into the GUI controls as if you were actually navigating the site. For instance, type in your user name and password, select radio buttons, check or clear check boxes, and so on. As you record sessions, please note:
    • Password recall and auto-completion in Internet Explorer’s Internet Options Advanced settings are not supported during recording.
    • Google Toolbar's Auto Fill feature is not supported.
    • A "type" action may not be recorded if you type the beginning of a term into a field, but then click on a suggestion from a drop down.
  • File inputs on Chrome: SOAtest does not currently support filling out file inputs in web applications in Chrome.