Renaming windows and controls

It is important to make sure windows and controls in the application repository use intuitive names that are consistent with the tested application. For example, when you recorded the first script against an application, QA Wizard Pro named a Username field control as editbox8. You can rename the control to use the field name to more easily identify it in the repository and scripts.

Windows and controls are displayed alphabetically in the repository. When you rename windows and controls, use the same name as in the application or use a naming convention that groups similar controls. For example, to group buttons, rename the OK and Cancel buttons in the repository to buttonCancel and buttonOK.

Tip: When you review new windows and controls in the Repository Changes dialog box after recording a script or populating the application repository, QA Wizard Pro suggests names for them based on property values captured from the application. To use a different naming format for new controls, you can override the default naming convention for specific control types to reduce the time spent manually renaming windows and controls. See Overriding naming conventions for new controls.

1. Select a window or control in the Application Repository pane.

A screenshot of the window is displayed in the Preview pane. If a control is selected, it is outlined with a red box in the screenshot.

Note: To adjust the Preview pane to view the entire screenshot, double-click the pane title bar. Adjust the pane size or use the zoom buttons to adjust the image. You can also select controls in the Preview pane to quickly locate them in the Application Repository pane.

2. Compare the name in the application repository to the selected window or control in the Preview pane and decide if it needs to be renamed.

3. To rename the window or control, select it and choose File > Properties.

The Properties dialog box opens.

Tip: To rename a window or control without opening the Properties dialog box, right-click it in the Application Repository pane and choose Rename.

4. Enter a new Name for the window or control.

Window names must be unique within the application version and control names must be unique within the window they are grouped with in the repository.

5. Click OK to save the changes.

The window or control name is changed in the repository.

Note: When you rename a window or control, scripts created before the change will not work until you update them. See Synchronizing with the application repository.