How do I use the Scenario Execution Timeline to troubleshoot script issues?

This article explains the features available in the Scenario Execution Timeline window.

ScenarioBuilder provides a very useful tool that can help you with your script development in many ways. Some of which are:

  • Quick visual of step status
  • Seeing exactly where the mouse clicked
  • Knowing how long it took to find an image, along with suggestions on improving the application's ability to find the image
  • Viewing a screenshot for each step that was executed
  • Knowing the length of time it took for each step to complete
  • Knowing the path that was taken through various branches (like ifs, switches, and loops)
  • A direct link to Smart Image Configurator when image failures occurred during the run
  • And knowing what data was used for each variable
Launching Scenario Execution Timeline

To access the Scenario Execution Timeline, first you must have completed a run. If the run just completed and the ScenarioBuilder Execution Report is displayed, you can click View

Execution Timeline.

ScenarioBuilder Execution Report

If the ScenarioBuilder Execution Report window is not currently displayed, then you’ll need to go to the run tab and click View Report to launch it.

Accessing the Execution Report from Run


Steps Status

The Execution Timeline provides visual clues about the success or failure of each step.

  • Steps shaded in green completed successfully
  • Steps shaded in yellow did not execute, but were not flagged as failures
  • Steps shaded in red are failed steps
Scenario Execution Timeline


Viewing Mouse Clicks

If you have a failure in your script related to not clicking in the correct place, then this is where you go to find out exactly where the mouse clicked during the run. For a “find image” or “click on image” step, there is a red dot on that step.

Mouse click icon

Clicking it will open the image related to the mouse click in your default photo application. There will be a red + indicating exactly where the mouse clicked.

Mouse click image

One reason for issues with mouse clicks is when you have several images associated to a find or click on image step. When the mouse is anchored, the click is relative to the image. When your images are different sizes or have captured different elements of what it is you need it to find, the mouse may not click in the desired location.


Image Timing Info

Another helpful piece of information is how long it took to find an image. For example, if you have the step set to look for the image for 10 seconds and it took 9.5 seconds to find it, you might want to adjust your script so it waits a little longer to account for possible variance in the time it takes to find the image.

Image timing info-1

In addition, ScenarioBuilder can suggest changes that might improve the success rate of finding the image. In the above step a suggestion is made for tolerance.


Viewing Step Properties

You can double-click on a step to open the associated step properties.

Step Properties

NOTE - this information is read only.


Viewing Screenshots

When you select a step, it shows the screenshot that was taken BEFORE the step executed. If you want to know what the application looked like at the end of the step, click the next step to see that screenshot.

If the screenshot is too small, you can grab the divider bar and drag it to the left to make the screenshot larger. You can then drag it to the right to make it smaller.

Adjust Panes


Step Timing Information

If you are building a script for use in performance testing, knowing the amount of time it takes to complete each step can be helpful. This can be used to help determine where to place your start and end transactions. It can also pinpoint steps that might not be as efficient as needed. You might need to change some logic in your script. While the Execution Timeline doesn’t show the exact amount of time a step took, you can take the start time of a step and the start time of the next step and subtract to find how much time the step took.

Step Timing Info


Viewing Logic Decisions

When creating scripts with logic such as if statements, switch cases, and loops; knowing exactly what logic was used in the execution can be helpful for troubleshooting your script. This script has a switch case statement. You can see that the variable was F, so it followed the case where the variable was equal to F and executed the steps associated to that case statement.

Logic Decisions


Accessing Smart Image Configurator

When you have a script failure related to an image, the Execution Timeline provides a quick way to go to Smart Image Configurator.

Smart Image Config

On the step is the Smart Image Configurator icon. Clicking it takes you directly into Smart Image Configurator.


Viewing Data used for Variables

And the last element we are going to discuss is data. You can see the data that was populated for each variable during the run.