EV Observe - Synthetic Monitoring Module - Updating Scenarios in Offline Mode

Last modified on 2023/09/28 16:53

The offline mode allows you to:

  • Edit various settings for the scenario and each user action.
  • Add/remove actions.
  • Display/delete details of mouse mouvement actions.
  • Add/modify/delete/deactivate images.
  • Add transactions and subroutines.
  • Manage older versions of the scenario.

Notes

  • The image recognition algorithm can take up to 10 screenshots per action. By default, when recording, the algorithm takes 2 screenshots, one in focus, the other out of focus.
       Open url.png See the procedure to manage images.

Caution

  • New settings will be taken into account once the scenario is recompiled.

Best Practice

  • You can rollback to an earlier version of the scenario at any time by selecting the version you want in the history.
       Open url.png See the procedure.

Edit settings of scenario and image actions

Scenario

You can edit properties of the scenario. Open url.png See the description.

   The values are default values that apply to all actions of the scenario. You can edit properties of a specific action by clicking on it.

Access: Scripts Manager tool > Scripts > Select a scenario > Click Properties icon.png in the toolbar

          Scripts - Scenario properties.png

Image actions

You can edit properties of each image action. Open url.png See the description.

Access: Scripts Manager tool > Scripts > Select a scenario > Click on an image action in the list of actions

          Scripts - Action properties.png

Add actions

Access: Scripts Manager tool > Scripts > Select a scenario > Right-click on an action in the list of actions 

          Settings for other actions - Contextual menu.png

Action Description Notes
Comment Selected Action Put the selected action as a comment so that it is ignored when the script is executed.
Add Subroutine Add a subroutine to execute another series of actions in the event of a scenario error, then continue the actions or stop the scenario.
  • The starting point of a subroutine is the presence or the absence of an image, a string of characters or a Windows object.
  • The subroutine can be triggered when the expected element is absent or can be executed as long as the element is present or absent.
You can configure the behavior of the subroutine.
  • The Subroutine1 subroutine is executed only when the previous action fails.
  • The subroutine is executed. Once completed, the scenario stops.
  • The subroutine is executed. The scenario stops until the expected action appears (x attempts).
  • The subroutine runs. The scenario continues as long as the action is successful (x attempts).
example Execute the Subroutine1 action only when the CheckImage action fails, then continue with the rest of the script. Settings for other actions - Insert action - Subroutine example.png
Open url.png See the procedure to add a subroutine.

Best Practice icon.png  Select Create Subroutine from Script option to use an existing scenario as a subroutine.

Insert Action > Image Add an image from the desktop.
Insert Action > MouseClick Add a mouse action over the selected action.
Insert Action > KeyAction Add a keyboard input action (KeyPress, KeyDown, KeyUp) above the selected action.
Insert Action > OCR Replace an image action by an OCR string
example Replace the search for the trash icon with a search for the trash string.

   The OCR function must be activated.

Open url.png See the OCR function installation.

Insert Action > VB Code Insert a Visual Basic function in the scenario above the selected action. Open url.png See the procedure.
Insert Action > Transaction
  • You can add a transaction to calculate an intermediate time during scenario recording.
  • You can delete a transaction: Right-click on the Start Transaction or Stop Transaction action, then select the Remove > Remove Selected Transaction in the menu. The Start Transaction and Stop Transaction actions will automatically be removed.
Open url.png See the procedure to add a transaction.
Insert Action > Anchor Add an anchor on an image to move a set of images linked to it.
  • A new mouse reference will be placed on the image action when you add the anchor. Consequently, if the image moves, all reference points will automatically move with it.
  • The Anchor icon.png icon will display to the right of the action representing the anchor start. You must then define the action where the anchor ends.
  • All actions included in the anchor are marked to their right by the icon representing the action of the anchor start.
example Actions linked to a anchor on the Firefox action Settings for other actions - Insert action - Anchor list of actions.png
Add to Library You can save an action, a series of actions or a subroutine in the library. Once saved, you can reused it in other scenarios.
example Drag-and-drop the Subroutine2_2 subroutine from the library into the scenario. It appears in a new action, called Subroutine4. Settings for other actions - Library - Insert subroutine in a scenario.png Settings for other actions - Library - Subroutine inserted.png
Start Script from this Line Allows to start the scenario from the selected action. A green arrow represents the starting point of the scenario.

   Make sure the desktop interface is as expected.

