How to delete objects from the object repository?

Removing objects from a local object repository:
1. Go to Resources -> Object Repository.
2. In the Filter combobox, select “Local Objects.”
3. In the object tree, select the object to be removed.
4. Click the delete toolbar button.
5. Click <Yes> to confirm the deletion.
6. Save the test to save the updated local repository.

The object, and any children it may have, will be removed.

Removing objects from a shared object repository:
1. Go to Resources -> Object Repository Manager.
2. Go to File -> Open. Navigate to the desired Shared Object Repository file.
3. By default, the repository will open in read-only mode. Go to File -> Enable Editing.
4. In the object tree, select the object to be removed.
5. Click the delete toolbar button.
6. Click <Yes> to confirm the deletion.
7. Save the updated shared repository.

The object, and any children it may have, will be removed.

How to add objects to the object repository (QTP 9.0)?

Adding objects to a local object repository:
An object can be added to the local object repository in one of the following ways:

1. Record some actions on the object; this will automatically add this object to the object repository. If you do not need the recorded statements in your script, you can delete them and it will not remove the added object from the object repository.

2. Add objects manually.

1. Go to Resources -> Object Repository.
2. In the Filter combobox, select “Local Objects.”
3. Go to Object -> Add Objects to Local.
4. Click on the object to be added to the repository.
5. If the Object Selection window appears, select the desired object, and click <OK>.
6. If the Add Object to Object Repository window appears, select the appropriate option:

   To add only the selected object, select the “Only the selected object” radio button. To add the selected object and its child objects of a specified type, select the “Selected object and its descendants of type” radio button. Then, select the checkbox next to the child object types that should be added.

7. Click <OK>.

3. Manually define a new test object.

1. Go to Resources -> Object Repository.
2. In the Filter combobox, select “Local Objects.”
3. Go to Object -> Define New Test Object.
4. Select the appropriate Environment for your test object. For example, to add a Link object, select “Web.”
5. Select the desired test object class for the new object.
6. Enter a name for your test object.
7. Fill in the Test object details as needed. The Test object details area automatically contains the mandatory properties defined for the object class in the Object Identification dialog box. You can add or remove properties as required, and define values for the properties.

   To add properties, click the “Add description properties” button (with the + icon). Select the properties to be added and click <OK>.
   To remove properties, select the properties to be removed, and click the “Remove selected description properties” button (with the X icon)

8. Click <Add> to add the new object.
9. Repeat steps d through h as needed.
10. When done, click <Close>.

Note:
When you manually define an object, QuickTest Professional will not automatically add the object’s parent. If the parent objects are not present, you will need to define them as well. Once the objects are added to the repository, you can drag-and-drop them to their appropriate positions.

4. Add the object using the Active Screen.

1. In the Active Screen, right-click on the object to be added.
2. Select “View/Add Object.”
3. If the Object Selection window appears, verify the desired object is selected, and click <OK>.
4. In the Object Properties window, click <Add to Repository>.

Adding objects to a shared object repository:
An object can be added to a shared object repository in one of the following ways:

1. From a local repository.
2. Add objects manually.

1. Go to Resources -> Object Repository Manager.
2. Go to File -> Open -> <repository to open>.
3. By default the repository will open in read-only mode. Go to File -> Enable Editing.
4. Go to Object -> Add Objects.
5. Click on the object to be added to the repository.
6. If the Object Selection window appears, select the desired object, and click <OK>.
7. If the Add Object to Object Repository window appears, select the appropriate option:

   To add only the selected object, select the “Only the selected object” radio button. To add the selected object and its child objects of a specified type, select the “Selected object and its descendants of type” radio button. Then, select the checkbox next to the child object types that should be added.

8. Click <OK>.

3. Manually define a new test object.

