Create Scripts with Turbo Capture

Turbo Capture speeds up script creation by recording mouse and keyboard actions as you perform them against a system under test (SUT). During a Turbo Capture session, Eggplant Functional captures images and generates the appropriate SenseTalk code for the actions that are executed.

Step by Step: Capture Images and Actions

Follow the steps below to capture the images and actions that Eggplant Functional uses to generate your script:

  1. Connect to a SUT. When you've connected, the SUT screen appears in the Viewer window.
  2. Start a Turbo Capture session:
    • From the main menu, select Control > Start Session > Turbo Capture Session.
    • From the Viewer window toolbar, click Start Session > Turbo Capture Session.
  3. Execute your test manually through the Viewer window. Actions such as clicks, scroll wheel movements, and keystrokes are recorded automatically. Hold down the Shift key while moving the mouse to capture mouse movements. Release the Shift key to stop capturing mouse movements.

    As you perform your test, screen shots are taken for each action. These screen shots are used to create images for use in scripts. The edge detection feature in Eggplant Functional automatically sizes captured images, though you can adjust them later in the process.

  4. To end a Turbo Capture session, click Stop Session in the Viewer window toolbar, or click End Turbo Capture Session in the Sessions tab. A new session is created in the Sessions tab.
  5. Select your session and click Open Session to begin script generation.

Step by Step: Script Generation

The session opens in the Sessions tab, where you can modify and name images, and edit TypeText commands for use in the script. The following steps are specific to creating images from a Turbo Capture session. TypeText commands bring up an editing pane in which you can modify the keys that the script types, or approve them as they were captured.

Script Generation in an Eggplant Functional Turbo Capture session

  1. Modify the Capture Area for the image in the center panel of the session view, using image capture best practices.
  2. Name the image in the file browser. Duplicate names appear in red. If Eggplant Functional detects a duplicated image, other instances of the image display as thumbnails below the file browser. You can choose to use an existing image in your script, or select the Replace Existing checkbox to overwrite that image.

    An existing image from a Turbo Capture session in Eggplant Functional

    Duplicated names appear in red text

  3. You can add and create Tags for ease of organization. Click the tag icon to the right of the Tags field to apply the selected tags to all of the images created in the session.
  4. Adjust the search settings for the script Eggplant Functional generates. See Searching & Properties to learn more about available search types. Select Use OCR if you want the highlighted step to use optical character recognition (OCR) instead of an image search. To use OCR as the default search type for an entire session, Shift+click the Use OCR checkbox.
    Note: This setting is session-specific. It is not saved in your defaults or between sessions. This setting also does not persist if you close a session and then return to that session.
  5. Modify the Max Wait entry if you think a longer or shorter wait time is necessary. During Turbo Capture sessions, Eggplant Functional tracks the amount of time it takes for screens to update and inserts these times into scripts as WaitFor commands. See the WaitFor Command for more information.
  6. When all images are sized and named, and all TypeText commands are modified as needed, click Generate Script. Now, Eggplant Functional generates images and code based on selections you made. Images marked skipped or //use existing images are not generated.
  7. When script generation is complete, Eggplant Functional opens the generated script as a new tab in the same Suite window. The script is automatically given the same name as the session.
Note: Turbo Capture sessions can take up a lot of space on your machine because full-resolution screen shots are captured at each stage of execution. After a script has been generated from a session, it is advisable to delete the session from the sessions list.


This topic was last updated on August 19, 2021, at 03:30:51 PM.

Eggplant icon | Documentation Home | User Forums | Support | Copyright © 2022 Eggplant