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.
Procedure
To insert a recording into a test:
- 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.
- Click Insert, and then Record scenario.
- 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.
- After the Citrix session is in the expected state and you
are ready to start the new recording, engage the Enable/Disable
recording
button in the toolbar. If you chose
the automatic replay option, the recording is enabled automatically.
- Perform the sequence of actions that you want to add to
the existing test. When you have finished, click the Enable/Disable
recording
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.
- 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
. 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.
- 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 or try to correct any
problems manually.