Create object repositories

This exercise describes how to create object repositories, which are collections of test objects used to test your app's user interface.

In this topic:

Define Record and Run settings

Configure learning objects in the MyFlight application as WPF test objects.

To configure learning objects on the application:

1. Start with the MyFlightApplication solution and MyFlight test open. For details, see Create your test structure.

2. Set the Record and Run Settings to define how objects in the app are learned.

   1. Select Record > Record and Run Settings.

   2. Select Record and run only on: Applications opened by UFT and Applications specified below

   3. Click the Add button and browse to the FlightsGUI.exe file at: <Installdir>\samples\Flights Application\FlightsGUI.exe

      Leave the other options in the Application Details dialog box with their default values.

      

3. Click OK to return to the Record and Run Settings dialog box.

   

4. Click OK again to return to the main OpenText Functional Testing window.

   Then, continue with Spy on objects in the MyFlight application.

Back to top

Spy on objects in the MyFlight application

Spy on the available properties and operations for some objects in the MyFlight application.

To spy on the application's objects:

1. Open the MyFlight sample app.

   If the app is already open, close it and re-open it to enable OpenText Functional Testing to recognize it properly. For more details, see Explore the sample MyFlight application.

2. In OpenText Functional Testing, click the Object Identification Center button in the toolbar.

3. Turn on the Multi-object Spy switch and click the Start spying button to spy on multiple objects at a time.

   The OIC window is replaced by the OIC widget , the cursor is changed to a hand icon , and OpenText Functional Testing is hidden to display MyFlight app.

   Switching to a regular Windows cursor

   When switching back and forth between the OIC and any other app, press CTRL to change the cursor from the hand to a normal Windows cursor.

   Hold down the CTRL button for as long as you need the Windows cursor and release it to switch back to the OIC's hand icon.

4. Place the hand on an object in the MyFlight app and watch the captured properties and values displayed in the tooltip.

   

5. Click in the MyFlight Username edit box and Password edit box, and then click the OK button on the Login page.

   The OIC widget shows the number of captured objects.

   When you are done, click the OIC widget to open the OIC window again. The window displays the list of objects you spied.

   

   Note: If you enable the Hover mode before spying, you can hover over an object and the OIC will automatically capture the object.

6. In the OIC window, hover over a spied object and click the Edit button to enter the Edit view. The Edit view shows the object's hierarchy and identification properties.

   

7. Click Close to close the OIC.

Back to top

Add specific objects to the object repository

Add specific objects required for your test to the object repository, one by one.

To add objects to the object repository:

1. In OpenText Functional Testing, select Resources > Object Repository Manager. The Object Repository Manager enables you to manage the object repositories associated with your test, and contain your test objects.

2. In the Object Repository Manager window, select Object > Add Objects. Both OpenText Functional Testing and the Object Repository Manager are hidden.

3. Click in the MyFlights app Username edit box, and then select the agentName object, and click OK.

   

   The agentName object is added to the Object Repository along with its parent object, the OpenText MyFlight Sample window object.

4. Repeat the previous two steps to add test objects for the Password edit box and the OK button.

   

   Drill down to the agentName test object

   In the Test Objects tree, select the agentName object, and notice the object properties shown in the right pane of the object repository. These are descriptive, or identification properties used to identify the object during a run session.

   

5. Save the object repository.

   • In the Saved Shared Object Repository dialog, browse to folder where your solution and test is saved, and create a new folder named TutorialObjectRepositories.

     By default, the solution and test folder is C:%HOMEPATH%\My Documents\UFT One.

   • In the File name field, enter the name as Login.

   Note: This step only saves the object repository. It is not yet associated with your test.

6. Associate the Login object repository with the Login action in your test.

   This enables you to use objects in this repository with any step in the Login action.

   To associate the object repository with the action:

   1. In the Solution Explorer, browse to and right-click the Login node.
   2. Select Associate Repository with Action, and then browse to the Login.tsr file you created in the previous step. Click Yes in the message box that opens.

   The object repository is now associated with the Login action, and is displayed in the Solution Explorer as a child element of the action.

   

7. Save your test. Then, continue to add object repositories for other areas of the MyFlight app.

   For details, see Create object repositories and Navigate and learn.

Back to top

Navigate and learn

Use the Navigate and Learn feature to create shared object repositories for each of the remaining pages in the MyFlight app. Navigate and Learn enables you to learn all objects in a page or section of an application at once.

To create the FlightFinder object repository:

1. In the MyFlight app, log in to display the Book Flight page. Log in using the following credentials:

   • Username: john
   • Password: hp

2. Create a new shared object repository. In OpenText Functional Testing's Object Repository Manager window, click New .

3. Continuing in the Object Repository Manager, select Object > Navigate and Learn.

   Both OpenText Functional Testing and the Object Repository Manager windows are hidden, and the Navigate and Learn toolbar appears.

   

4. Click the Define Object Filter button , and then select Default object types.

   

5. Learn all objects in the Book Flight page of the MyFlight app:

   1. In the MyFlight app, click the Book Flight's title bar to bring it into focus.
   2. In the Navigate and Learn toolbar, click Learn.

   Note: The MyFlight app flickers, and test objects are added to your new object repository.

   Do not interact with the MyFlight app during this process.

6. Close the Navigate and Learn toolbar to return to OpenText Functional Testing and the Object Repository Manager windows.

7. Save your object repository in the TutorialObjectRepositories directory you created earlier, and name it FlightFinder.

8. Associate the new FlightFinder.tsr object repository with the FlightFinder action in your test flow.

   For more details, see how you did this above for the Login action.

Create additional object repositories

Repeat these steps to create additional object repositories for the remaining MyFlight app page. Save your test as you go, and name each object repository according to the associated action name.

Action and repository summary

When you're done, your test will have object repositories for the following pages:

MyFlight page name	Object repository name	Associated action
Login	Login	Login
Book Flight	FlightFinder	FlightFinder
Select Flight	SelectFlight	SelectFlight
Flight Details	FlightConfirmation	FlightConfirmation

Back to top

More about objects and object repositories

OpenText Functional Testing uses test objects to recognize objects in your apps while running your test.

Each of these test objects is based on the test object model, which is a large set of object types, or classes. Each test object class has:

• A list of available description properties used to learn the object
• A list of relevant operations that can be performed on that object.

Each test object class is part of a larger test object hierarchy. For example, the agentName test object is a child object of the OpenText MyFlight Sample window object.

Run-time objects are the actual objects in your app. When you add an object to an object repository, the properties of the run-time object are learned and translated into test objects.

Object repository recommendations

We recommend:

Back to top

Next steps:

• Add steps from the Keyword View