Session Recording

Use events and bookmarks

You can use events and bookmarks to help you navigate through recorded sessions.

Citrix-defined events are inserted to sessions while the sessions are recorded. You can also use the Event API and a third-party application to insert custom events. Events are saved as part of the session file. You cannot delete or alter them using the Session Recording player.

Bookmarks are markers that you insert in a recorded session during session playback using the Session Recording player. After insertion, bookmarks are associated with the recorded session until you delete them. However, they are not saved as part of the session file but stored as separate .iclb files in the Bookmarks cache folder on the Session Recording player, for example, C:\Users\SpecificUser\AppData\Local\Citrix\SessionRecording\Player\Bookmarks, with the same file name as the .icl recording file. To play back a recording using bookmarks on a different player, copy the .iclb files to the Bookmarks cache folder on that player. By default, each bookmark is labeled with the text “Bookmark,” but you can change it to any text annotation up to 128 characters long.

Events appear as yellow dots and bookmarks appear as blue squares in the lower part of the player window. Moving the mouse over the dots and squares displays the text label associated with them. You can also display the events and bookmarks in the Events and Bookmarks list of the Session Recording player. They appear in this list with their text labels and the times in the recorded session at which they appear, in chronological order.

You can use events and bookmarks to help you navigate through recorded sessions. By going to an event or bookmark, you can skip to the point in the recorded session where the event or bookmark is inserted.

Display events and bookmarks in the list

The Events and Bookmarks list displays the events and bookmarks inserted in the recorded session that is currently playing. It can show events only, bookmarks only, or both.

  1. Log on to the workstation where the Session Recording player is installed.
  2. From the Start menu, choose Session Recording Player.
  3. Move the mouse pointer to the Events and Bookmarks list area and right-click to display the menu.
  4. Choose Show Events Only, Show Bookmarks Only, or Show All.

Insert a bookmark

  1. Log on to the workstation where the Session Recording player is installed.
  2. From the Start menu, choose Session Recording Player.
  3. Begin playing the recorded session to which you want to add a bookmark.
  4. Move the seek slider to the position where you want to insert the bookmark.
  5. Move the mouse pointer to the player window area and right-click to display the menu.
  6. Add a bookmark with the default Bookmark label or create an annotation:
    • To add a bookmark with the default Bookmark label, choose Add Bookmark.
    • To add a bookmark with a descriptive text label that you create, choose Add Annotation. Type the text label that you want to assign to the bookmark, up to 128 characters. Click OK.

Add or change an annotation

After a bookmark is created, you can add an annotation to it or change its annotation.

  1. Log on to the workstation where the Session Recording player is installed.
  2. From the Start menu, choose Session Recording Player.
  3. Begin playing the recorded session containing the bookmark.
  4. Ensure that the Events and Bookmarks list is displaying bookmarks.
  5. Select the bookmark in the Events and Bookmarks list and right-click to display the menu.
  6. Choose Edit Annotation.
  7. In the window that appears, type the new annotation and click OK.

Delete a bookmark

  1. Log on to the workstation where the Session Recording player is installed.
  2. From the Start menu, choose Session Recording Player.
  3. Begin playing the recorded session containing the bookmark.
  4. Ensure that the Events and Bookmarks list is displaying bookmarks.
  5. Select the bookmark in the Events and Bookmarks list and right-click to display the menu.
  6. Choose Delete.

Go to an event or bookmark

Going to an event or bookmark causes the Session Recording player to go to the point in the recorded session where the event or bookmark is inserted.

  1. Log on to the workstation where the Session Recording player is installed.
  2. From the Start menu, choose Session Recording Player.
  3. Begin playing a session recording containing events or bookmarks.
  4. Go to an event or bookmark:
    • In the lower part of the player window, click the dot or square representing the event or bookmark to go to the event or bookmark.
    • In the Events and Bookmarks list, double-click the event or bookmark to go to it. To go to the next event or bookmark, select any event or bookmark from the list, right-click to display the menu, and choose Seek to Bookmark.
Use events and bookmarks