Editing a keyboard action

You can edit keyboard actions to manually specify how the keyboard interacts with the Citrix server.

Before you begin

Keyboard actions describe low level user actions using the keyboard such as text inputs or keyboard shortcuts. Keyboard actions can be added only inside window events.

In most cases, you will rely on the keyboard actions that were recorded with the test. The recording tries to factor multiple key presses into text input actions. However, in some cases, you might need to manually factor keyboard actions that are redundant or poorly recorded. For example, in some cases, a text input string Hello can be recorded as a press on the Shift key, a press on the H key, a release of the Shift key, a stroke of the E key, and finally a text input of llo. By manually factoring keyboard actions into text inputs, you can handle text from datapool variables and references.

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.


  1. Open the test in the test editor
  2. Expand a window event.
    • To edit a keyboard action, select the action in the Test Contents area.
    • To create a new keyboard action at a specific location, select an action and click Insert and Citrix Keyboard.
  3. In the Test Element Details area, specify the type of action.
    • Key Stroke: This indicates that a key is pressed and released.
    • Key Down: This indicates that a key is pressed and held down.
    • Key Up: This indicates that a pressed key is released.
    The Key Code field displays the key code as interpreted by the Windows operating system and is translated in the Character field. Use the modifiers to specify the whether the Control key, Shift key, or Alt key is also pressed.
  4. You can manually enter any Unicode character that is not normally available through single keystrokes by using the Character Edition area. Select the input field and enter the character on your keyboard. The Key Code and Character fields display the corresponding character.
    Note: The workbench uses some key combinations as keyboard shortcuts. Such combinations can be intercepted and cause undesirable actions instead of displaying a particular character in the Character field..
  5. You can specify the think time for the keyboard event. This emulates the time spent by a user before initiating the current event.