Documentation forWeb Performance Monitor

Track click coordinates in the Web Transaction Recorder with X, Y Capture Mode

You can use X, Y Capture Mode to track coordinate clicks during a recording. When this mode is enabled, WPM simulates mouse actions at the OS level and also records all keyboard actions. All mouse actions are converted from global coordinates to local browser coordinates and displayed in the Recorded Steps pane, as shown in this example:

Because WPM receives no feedback about whether a mouse action succeeds, X, Y Capture Mode is typically used in conjunction with the following tools:

  • Image Match (for example, to verify that expected images loaded)
  • Text validation (to verify that text is present on a loaded page)

Use X, Y Capture mode to force the webview (the area of a web page to be captured) in the WPM Player to scroll to a location where a regular action will be executed. If you add a step to capture the position of the horizontal and vertical scrollbars, WPM adjusts the webview area automatically when transactions created from the recording are played back. This can be helpful when you can only interact with elements after they become visible in the UI.

Note the following details about X,Y Capture Mode:

  • X,Y Capture Mode is only available while recording a sequence.
  • The X,Y Capture Mode tool turns blue when the mode is active.
  • To exit X,Y Capture mode, stop recording, click another tool, or perform another action such as importing a file. You can also click the X, Y Capture mode icon to turn it off.
  • If you know a page element such as a button will not appear immediately, add wait time or Image Match before capturing a click to support successful playback.
  • See also Capture coordinates in iFrames.

To use X,Y Capture mode:

  1. Launch the WPM Recorder:
    1. Type a URL.
    2. Set the screen resolution.
    3. Click Start Recording.
  2. Click the X, Y Capture mode icon.
  3. Click somewhere on the page as needed.
  4. Click Stop to end the recording.
  5. Click Play and verify that the recorded clicks and actions appear in the Recorded Steps pane.

To use X,Y Capture mode with Image Match:

  1. Start the recording.
  2. Click Add Image Validation and then drag your mouse over a region of the image.
  3. Click the X,Y Capture Mode tool to enable it.
  4. Click somewhere on the page as needed.
  5. Click Stop to end the recording.
  6. Click Play and verify that the recorded clicks and actions appear in the Recorded Steps pane.

To simulate "Image match with click" functionality available in the Deprecated WPM Recorder, add an action to validate the image before using the X, Y Capture mode action to click in the center of the image.

If you encounter issues, see Troubleshoot X,Y Capture Mode.

Capture coordinates in iFrames

By default, capturing coordinates in Inline Frames (iFrames) is not supported in WPM due to timing issues, and also because iFrame elements have their own scroll bars. WPM blocks X,Y clicks inside iFrames that are in different domains than the parent web application.

After loading a page from a different domain into an iFrame, any clicks that occur inside that iFrame will not be highlighted during playback and text verification will fail. Possible workarounds include :

  • Use the iFrame scroll bar to scroll up/down or left/right, and then use X,Y clicks to select the page background.
  • Record a click on an empty area of a scrolled page, and then click the area where you want to capture coordinates. This allows extra time for page elements to load during playback.

Avoid capturing elements like buttons or text inputs within iFrames.

Depending on your needs, you can override the default setting that blocks X, Y Capture in iFrames.

To override that setting in the Web Transaction Recorder:

  1. Log into the system that hosts the Web Transaction Recorder.
  2. Navigate to the following default folder: C:\Program Files (x86)\SolarWinds\Orion\SEUM\Recorder.
  3. Open the following file in a text editor: WPM Recorder.exe.config.
  4. Scroll to the following line: <disableWebSecurity value="false" />
  5. Change "false" to "true".
  6. Save your changes and restart the WPM Recorder.

On macOS systems, config files are stored in /Contents/Resources/WPM Recorder.exe.config.

To override that setting on a system that hosts a WPM Player:

  1. Log into the system that hosts the WPM Player.
  2. Navigate to the following default folder: C:\Program Files (x86)\SolarWinds\Orion\SEUM\Player
  3. Open the following file in a text editor: SolarWinds.SEUM.Agent.Worker.exe.config
  4. Under <agentWorkerConfiguration />, add the following argument:

    Note that two hyphens (--) occur before disableWebSecurity.

  5. Save your changes.