Add Breakpoint on this Line Allows to stop the scenario before executing the selected action and return control to the user. Open url.png See the procedure.

Mouse movements

When recording a scenario, all mouse movements are recording. They are grouped under a single action called MouseMove. Movements are also evidenced by red dots on the desktop.
         Settings for other actions - Mouse mouvements.png

  • Click the MouseMove action to display details of all mouse movements.
  • Click Trash icon.png to delete details of all mouse movements. Only one action will be retained.
  • Click Edit VB code icon.png to edit details of all mouse movements in Visual Basic format.
             Settings for other actions - VB Code of MouseMove action.png

Procedures

How to manage images

How to change an image

1. Click on the image you want to change.

          Settings for images - Change image - Source.png

2. Use the arrows Up arrow icon.png Down arrow icon.png to move the red square on the desktop and select the new image.

          Settings for images - Change image - Destination.png

How to delete an image

1. Click on the image you want to delete.

2. Click Delete icon.png.

          Settings for images - Delete image.png

How to deactivate an image

1. Right-click on the image, then select the Deactivate option in the menu.

          Settings for images - Deactivate image.png

The image index goes to -1.

          Settings for images - Disable image - Index updated.png

Best Practice icon.png  You can also prioritize the image search by ordering the images using Up arrow icon.png Down arrow icon.png. The image taken into account is the first to meet the precision criterion.

How to add an image

   Make sure that no image is selected.

1. Click on the image you want to add to the desktop.

2. Use the arrows to sharp the image.

3. Click Add icon.png.

          Settings for images - Add image.png

How to add a subroutine

example  You can define a scenario that will scroll one web page as long as it has not found an image in particular. The subroutine will run as long as the image is not found and this up to 15 attempts.

     Open url.png See the procedure

How to insert a Visual Basic function in the scenario

     Open url.png See the predefined Visual Basic functions

example  Add a one-second wait when double-clicking on Firefox.

1. Launch the Scripts Manager tool.

2. Go to the Scripts menu.

3. Select the scenario you want.

4. Right-click on the action under which you want to insert the function, then select Insert Action > VB Code in the menu.

5. Select the Visual Basic function, then click Add icon.png

        Settings for other actions - Insert action - VB code.png

The function will display under the selected action.
       Settings for other actions - Insert action - VB code example.png

How to add a breakpoint action

1. Launch the Scripts Manager tool.

2. Go to the Scripts menu.

3. Select the scenario you want.

4. Right-click on the action on which you want to stop the scenario, then select Insert Action > Add Breakpoint on this Line in the menu.

A Stop icon wiil appear at the right of the action.
         Settings for other actions - Breakpoint action.png

5. When the scenario executes the breakpoint action, a contextual panel will appear. The user can then take the hand to execute actions which will be integrated into the scenario.

          Settings for other actions - Breakpoint action - Contextual panel.png

How to find out the cursor shape

1. Launch the Object Analyzer.

  • Right-click on the Systray icon Systray icon - Synthetic Monitoring - xSession on.png.
           Systray icon bar.png
  • Select the Show Object Analyzer option in the menu.
           Settings for other actions - Cursor shape - Start Analyse object mode.png

2. Move the mouse to the desktop.

A tooltip appears, indicating the shape of the cursor.
       Settings for other actions - Cursor shape - Tooltip.png

3. Stop the Object Analyzer mode by clicking on the process icon in the status bar, then click Stop.
       Settings for other actions - Cursor shape - Stop Analyse object mode.png

How to manage version history of a scenario

1. Launch the Scripts Manager tool.

2. Go to the Scripts menu.

3. Select the scenario you want.

4. Click Backup icon.png in the toolbar.

          Version history of scenario.png

5. Select the version you want.

  • Click Backup icon.png to roolback to the version.
  • Click Delete icon.png to delete the version.
Tags:
Powered by XWiki © EasyVista 2024