1. Go to Resources -> Object Repository Manager.
2. Go to File -> Open -> <repository to open>.
3. By default the repository will open in read-only mode. Go to File -> Enable Editing.
4. Go to Object -> Define New Test Object.
5. Select the appropriate Environment for your test object. For example, to add a Link object, select “Web.”
6. Select the desired test object class for the new object.
7. Enter a name for your test object.
8. Fill in the Test object details as needed. The Test object details area automatically contains the mandatory properties defined for the object class in the Object Identification dialog box. You can add or remove properties as required, and define values for the properties.

   To add properties, click the “Add description properties” button (with the + icon). Select the properties to be added and click <OK>.
   To remove properties, select the properties to be removed and click the “Remove selected description properties” button (with the X icon)

9. Click <Add> to add the new object.
10. Repeat steps d through h as needed.
11. When done, click <Close>.

Note:
When you manually define an object, QuickTest Professional will not automatically add the object’s parent. If the parent objects are not present, you will need to define them as well. Once the objects are added to the repository, you can drag and drop them to their appropriate positions.

4. Merge with another shared object repository.  

How to merge object repository files (QTP 9.0)?

Merging a local object repository with a shared object repository:
To merge the contents of a local repository into a shared repository, the shared repository must be associated with the action containing the local repository. In the Object Repository Manager, select the “Update from Local Repository” option.

Updating the Shared Object Repository with the objects in the Local Repository will merge all objects from the Local Repository into the Shared Repository. All objects will be removed from the Local Repository.

1. Save the script containing the Local Repository. Open a new test.
2. Go to Resources -> Object Repository Manager.
3. In the Object Repository Manager window, go to File -> Open, and select the Shared Object Repository file. Clear the “Open in read-only mode” checkbox.
4. If the repository file opened in read-only mode, go to File -> Enable Editing.
5. Go to Tools -> Update from Local Repository.
6. Click the “Add Tests” icon button. If you are connected to a TestDirector for Quality Center with Business Process Testing, you will have the option to browse for a test or a component. Select the appropriate choice.
7. Navigate to the test or component containing the Local Repository.

Note:
You can only add a test containing actions that are associated with the Shared Object Repository you are updating and whose Local Object Repositories contain objects.

8. In the Update from Local Repository dialog, select the desired action.
9. Repeat steps 6 through 8 as needed.
10. Click <Update All>.

Note:
If the test using the Shared and Local Repositories is currently open, you may receive an error similar to the following:

“You cannot update this shared object repository from the <path> test’s local object repository because the test is currently locked by ‘<username> on machine ‘<machine name>’. Wait for the test to be unlocked and then try to perform the update operation for this test again.

If so, open a new test in QuickTest Professional to release (unlock) the test and repeat step 10.

11. Perform any steps needed to resolve conflicts.
12. If you are performing multiple merges, go to File -> Save and Merge Next to perform the next merge (the Local Object Repository of the next action being merged into the Shared Object Repository).
13. Click <Yes> to save your changes between merges. If you click <No>, the current merge (objects merged from the last action) will not be saved.
14. Repeat steps 11 through 13 to complete the multiple merges.
15. Choose File -> Exit, then click <Yes> to save the updated Object Repository.  

Merging shared object repositories:
1. Open the Object Repository Manager.
2. Go to Tools -> Object Repository Merge Tool.
3. In the New Merge window, browse to the primary repository file. Mercury recommends selecting the repository file you have invested the most time into as the primary repository file.
4. Select the secondary repository file.
5. Click <OK>.
6. Review the merge statistics, as described in Viewing Merge Statistics, and click <Close>.
7. Resolve any merge conflicts that were reported.

Resolving object conflicts:
Conflicts between objects in the primary and secondary object repositories are resolved automatically by the Object Repository Merge Tool using default resolution settings. For information on defining the default settings, refer to the QuickTest Professional User’s Guide (Help -> QuickTest Professional Help -> QuickTest Professional User’s Guide -> Managing and Merging Object Repositories -> Merging Shared Object Repositories -> Defining Default Settings).

The Object Repository Merge Tool also allows you to change the way the merge was performed for each individual object that causes a conflict.

1. In the object repository tree, select an object that has a conflict (there will be an icon to the left of the object name). The conflicting objects are highlighted in the source repositories. A description of the conflict and the resolution method used by the Object Repository Merge Tool is described in the Resolution Options pane.
2. In the Resolution Options pane, select a radio button to choose a resolution method. The target object repository is updated according to your selection and redisplayed.

