Manually adding an image synchronization

You can manually add an image synchronization element to an existing test to ensure that the test synchronizes correctly or to add a verification point. To do this, you must create the image synchronization element, and then perform a single run of the test to retrieve the image hash code or text detected by optical character recognition (OCR).


  1. Open the test in the test editor.
  2. Select the location where you want to create the image synchronization and click Insert and Citrix Image Synchronization. This creates a new image synchronization element that is set to Conditional and has several values disabled. This is because the test does not yet contain the image hash code or recognized text.
  3. In the screen capture area, move and resize the black rectangle to specify the zone of the image that will be used for the synchronization. Alternatively, you can specify the pixel values in X position, Y position, Width and Height.
  4. Select File > Save to save the test, and then, in the test navigator, right-click the test and select Run As > Performance Test. This runs the test once to retrieve the image hash code or recognized text.
  5. After running the test, right-click the test report, select Display Test Log, and then select the Events page.
  6. Click the Events tab.
  7. Expand the top line of the Events hierarchy and navigate to the Image timeout element that was produced during the run.
  8. Select the image timeout to open the Citrix Image Synchronization view. If necessary, you can open the Citrix Image Synchronization view manually by selecting Window > Show View > Other > Test > Citrix Image Synchronization. This view shows the actual screen area encountered during the test and the expected image, as well as the corresponding hash codes or recognized text values.
  9. To add the actual hash code or recognized text to the image synchronization, click the Add value Add value icon button.