Home
Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM® Cloud Private, Jenkins and so on. The test results can be pushed to Rational® Test Control Panel.
Running tests from Functional Test perspective
In this section, you will learn how to play back tests from the Functional Test perspective.
Enabling the dynamic find feature
The test object map lists in a hierarchy the test objects in the application under test. Changes to the application-under-test might result in changes in the object hierarchy. During playback, Rational® Functional Tester is then unable to find an object whose hierarchical position has changed, and this causes playback failure. With the dynamic find feature you can prevent playback failure that results from hierarchy changes in the application under test. The dynamic find feature performs searches for objects whose hierarchy has changed, when a search that is based on object recognition scoring (ScriptAssure) fails to find such objects.

Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM® Cloud Private, Jenkins and so on. The test results can be pushed to Rational® Test Control Panel.
- Running tests from UI Test perspective
  In this section, you will learn how to play back the Web UI, mobile and Windows tests from the UI Test perspective.
- Running tests from Functional Test perspective
  In this section, you will learn how to play back tests from the Functional Test perspective.
  - Running scripts
    When you play back a script, Rational® Functional Tester replays your recorded actions, which automates the software testing cycle.
  - Restoring the test environment before playback
    The state of both the environment and the application-under-test can affect script playback. If the recorded environment and the playback environment are different, playback problems can occur.
  - Configuring how to handle unexpected windows during playback
    Problems can occur during script playback if unexpected windows are displayed. Unexpected windows such as security and warning message dialog boxes or custom dialog boxes can cause playback failure with exceptions such as object not found or window not activated. You can configure how unexpected windows can be handled so that scripts can be played back smoothly without interruption.
  - Inserting dynamic test objects
    You can also insert dynamic test objects by using Insert Dynamic Test Object. The hierarchy of a test object in the object map represents the order of search of the particular control during playback. Over a series of application changes, the hierarchy of the objects may change if new objects are introduced in the test application. This results in a playback failure. Using dynamic test objects you can anchor a test object as a descendant to its parent.
  - Enabling the dynamic find feature
    The test object map lists in a hierarchy the test objects in the application under test. Changes to the application-under-test might result in changes in the object hierarchy. During playback, Rational® Functional Tester is then unable to find an object whose hierarchical position has changed, and this causes playback failure. With the dynamic find feature you can prevent playback failure that results from hierarchy changes in the application under test. The dynamic find feature performs searches for objects whose hierarchy has changed, when a search that is based on object recognition scoring (ScriptAssure) fails to find such objects.
  - Using ScriptAssure
    Using ScriptAssure™, you can play back scripts successfully even when the application-under-test has been updated.
  - Ambiguous object recognition in functional testing
    Ambiguous recognition occurs when Rational® Functional Tester can not uniquely identify an object in the system-under-test. This commonly happens when Rational Functional Tester cannot differentiate between an instance of the application-under-test started by a script playback and an instance of the same application inadvertently left open previous to script playback. This also applies to identical windows from one application and identical HTML documents. Ambiguous recognition will cause script playback failure unless the duplicate application is closed.
  - Playback Monitor
    During playback you can view the script name, the number of the line that is executing, status icons, and a description of the action in progress from the Playback Monitor.
  - Pausing or stopping script playback
    Playback of a script can be paused or stopped.
  - Running a script from Rational® Functional Tester
    When you run a script from Rational® Functional Tester, it plays back all of your recorded actions, such as starting an application, the actions you take in the application, verification points, and stopping the application.
  - Running Functional tests for HTML applications by using the Web UI extension
    When you want to run Functional tests for HTML applications in browsers without enabling the browsers and Java environments, you can do so by using the Web UI extension.
  - Running a script from the Microsoft™ Edge browser
    You can use IBM® Rational® Functional Tester to play back test scripts using the Microsoft™ Edge browser.
  - Debugging scripts
    You can use the same process to debug a Functional Test script as you would to debug other Visual Basic or Java™ applications. If you prefer, in Rational® Functional Tester, Eclipse Integration, you can debug your script in the Rational Functional Tester Debug Perspective which makes it easier to start the debugger that comes with the Java Development Toolkit.
  - Screen snapshot on playback failure of functional tests
    If playback of a script causes an exception to be thrown, Rational® Functional Tester takes a screen snapshot at the time of the failure. The screen snapshot is accessible through the log.

Enabling the dynamic find feature

The test object map lists in a hierarchy the test objects in the application under test. Changes to the application-under-test might result in changes in the object hierarchy. During playback, Rational® Functional Tester is then unable to find an object whose hierarchical position has changed, and this causes playback failure. With the dynamic find feature you can prevent playback failure that results from hierarchy changes in the application under test. The dynamic find feature performs searches for objects whose hierarchy has changed, when a search that is based on object recognition scoring (ScriptAssure) fails to find such objects.

About this task

On the Dynamic Find Enablement page in the Preferences dialog box, you can enable or disable the dynamic find feature for all functional test scripts in the integrated development environment (IDE). For an individual script, you can enable or disable the feature on the Select Log page. For instructions, see the Select Log page topic. You can also enable or disable from the command-line interface. For information, see theRational® Functional Tester command line interface topic.

Note: When you enable the dynamic find feature in the Preferences dialog box, the setting applies to all scripts in the IDE. You can override this preference for an individual script on the Select Log page, when you run the script.

Procedure

In the product menu, click Window > Preferences to open the Preferences dialog box.
Expand Functional Test, and then click Playback.
Click Dynamic find enabled.
Select the Enable script find if scoring find fails check box.
Note: To prevent playback failure because of hierarchy changes, you can also use the Insert Dynamic Test Object method. Using this method, you can anchor a test object as a descendant of its parent. This renders script playback resilient to object hierarchy changes. For information about inserting dynamic test objects, see the Inserting dynamic test objects topic.