Note:
The resolution method the Merge Tool used is selected by default.

3. Click <Previous Conflict> or <Next Conflict> to jump directly to the next or previous conflict in the target object repository hierarchy.
4. Repeat steps 1 through 3, as needed.
5. Save the merged object repository file

What is the QuickTest Automation Object Model and how is it used?

You can use the QuickTest Professional Automation Object Model to write programs that automate your QuickTest operations. The QuickTest Automation Object Model provides objects, methods, and properties that enable you to control QuickTest from another application.The new QuickTest Professional Automation Object Model enables you to automate test management.

You can now control virtually every QuickTest feature and capability using the objects, methods and properties included in the QuickTest Professional Automation Object Model. Automation scripts make it easy to perform any QuickTest operation multiple times in multiple tests without having to open the QuickTest application, for example,

• You can write a script that modifies the test object description properties in the Object Identification dialog box and performs an update run on all tests in a specified file folder.
• After installing a new add-in, an automation script can associate this add-in to all relevant tests.
• You can write an automation script to run a selected batch of tests. For each test, you can retrieve the associated add-ins list. Then, if the necessary add-ins are not already loaded, you can close QuickTest, load the necessary add-ins, reopen QuickTest, and run the test.
• You can define your settings for a test in QuickTest, then click “Generate Script” in the Generate tab of the Test Settings dialog box to generate an automation script based on the current test settings. You can then apply those same settings automatically to multiple tests using the whole automation script or excerpts from the generated file.

Example:
You can create and run an automation program from Microsoft Visual Basic that loads the required add-ins for a test, starts QuickTest in visible or minimized mode, opens the test, configures settings that correspond to those in the Options, Test Settings, and Record and Run Settings dialog boxes, runs the test, and saves the test.
Creating automation programs:
The Properties tab of the Test Settings dialog box, the General tab of the Options dialog box, and the Object Identification dialog box each contain a “Generate Script” button. Clicking this button generates a automation script file (.vbs) containing the current settings from the corresponding dialog box.

You can run the generated script as is to open QuickTest with the exact configuration of the QuickTest application that generated the script, or you can copy and paste selected lines from the generated files into your own automation script.

Generating an automation script for QuickTest Professional options:
1. Go to Tools -> Options.
2. Select the General tab.
3. Click <Generate Script>.
4. Save the script to the desired location.
5. Click <OK> to close the Options dialog.

Generating an automation script for test settings:
1. Go to Test -> Settings.
2. Select the Properties tab.
3. Click <Generate Script>.
4. Save the script to the desired location.
5. Click <OK> to close the Test Settings dialog.

Generating an automation script for object identification settings:
1. Go to Tools -> Object Identification.
2. Click <Generate Script>.
3. Save the script to the desired location.
4. Click <OK> to close the Object Identification dialog.
The QuickTest Automation Object Model Reference file is a help file that provides detailed descriptions, syntax information, and examples for the objects, methods, and properties in the QuickTest Automation Object Model.

Use an Automation Object Model to load the Shared Object Repository?

QuickTest Professional 9.0
QuickTest Professional 9.0 does not support dynamically loading object repositories at runtime. AOM statements are not designed to be executed from within a test script.

QuickTest Professional 9.0 does allow you to associate and load (not at runtime) multiple Object Repository files.
QuickTest Professional 8.2 and below
Use the Automation Object Model to specify the path to a Shared Object Repository:

Dim App ‘As Application
Set App = CreateObject(“QuickTest.Application”)
App.Test.Settings.Resources.ObjectRepositoryPath = “<PathToYourSharedRepositoryTsrFileHere>”

Note:
Be sure to replace <PathToYourSharedRepositoryTsrFileHere> with the path to the repository you want to use.

Now the test will load and use the specified Shared Object Repository.

Note:
You may be able to execute the AOM statements from within a script, however they are not intended to be used this way. Whenever possible, check your conditions and modify the settings in an external .vbs file before the test execution begins.

How to associate Shared Object Repositories to the test (QTP 9.0)?

