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
- Select this option to 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
your 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
- Select this option to 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 that you want to link
to.
- Go to response time definition
- Click here to navigate to the session element to view the Response
Time Definitions table.