Working with Java Add-in Extensibility > Planning Custom Toolkit Support > Determining the Support Information for Each Custom Class > Understanding the Custom Class Support Planning Checklist

Understanding the Custom Class Support Planning Checklist

When you plan your custom support for a specific class, you must ask yourself a series of questions. These are explained below and are available in an abbreviated, printable checklist.

Note: Questions 1, 4, and 5 are fundamental to the design of the custom toolkit support. Changing the answers to these questions after creating support may require you to make complex manual changes, or even to recreate the custom support.

  1. Make sure you select the correct custom class to support:

    1. Does the custom class have a superclass for which UFT custom support is not yet available?

    2. Does the custom control have identification properties or test object methods that require the same UFT support as other controls that extend the same superclass?

      If so, consider creating support for the superclass first.

  2. Make sure you have access to custom class sources and to an application that runs the custom control on a computer with UFT installed.

  3. Make sure you have access to the compiled custom class on the computer on which you are programming. The classes can be in class folders, a Java archive, or an Eclipse project.

  4. Is there an existing Java test object class which adequately represents the custom control? If so, which one?

  5. If not, you need to create a new test object class:

    1. Is there an existing Java object class which can be extended to represent the custom control? If so, which one? If not, your new test object class needs to extend the JavaObject class.

      Note: If you create test object classes that extend test object classes defined in another toolkit support set, you create a dependency between the two toolkit support sets. Whenever you select to load the extending toolkit support set in the UFT Add-in Manager, you must also select to load the toolkit support set that it extends.

    2. Do you want UFT to use a different icon for the new test object? If so, make sure the icon file is available in an uncompressed .ico format.

    3. Specify one or more identification properties that can be used to uniquely identify the control (in addition to the test object class and the fully qualified Java class name of the control).

    4. Specify the default test object method to be displayed in the Keyword View and Step Generator when a step is generated for an object of this class.

  6. Do you want UFT to recognize the custom control as a top-level Java test object?

  7. Does the custom control contain objects that are significant only in the context of this control (meaning, is it a wrapper)? (For example, a Calculator object is a wrapper for the calculator button objects.)

  8. Specify the basis for naming the test object that represents the control.

  9. List the identification properties you want to support.

    If you are creating a new test object class, also decide which properties should be selected by default in the Checkpoint Properties dialog box in UFT.

  10. List the test object methods you want to support. Specify the method argument types and names, and whether it returns a value in addition to the return code.

  11. If the custom control is AWT-based, do you want to provide support for creating UFT GUI tests by using the Record option?

    If so, list the events you want to record on the custom control during a UFT recording session.