Help document for the WebCGM TS harness frameset
Contents
There are four frames in the WebCGM test harness frameset:
- top
- This is the title bar, and contains the buttons (links) to the traceability features, including the WebCGM Reference button (link).
- bottom
- The bottom frame initially contains the navigation bar -- buttons to
go to next test, previous test, table of contents, etc. -- as well as
the Operator Script. The bottom window
is also used by default for presentation of traceability features -- spec reference,
test assertions, etc -- when those buttons are activated.
- right middle
- The right middle frame contains the source for the test -- an html or
CGM file. Often it has a link that is activated to execute the test.
The instructions will be found in the Operator
Script.
- left middle
- This is the reference frame -- it contains a reference image that
shows what should be seen upon successful execution of the test. The Operator Script describes how it should be
used.
Use the buttons at the top of the bottom frame. They are
self-explanatory:
- next: next test in the series
- previous: previous test in the series
- contents: table of contents for all tests
The parent and child buttons are not implemented (they refer to a planned
addition of detailed tests to explore functionality in more depth).
The operator script (bottom frame) defines the Test Purpose, describes how
to execute the test, and describes the verdict criteria -- pass/fail -- for
the execution of the test.
Traceability features refer to links from the test case back to
the test assertions upon which the test case is based. Features in this
release of the WebCGM Test Suite:
- The WebCGM Reference button (link) of the top frame will
present, in the bottom (operator script) frame by default, the
principal test assertion associated with the test case.
- The initial view of the information is a table, whose top (targetted)
row contains the principal test assertion:
- id of the assertion;
- one or more references (hyperlinked) to the WebCGM spec;
- a paraphrasing of the test assertion.
- If you activate the link(s) to the WebCGM spec from this t-a table row,
you will be taken to the closest anchor in that (W3C Recommendation)
document. Be aware that the assertion may not be exactly at that
location, but it will be in that numbered section.
- The reference to the spec in the 2nd column uses conventions to help
you further find the assertion, from the numbered section header:
- pn means paragraph n, e.g., 3.1.2.2.p7 refers
to the seventh paragraph of that section.
- sn means sentence n, e.g., 3.1.2.2.p9.s2
refers to the 2nd sentence of the 7th paragraph.
- lin means nth numbered item in a list.
- tbl.rn.cm means the nth row, mth column of
the table at that location, e.g., 3.1.2.2.tbl.r6.c2.
- etc
- Many browsers will give the option, if you right-click the link (or
equivalent action), to opt for a new blank window for the information, in
case you don't want it in the bottom window.
- If the traceability information has been displayed in the bottom frame,
then the browser back button may help you to get back to the
Operator Script.
All Test Assertions
Future feature. The principal test assertion (above) may be one
of several that importantly affect the correct execution of the test.
- Activating this All Test Assertions button (link) will
present, in the bottom frame by default, a list of all of the test
assertions for this test case.
- Each test assertion id is a hyperlink to the appropriate row of the
test assertions table, as described in the previous section.
- As with the WebCGM Reference button, browsers will often give
right-button options to present the linked information in another (new)
window instead of the bottom frame.
.