Preparing TestComplete Tests That Work With Local Network Resources

Name Mapping

Methods and Operations in Your Tests

Web Accessibility and Web Comparison Checkpoints

In TestComplete, the Name Mapping repository stores objects used in your tests and their identification properties. Some objects, for example, a web page, can be identified by their URL address:

Click the image to enlarge it.

For such objects, replace all localhost, 127.0.0.1 and file:/// occurrences with the appropriate paths:

1. In your TestComplete project, open the Name Mapping repository.

2. Select Replace from the Edit menu in TestComplete. TestComplete will open the Replace dialog.

3. In the dialog, in the Find what edit box, enter the address you want to replace. For example, localhost, 127.0.01, or file:///<web_page_path>.

4. In the Replace with edit box, enter the address your tests will use to access the web application or a web page from CrossBrowserTesting environments (see above).

5. In the Look in drop-down box, select Current Document or Panel. (Make sure that the Name Mapping editor is currently opened and focused in TestComplete).

   

6. Click Replace All.

TestComplete will replace all the specified text occurrences in the Name Mapping repository with the needed text.

Tip: To keep your tests valid for running both from your local computer, and in CrossBrowserTesting environments, you can do the following:

• Use wildcards. For example, the local* pattern matches both localhost and local. This way, your tests will be able to recognize your local tested application correctly when run both from your local computer and from CrossBrowserTesting environments:

  

  Click the image to enlarge it.

• Use Name Mapping configurations. For example, you can have one configuration for running tests on your local computer, and another - for running tests in the CrossBrowserTesting environments. You can switch between the configurations manually before running your tests:

  

  Click the image to enlarge it.

In your tests, you can access your tested web page or web application located in your local network or in your local computer and simulate user actions over its UI elements. To access the web page or web application, operations in keyword tests and methods in script tests use its URL address. For example, the Navigate operation in keyword tests and the Browser.ToUrl method in script tests use the URL address of the web page to which they navigate a web browser. Various On-Screen Action operations and scripting methods use the URL address to specify a web page over the elements of which they simulate user actions:

Click the image to enlarge it.

Update all the operations and methods to use proper URLs to work with your local test resources from the CrossBrowserTesting environments:

1. Select Replace from the TestComplete Edit menu. TestComplete will open the Replace dialog.

2. In the dialog, in the Find what edit box, enter the text you want to replace. For example, localhost, 127.0.0.1 or file:///.

3. In the Replace with edit box, enter the address your tests will use to access the web application or a web page from CrossBrowserTesting environments (see above).

4. In the Look in drop-down box, select the needed scope.

   

5. Click Replace all.

TestComplete will replace all the occurrences of the specified text in script and keyword tests in the selected scope with the needed text.

Web Comparison checkpoints verify the tested web page’s contents or structure against its baseline copy stored in your project. Web Accessibility checkpoints verify that the tested web page conforms to a number of accessibility standards and guidelines. These checkpoints store the name of the tested web page to verify (along with other verification settings) in the Stores > Web Testing collection of your project:

Make sure that the Web Accessibility and Web Comparison checkpoints that verify web pages residing on your local computer or in your local network can access them from CrossBrowserTesting environments:

Click the image to enlarge it.