|
|
| | Return to Start Page | | |
A guide to using the Open GIS Test Suite test suite
Introduction
The intention of this guide is to get you using the OGC test suite as quickly as possible. For a full user guide please refer to the User Guide
The OGC test suite is implemented as a set of files containing origin content which resides on the same server as this guide, so there are no downloads or compilations to execute. It automatically or manually executes sequences of tests to verify correct behaviour. There are three major steps to each test session:
- Use a standard HTML browser to create and manage your tests on the OGC test suite origin server;
- Connect to the WMS or WFS server that you want to test by running tests through your HTML browser;
- Refresh the standard HTML browser to review your results
Your OGC Account
You will need a username and password for the test suite. You can easily Create a New Account from the OGC test suite start page.
Logging-in
Each time you use the test system, you will be required to log in using your username and password. Most clients remember authentication tokens for some indeterminate period of time (e.g. for the life of the session). If your client is one of these, you may be asked for a username and password only when you enter the system. For other implementations, you may be asked more often. To log in, select the Manage Test Sessions link from the OGC test suite start page
Creating a Test Session
Test session creation is executed from your HTML browser. When you select the Manage Test Sessions option of the main menu, you will be taken to the Test Session Management Menu for Account <username>. From here you can:
- Create a new custom OGC test session.
When you create an OGC test session this will take you to the Customize Test Session (session options) page. From here:
- Select the options and enter details applicable to your device and then click the Configure Test Session button.
- Input the variables and areas that the server under test supports
- You can now either create the test session, or get variables and scopes from the capabilities document of the server under test
- If you select the Add Capabilities Values button, then the values are gained from the capabilities document
- Selecting the Create Test Session button creates the actual test session
- You will now be returned to Test Session Management Menu for Account <username>, where a new test session will be found in the Session table
- Test ID's are numbered from 0001. You can also provide an arbitrary description for your test session.
Once the test session is created, you can manage the session, review test results and examine the test source for each test case in the session. You can also execute the test session from the HTML browser.
Managing your Test Sessions
Test sessions can be managed using your HTML browser. If you select the manage option for a test session, you will be presented with a screen from which you can choose to change the session description, delete the test session, clear the results of the test session, or copy the test session (all tests or tests not passed) to a new, blank test session.
Executing a Test Session
Test session execution can be carried out using your HTML browser. To Execute a test session you can
- Select the View Test Results option for the test session you wish to test. This will take you to the Summary of Test Session page. Select the Execute Test link next to the test from which point you wish your test session to begin execution. Test execution will automatically sequence through the tests in the order they are listed in the summary table.
- Select the Execute Tests option from the test session management menu. This will carry out the test execution as for the previous method except that test execution will start from the starting test. This defaults to the first test in newly created test sessions.
Once test execution has commenced or completed you can view the test results by refreshing the Summary of Test Session page. You can also select the View the configuration settings to view the customised test session options used to create the session.
You can skip individual tests and re-execute those later, or re-execute individual tests that failed (e.g. after repairing the implementation).Once you have set up a test session it is easily executed. To do this simply go to the Summary Of Test Session page and select 'Execute Test' for the test that you want to run. Please note that for automatic tests test execution will continue untill either the end of the test session, or untill the next manual test is encountered.
Reviewing Test Results
Once you have completed execution of one or more test sessions, you can review the results via your HTML browser by refreshing the Summary of Test Session page. When reviewing results, you have the following options:
- You can review a summary of the results for a specific test session by refreshing the Summary of test session page.
- You can see the detailed results for a specific test session by selecting the view log info.
Test results are posted as follows:
- Total Test Count
- Number of Passed Tests
- Number of Failed Tests
- Number of Untested Tests
Summary
The Test System is designed for ease of use. While there are more options than those described above, these are sufficient for getting started. There is nothing you could do that would crash the system, so feel free to experiment with other options as you get familiar with it.
Submit Bug Report • Search Bug Reports • Bug Report Summary • Terms and Conditions
Copyright(C) The Open Group 2004. All rights reserved. Test Engine Created By