With QuickTest Professional 9.0, you can associate multiple Shared Object Repositories with each action. Each action will always be associated with a Local Object Repository and can also be associated with one or more Shared Object Repositories.

Note:
All Shared Object Repositories are associated at the action level, not the test level, in QuickTest Professional 9.0. If you open a test that was created with an earlier version of QuickTest Professional, the Shared Object Repository will be associated with all of the test’s actions automatically.

Associating Shared Object Repositories with an action:
1. Right-click on the action, and select “Action Properties.”
2. Select the Associated Repositories.
3. Click the “Adds a new shared object repository file to the list” button (with the + icon).
4. Browse to and select the desired Shared Object Repository.
5. Repeat steps 3 and 4, as needed.
6. If needed, move the selected repository files up and down in the list using the arrow buttons.

Associating Shared Object Repositories with multiple actions in one script:
1. Go to Resources -> Associate Repositories.
2. In the Associate Repositories dialog, click the “Add Repository” button (with the + icon).
3. Browse to and select the desired Shared Object Repository file.
4. Repeat steps 2 and 3 as needed for all Shared Object Repository files.
5. Select one of the repository files.
6. In the Available Actions list, select the actions the Shared Object Repository should be associated with.
7. Click the “>” button. The selected actions will move to the Associated Actions list. If you want to associate the file to all actions, click the “>>” button.
8. Repeat steps 5 through 7 for all repository files in the list.
9. Click <OK>.

Associating Shared Object Repositories with all new actions:
1. Right-click on the action, and select “Action Properties.”
2. Select the Associated Repositories.
3. Click the “Adds a new shared object repository file to the list” button (with the + icon).
4. Browse to and select the desired Shared Object Repository.
5. Repeat steps 3 and 4, as needed.
6. If needed, move the selected repository files up and down in the list using the arrow buttons.
7. Click <Set as Default>.
8. Click <OK>.

Note:
Any new action created after this option has been set will use the specified Shared Object Repository files by default. To modify existing scripts, you will need to use one of the first two options.

How to set the Shared Object Repository option for a test ?

To set only one test to use the Shared Object Repository option:
1. Click the “New” button or go to File -> New to open a new test.
2. Go to Test -> Settings.
3. Select the Resources tab.
4. In the Object repository type box, select one of the options:

• Select “Per-action” to set the Object Repository mode for your test to the Object Repository per action mode.
• Select “Shared” to set the Object Repository mode for your test to the Shared Object Repository mode.

5. If you selected Shared in step 4, specify the Shared Object Repository file you want to use as the test’s Object Repository file. To specify a file, enter the Object Repository file name or click the “Browse” button and select a resource file (*.tsr) from the Open dialog box. To create a new Shared Object Repository file, enter a new file name in the Shared box.Note:
These steps need to be done in a new script. Once you have modified the script, you will not be able to change the option.

To set all new scripts to use a Shared Object Repository:
For QuickTest Professional 6.5 and above
1. Click the New button or go to File -> New to open a new test.
2. Go to Test -> Settings.
3. Select the Resources tab.
4. Select the Shared option for the “Object-repository type”.
5. Specify the Shared Object Repository file you want to use as the test’s Object Repository file. To specify a file, enter the Object Repository file name or click the ellipse button <…> and select a resource file (*.tsr) from the Open dialog box. To create a new Shared Object Repository file, enter a new file name and path in the Shared box.
6. Click the “Set as Default” button.
7. Click <Apply> and <OK>.

For previous versions of QuickTest Professional:
1. Click the New button or go to File -> New to open a new test.
2. Go to Tools -> Options.
3. Select the Resources tab.
4. Select the Shared option for the “Default object repository type.”
5. Specify the Shared Object Repository file you want to use as the test’s Object Repository file. To specify a file, enter the Object Repository file name or click the “Browse” button and select a resource file (*.tsr) from the Open dialog box. To create a new Shared Object Repository file, enter a new file name in the Shared box.
6. Click <Apply> and <OK>.

Note:
Any new script created after this option has been set will use the Shared Object Repository by default.