EV Observe - Synthetic Monitoring Module - Improving Scenarios in Advanced Mode

Last modified on 2023/09/28 16:52

The Advanced mode allows you to define the actions to be taken when a scenario does not recognize user actions such as an image out of the search area. It also allows you to add images, transactions and subroutines in the script.

Via this mode, you can also export the scenario in Word format.

Various use cases in Advanced mode

Increasing the search area of an image

This situation appears when the desired image is not in the search area. Consequently, execution of the scenario will stop and return the hand to the user to define the actions to be taken.

In this case, you need to increase the search area (in pixels) using the ScanAreaPixel property to be sure to find the expected image.

     Open url.png See the procedure

example  The trash icon does not appear in the default search area (300 pixels). The system finds an image with an accuracy of 62 (less than the required minimum), then the scenario goes into error. You need to increase the search area for the trash icon.

          Search area image - Error.png

Adding an image

This situation appears when the desired image is no longer on the desktop or to change. Consequently, execution of the scenario will stop and return the hand to the user to define the actions to be taken.

In this case, you need to add the expected image.

     Open url.png See the procedure

example  The trash is full while it was empty during the initial registration, then the scenario goes into error. You need to add the full trash icon in the scenario.

          Adding image - Error.png

Adding a transaction

You can add a transaction to calculate an intermediate time during scenario recording. Everything is executed through the Scripts Manager tool.

example  Add a transaction to record Excel loading time. The transaction will start when Excel is launched and end once Excel is loaded.

     Open url.png See the procedure

Adding a subroutine

This function allows you to manage the errors of the scenario in an intelligent way. Often, some applications send messages time and time that requires a user action like click on the OK button to continue. The constitution of the initial registration had not incorporated this complementary action. Consequently, execution of the scenario will stop and return the hand to the user to define the actions to be taken.

In this case, you can add a subroutine to educate and teach the scenario to go through another series of actions to recover the rest of the script.

example  Add a subroutine in the scenario to teach it that if it can not find the Excel icon, it should launch Excel directly from the Start menu, then continue as normal with the rest of actions.

     Open url.png See the procedure

Procedures

How to increase the search area of an image

Step 1: Increase the search area.

1. Change the ScanAreaPixel property for the missing image.

          Search area image - Correction.png

2. Click Continue the script.

The scenario will continue until the end.
 

Step 2: Save the scenario with the new search area.

1. Save the scenario.

The recompilation will be done automatically.

How to add an image

Step 1: Add the image.

1. Click Add icon.png when the error appears.

          Adding image - Error.png

A square orange will appear on the right-hand side (search box).
       Adding image - Correction - Default orange square.png

2. Click on the full trash image.

The orange square will move above the image.
       Adding image - Correction - Move orange square.png

3. Press <Enter>.

  • The new image with the full trash will appear on the left side.
  • The scenario will be able to click on the empty or full trash icon.
           Adding image - Correction.png

Step 2: Save the scenario with the new image.

1. Click Continue the script.

The scenario will continue until the end.

2. Save the scenario.

The recompilation will be done automatically.

How to add a transaction

Step 1: Load the scenario.

1. Launch the Scripts Manager tool.

2. Go to the Scripts menu.

3. Select the scenario you want, then click Script.

        Adding transaction - Load scenario.png

All the user actions of the scenario will display.
 

Step 2: Add the transaction in the scenario.

1. Drag and drop the Transaction option on the left panel under the user action that will indicate the transaction start point, i.e. when Excel is launched.

          Adding transaction - Drag and drop transaction option.png

The Transaction property window will appear.

2. Name the transaction, then press <Enter>.

          Adding transaction - Transaction properties.png

The transaction will appear in the list of user actions, delimited by the StartTransaction and StopTransaction actions.
       Adding transaction - Transaction option added.png

3. Drag and drop the StopTransaction action under the user action that will indicate the transaction end point, i.e. when Excel is loaded.

          Adding transaction - Move StopTransaction action.png
 

Step 3: Execute the scenario with the new transaction.

1. Save the scenario, then recompile it.

2. Replay the scenario to calculate the transaction execution time, then click Reload to reinitialize the user actions with the new transaction.

The reference time of the transaction will appear and corresponds to the time to load Excel.
       Adding transaction - Display reference time of transaction.png

How to add a subroutine

Step 1: Add the subroutine.

1. Click Show Record Window when the error appears.

          Adding subroutine - Error.png

The Record property window will appear.

2. Go to the Subroutine tab.

3. Specify the subroutine properties, then click OK.

          Adding subroutine - Show Record Window - SubRoutine properties.png

The actions that will be played after recording will display.
       Adding subroutine - Show Record Window - SubRoutine actions.png

4. Click OK.

The recording of the subroutine starts.

5. Once the recording is complete, press <F8> function key, then click the Stop Recording option.

          Adding subroutine - Show Record Window - SubRoutine recording endded.png

The system indicates that a keyboard input was entered.

6. Transform it as a variable by clicking Last icon.png, then click OK.

          Adding subroutine - Transform words to variables.png

The scenario continues as normal with the next actions.
 

Step 2: Replay the scenario with the new subroutine.

1. Save the scenario, then recompile it.

2. Click Reload to reinitialize the user actions with the new subroutine.

The subroutine will appear in the list of user actions, delimited by the StartTransaction: Default Subroutine and StopTransaction: Default Subroutine actions.
       Adding subroutine - Subroutine added.png

3. Execute the scenario.

  • When the Excel icon is found in the menu bar, a double click is done and the spreadsheet is loaded.
  • When the Excel icon is not found, the subroutine is executed and Excel is launched from the Start menu.
  • In both cases, the scenario continues the actions once the Excel spreadsheet has been loaded.

How to export the scenario in Word format

1. Right-click on the Systray icon Systray icon - Synthetic Monitoring - xSession on.png.

          Systray icon bar.png

2. Select the Show Scripts Manager option in the menu.

The Scripts Manager windon will appear.
       Scripts Manager from Systray.png

3. Click Word in the toolbar.

The Word file of the scenario will be generated.

Tags:
Powered by XWiki © EasyVista 2024