+

Search Tips   |   Advanced Search


Citrix image synchronization details

In the test editor, the Citrix image synchronization allows Citrix performance tests to keep track of the contents of a screen area during the replay. These settings apply to the image synchronization element that is selected.


Image synchronization attributes

Locations

These are the coordinates of the top left corner of the image synchronization area, and the size of the image synchronization area in pixels. This field is read only.

Synchronization state

This describes the behavior of the test if a synchronization timeout occurs on the image. The base timeout delay is specified in the Citrix test generation preferences, however the actual delay varies with the level of synchronization.

Conditional

The conditional timeout delay is the base timeout delay as specified in the Citrix test generation preferences. If the synchronization fails, the test tries to resume execution and a timeout is logged in the Citrix performance report and the test log.

Mandatory

The mandatory timeout delay is three times the base timeout delay. If the synchronization fails, the test exits with an error status and a timeout is logged in the test log.

Optional

The optional timeout delay is fixed at 2 seconds. If the synchronization fails, the test ignores the timeout.

Image synchronization preview

This is the screen capture of the image synchronization area as it was recorded. Select Fit screen to visible area to limit the size of the screen capture in the test editor.


Synchronization

Bitmap hash code

This specifies that the synchronization will be evaluated on the bitmap hash code. A hash code is a unique number that is calculated from the image of the selected area. When an image synchronization is encountered during test execution, the test calculates the hash code on the selected area and synchronizes the test if the hash code of the screen area matches the expected hash code before a timeout occurs.

Optical character recognition

This specifies that the synchronization will be evaluated on a recognized text value. Optical character recognition extracts a text string from the selected image area. When an image synchronization is encountered during test execution, the test continually applies text recognition to the selected area and synchronizes the test as soon as the extracted text value matches the expected text value before a timeout occurs.

Value

This page specifies the expected value depending on the specified recognition technique. You can add alternate values by clicking Add so that the image synchronization can succeed in multiple conditions. Alternate values are evaluated in the same way as the main expected value.

Bitmap hash code

When Bitmap hash code is selected, this is the hash code that was calculated on the selected image area during the recording. After executing a test, you can create alternate hash code values by copying the resulting hash codes from the Citrix image synchronization view.

Expected text

When Optical character recognition is selected, this is the expected text value that was extracted by the optical character recognition from the selected image area. Click Extract text to extract a text string from the selected image area.

If the text extraction is unsuccessful, try changing the text recognition settings on the Options page. However, accuracy of the recognized text is not essential. It is only important that the recognized text is consistent each time the test is executed for the test to synchronize.

Use regular expression

Express the expected text string using standard regular expression syntax.

Options

This page specifies the settings for text extraction by optical character recognition. You might need to experiment with various settings to obtain good results. After changing a setting, click the Value tab and click Extract text to see if the text recognition has improved. Note that because optical character recognition is used for verification purposes, consistency of the results in more important than the accuracy of the extracted text.

Zoom factor

This is the enlargement factor that is applied to the image. The default setting is medium for standard font sizes. Increase the zoom factor to improve recognition of smaller fonts or decrease for larger fonts.

Language

This is the language of the dictionary used by the text recognition synchronization. Select the language of the application you are testing. If the language of application is not available in the list, change the language setting in the Default OCR settings of the Citrix Test Generation preferences.

Brightness

This is the brightness level from 0 to 250 that is applied to the image. The default setting is 70 for normally contrasted text. Increase the brightness setting to improve recognition of darker images or decrease for lighter images.

Recognition rate

This is the rate of recognition required for the extracted string to match the expected text. Decrease the recognition rate to tolerate a proportion of mismatching characters in the recognized text. The default is 100%, which means that an exact match is required.


Verification Point

Enable verification point on synchronized element

When selected, the test verifies whether the image synchronization succeeds. If the synchronization produces a timeout, the verification point returns a fail status in the Citrix performance test report.


Response Time

Stop response time for

Use the current image synchronization to stop a response time measurement. When you select this option on an image synchronization that is not already linked to a response time, a new response time is created with a default name. If there are response times that do not have a stop action, then these are also listed. Select the response time to link to.

Go to response time definition

Click here to navigate to the session element to view the Response Time Definitions table.


Related

  • Citrix synchronization overview


    Related tasks

  • Synchronize tests with screen areas
  • Add values to an image synchronization
  • Viewing Citrix image synchronization timeouts
  • Enable Citrix window verification points
  • Verify application behavior
  • Specifying window verification point criteria


    Related reference

  • Citrix test details
  • Citrix session details
  • Citrix window details
  • Citrix window event details
  • Citrix key action details
  • Citrix mouse action details
  • Citrix text input details
  • Citrix mouse sequence details
  • Citrix screen capture details
  • Citrix logoff details
  • Citrix Verification Points report