T-Plan Home
T-Plan Robot Enterprise 4.1 Doc Collection
GUI Reference

T-Plan Robot Enterprise 4.1 Script Recorder

1. Script Recorder Overview
2. Recording Principles

1. Script Recorder Overview

Script Recorder records your interaction with the connected System Under Test (SUT) into a script the active editor. It provides what is often called the "Record & Replay" feature. It records the following event types:
Up to version 4.0 the recorder created coordinate based code. The Component Capture had to be used in places where search for a component on the screen was required before applying the mouse action to it.

Version 4.1 delivered a new recorder which produces reliable image based testing code. It saves component images on the fly and generates code relying on commands that combine image search with a mouse action, such as the Click and Drag ones. This results in highly reliable test scripts tolerant to changes in the application location on the screen. The Component Capture can be still used to produce code of a customized action.

Script recording is supported on the following environments:

2. Recording Principles

This is a brief description of the recorder functionality. For a detailed walk through see the online T-Plan Robot Enterprise Advanced Recorder document.
To start/stop script recording select/deselect Script -> Record in the main GUI menu or the button on the tool bar. You must be connected to a desktop and have a project and a test script open in order to do it.

The recorder converts the user actions into commands of the scripting language (when the target script is a TPR one) or method calls of the Java Test Script API. The resulting code is always inserted into current caret position of the active editor. If there's already a command on the line, the recorder creates a new line below the current one.

The recorder supports three recording modes:
  1. Interactive Mode will pause on every recordable mouse action to allow you to customize the generated code and image(s). You may enter name of the image collection, adjust the image crop area and/or choose to produce the action code through Component Capture. This mode is supported for all connection types except for the Local Desktop one.
  2. Rapid Mode will record the code and images using the default settings without asking any questions. The Robot GUI remains hidden during the whole session. As the screen analysis is time consuming please avoid fast desktop actions and perform your scenario at a slow pace. To finish recording press the right Alt or Ctrl key. After the session is finished you will be given a chance to customize the code and images. This mode is supported for all connection types.
  3. Legacy Mode will switch to the legacy coordinate based recording known from the 2.x, 3.x and 4.0 versions.

Implementation notes: