Deploying and Testing the Toolkit Support Set (for Stage 3)

After defining the WebExtBook test object class in the test object configuration file and the identification rules for this test object class in the toolkit configuration file, you can already test the effect of using the toolkit support set with UFT One.

Note: When you develop your own toolkit support set, if you modify attributes of Identification Property elements in the test object configuration file, keep the DevelopmentMode attribute of the TypeInformation element set to true during the design stages of the custom toolkit support. Before you deploy the custom toolkit support set for regular use, be sure to remove this attribute (or set it to false). This is not required when performing this tutorial lesson. For more information, see Modifying Identification Property Attributes in a Test Object Configuration File.

  1. Copy the WebExtSampleTestObjects.xml file to <UFT One installation folder>\dat\Extensibility\Web.

  2. In the <UFT One installation folder>\dat\Extensibility\Web\Toolkits folder, create a folder named WebExtSample.

  3. Copy the WebExtSample.xml file to the <UFT One installation folder>\dat\Extensibility\Web\Toolkits\WebExtSample folder.

  4. In the <UFT One installation folder>\dat\Extensibility\Web\Toolkits\WebExtSample folder, create a folder named Res.

  5. Place the WebBook.ico file in <UFT One installation folder>\dat\Extensibility\Web\Toolkits\WebExtSample\Res folder.

  1. After you deploy the toolkit support set, open UFT One.

    Note: UFT One reads toolkit support files when it opens. Therefore, if UFT One is open, you must close UFT One and open it again.

    The Add-in Manager dialog box displays the WebExtSample as a child of the Web environment in the list of available add-ins. (If the Add-in Manager dialog box does not open, see the UFT One Help Center for instructions.)

  2. Select the check box for WebExtSample and click OK. UFT One opens and loads the support you designed.

  3. Use the Define New Test Object button in the Object Repository dialog box to open the Define New Test Object dialog box. The WebExtSample environment is displayed in the Environment list. When you select the WebExtSample environment from the list, the WebExtBook test object class that you defined in the test object configuration file is displayed in the Class list, with the icon that you specified in the WebExtSampleTestObjects.xml file.

  4. Run the sample control by opening the %ALLUSERSPROFILE%\Documents\ExtAccTool\Samples\WebExtSample\Application\Book.htm file.

    Note: UFT One establishes its connection with an application when the application opens. Therefore, if the Book control is open, you must close it and run it again.

    In UFT One, perform the following activities on the Book control, to see how UFT One recognizes the control. (For more information on working in UFT One, see the Micro Focus UFT One User Guide.)

    • Use the Object Spy to view the identification properties and test object operations that are supported for the Book control:

      • The WebExtBook test object created for the Book control is given the name of its test object class. Later in this lesson, you customize your toolkit support set to provide a more specific name.

      • The list of test object operations includes all of the operations (methods and properties) inherited from the WebElement base class, as well as all of the methods that you defined in the WebExtSampleTestObjects.xml test object configuration file.

      • The list of identification properties includes all of the properties that you defined in the WebExtSampleTestObjects.xml test object configuration file. The property values are not displayed because you have not yet implemented a method that returns property values from the application (and the WebElement base class does not support these properties). You will implement such a method later in this lesson.

    • Use the Add Objects to Local button in the Object Repository dialog box to learn the Book control. Ensure that the correct icon is used to represent the test object in the object repository.

    • In the Keyword View, create a test step choosing the WebExtBook object from the object repository in the Item column.

      • The list of available operations in the Operation column reflects the definitions in the test object configuration file.

      • After you select an operation, UFT One displays the Name attribute of the operation's argument in a tooltip for the Value cell. If you define an operation with more than one argument, the Value cell is partitioned according to the number of arguments of the operation, when selected.

      • The descriptions and documentation strings you defined for test object methods in the test object configuration file are displayed in tooltips and in the Documentation column, respectively.

    • In the Editor, create a test step with a WebExtBook test object. The statement completion feature displays all of the operations available for the test object, based on the definitions in the test object configuration file.

      If you defined possible values for the operation's arguments (in the ListOfValues element), they are displayed in a statement completion list as well. Later in this lesson, you learn how to enable a control to dynamically provide a list of possible argument values. You develop support for providing a list of the authors that can be used for the AuthorName argument of the GoToAuthorPage operation.

  5. Run a test with a step that performs a new test object method on a WebExtBook test object. UFT One searches for a JavaScript function to run the test object method on the control. Because you have not yet implemented support for running test object methods, a run-time error occurs. In the next section, you implement this support.

Continue to Stage 4: Implementing Support for the WebExtBook's Test Object Methods.