Checks can contain a Selenium browser automation scenario. Using scenarios in your Web check allows you to verify that the site behaves as expected. You can add and test your scenario directly from the ASM platform via the Edit Check page.

It is possible to mask sensitive information when creating the ASM scenario so that sensitive information (e.g. a password) is not exposed unnecessarily. The sensitive information will be hidden from both the Check Results page and the Edit/Debug scenario page. See How to Mask Sensitive Information Within an ASM Scenario for more details. For example, you can see the text [ENCRYPTED BY APICA] in the above screenshot. Here, a value was hidden so that it cannot be seen by users who have Scenario Admin permissions.

Note that you may need to change certain scenario commands when you upload your Selenium IDE file, as certain commands are not supported by ASM Scenarios. See Comparing Selenium IDE Scripts and ASM Scenarios for more details surrounding Selenium IDE to ASM conversion, including a chart listing the commands which are supported by ASM Scenarios. If a scenario is uploaded which contains an unsupported command, you will see a warning dialog and the unsupported command will be highlighted.

Debugging a Scenario From Within ASM

The Debug Scenario view allows you to replace, edit or test an uploaded scenario.

Replacing or Renaming an Existing Scenario File

You can replace an existing scenario file with a different scenario or a newer version of the same scenario by uploading a locally stored file:

1. Click “Upload New File”

2. Browse to the directory where you have the scenario file stored

3. Select the appropriate file

4. Click “Open”

If scenario upload is successful, you will see the following confirmation message:

To rename an existing scenario file, click the “pad and paper” icon to the right of the scenario file name:

If the scenario file name was updated there in the Debug Scenarios page, the updated file name will show in the Edit Check page. This is useful functionality if you make a change to the script and would like to save a new version number without exiting the Debug Scenarios page. The new scenario name will also be updated on the “Edit Check” page.

To rename the title of the ASM scenario itself, click the “pad and paper” icon to the right of the scenario name:

This will not change the scenario file name and will only change the title of the scenario itself. It is generally recommended to rename both the scenario file name and the scenario name at the same time in order to maintain consistency.

Testing a Scenario

You can test your scenario by clicking the “Test Scenario” button from within the Edit Scenario page:

While the test is running, progress is displayed next to the run button.

You can cancel the test at any time by clicking “Cancel”.

Result Summary

A successful test run is indicated in the Result Summary:

If the scenario fails, the step on which the scenario failed and the failure reason is indicated in the Result Summary:

If the scenario is configured to use screenshots, they are displayed as part of the result summary:

Using Scenario Commands

Commands can be added to a new or existing scenario file with the “Add Step” button:

1. Click “Add Step”

   

2. Select a command from the dropdown list

   

3. Double-click the blank rows in the Target and Value columns and add the desired values:
   

   

4. Click “Save Scenario”

Existing commands in the list can be edited by clicking on the dropdown or double-clicking the rows in the Target and Value fields. Commands in the list can be deleted by clicking on the “trash can” icon. Commands in the list can be reordered by clicking the command row and dragging the command to a new position. Commands in the list can be downloaded by clicking the “Download Scenario” icon. This is useful for when you wish to back up your existing scenario before making significant changes to a scenario.

Execution Log

After a test run has ben executed for a scenario, a test execution log becomes available. The execution log is collapsed by default. To show the full execution log, click the button to the right of the “Execution Log” text:

In the event of a failed execution, failed commands are also highlighted in the “Commands” section: