Inserting a new recording into a Citrix test

You can insert a new recording into a Citrix test. Use this feature to add or replace a part of a recorded session.

Before you begin

Inserting a new sequence into a test requires that the Citrix session reaches the same state as is expected at the point where the new sequence is inserted. For example, if your new sequence must interact with a particular window that was created earlier in the test, you must advance to the point where that window is in the expected state before the recording can start. To do this, the Citrix test recorder can either automatically replay the existing scenario up to the insertion point, or you can manually advance the session to the expected state.

When inserting a new sequence into a test, it is important that the context of user actions is preserved to ensure that the test synchronizes properly during the replay. The resulting test will probably require manual editing to make sure that test can replay smoothly.

Note: Because Citrix tests contain low level user input and synchronizations, minor changes can prevent the test from working. When editing these tests, you must ensure that they are functionally identical.


To insert a recording into a test:

  1. In the test editor, select the element before which you want to insert the new recording. It is easier to manage the new test sequence when the insertion point is at the window event level of the test.
  2. Click Insert, and then Record scenario.
  3. In the Update Recording window, specify how you want the session to reach the state expected at the insertion point, and then click OK.
    • Select Automatically replay the scenario to replay the test up to the insertion point. With this option, the test replays and stops when it reaches the insertion point. If the replay fails to synchronize, you will be asked to manually bring the session to the expected insertion point state.
    • Select Manually advance to the expected state to manually put the Citrix session into the state that will be expected at the insertion point.
  4. After the Citrix session is in the expected state and you are ready to start the new recording, engage the Enable/Disable recording Enable/Disable recording icon button in the toolbar. If you chose the automatic replay option, the recording is enabled automatically.
  5. Perform the sequence of actions that you want to add to the existing test. When you have finished, click the Enable/Disable recording Enable/Disable recording icon again to stop the recording.
    Note: You can restart the recording several times. However, you must be sure that the Citrix session resumes from the same state that it was in when it was stopped. If actions are missing from the recorded sequence the test is unlikely to synchronize correctly during the replay.
  6. When you have completed the sequence of actions to be inserted into the test, close the session and stop the recorder by clicking Stop recording Stop recording icon. A progress window opens while the test is generated. On completion, the Recorder Control view displays the message Test generation completed, the Test Navigator lists your test, and the test opens in the test editor.
  7. After the test has been updated in the Test Navigator, check that the new sequence was properly inserted into the test before saving the new test. Check that the context of the Citrix session is compatible with the user actions at the beginning and at the end of the of the inserted sequence. If the results of the insertion were not what you expected, you can revert to the previously saved version of the test by clicking File > Revert or try to correct any problems manually.