Resource Directory (RDDL document) for BenToWeb TCDL 1.1.
This Version: 11 January 2006.
Latest Version: http://bentoweb.org/refs/TCDL1.1.
Previous Version: 11 August 2005 (TCDL 1.0).
Test Case Description Language (TCDL) is an XML-based language defined by BenToWeb to store metadata for the test cases in the test suites for Web Content Accessibility Guidelines (WCAG) 2.0. For each individual test case, it describes:
TCDL is defined in
W3C XML Schema
and uses the namespace
the XML Schema is available at
http://bentoweb.org/refs/schemas/tcdl1.1.xsd and contains detailed documentation.
The next section provides a less technical description of TCDL. It also shows which metadata elements TCDL
has in common with those suggested in the
W3C Note on Test Metadata by adding “W3CTM” to the description.
Each test case has a unique identifier (stored as a mandatory ID attribute of the test case description; W3CTM) that uses the format technology_wcag2_date_x.y_lz_scz_nnn, where the sections separated by underscores have the following meaning:
The formal or administrative metadata that can be stored are:
BenToWeb uses the term “technology” in the same sense as WCAG 2.0:
a data format, programming or markup language, protocol or API.
TCDL provides the ability to store the following information about technologies used in a test:
This mandatory section provides a brief explanation of the reason why the test was developed (W3CTM).
The W3C Note on Test Metadata
defines preconditions as
conditions that must be met before the test can be successfully executed.
This section was added to TCDL for other users of the language.
It is not used in BenToWeb because test cases map to success criteria instead of tests.
However, the current HTML Test Suite for WCAG 2.0 uses “prerequisite tests”, and these could be described here.
This section describes:
Each scenario has a mandatory identifier that is unique within the test case description. This identifier is necessary to map end user feedback to the scenarios.
This section contains information about each of the test files that are relevant to the rule or success criterion:
Supporting files such as included images, external style sheets and dummy pages to which forms are submitted (if only the form is relevant to the test) etcetera, are not documented.
This section contains the “rules” that are tested by a test case. In BenToWeb, rules are generally WCAG 2.0 success criteria, but it is also possible to reference other sets of “rules”:
The rules do not provide a direct reference to the relevant online source because it may not always be possible to reference “rules” directly (for example, because they are not available in HTML). The rules reference a rule ID in a “Rulesets XML” file (see Rulesets XML RDDL document), which in turn references the relevant rule in an online source.
For each rule listed in this section, the following information can be provided:
This optional section is important for test cases based on test files that use XML-based technologies.
The technology features (see the section on Technologies above) used in a test case exist in an
XML namespace and
should be referenceable with XPath.
The normal mechanism for mapping namespaces to URIs by declaring them with
xmlns:prefix="namespaceURI" cannot be used for this,
because it is necessary to be able to define empty prefixes and to extract the namespace mappings with a common XML API.
The W3C Working Group Note “Test Metadata” (14 September 2005)
suggests fourteen metadata elements for test suites. The table below shows how these metadata elements map to TCDL elements.
(TCDL elements are identified by means of XPath expressions without a namespace prefix and with the root element —
testCaseDescription — omitted,
except for the attributes of that element.)
||In TCDL, titles are not necessarily unique; they don't duplicate the identifier.|
||In TCDL, the description should help the reviewer understand how the test materials are constructed and the behaviour when a user interacts with it.|
|In TCDL, two types of specifications need to be referenced: the accessibility guidelines (“rules”) and the specifications of the technologies in the test.|
||Not used in BenToWeb, because test cases map directly to WCAG success criteria instead of tests.|
||Only for the special case where it is necessary to (re)create a specific HTTP request.|
||Not used in BenToWeb; a version control system (CVS) is used instead.|
|Contributor||-||BenToWeb does not have external contributors, but can borrow test files and document them at
|TCDL can document rights related to a test case and rights related to borrowed materials.|
|Grouping||-||(Because of the strict filename convention in BenToWeb, some types of grouping can be done by means of filename pattern matching.)|
BenToWeb's TCDL was developed completely independently from the TCDL proposal submitted by IBM to the W3C Quality Assurance Working Group (QA WG) in 2003.
The goal of IBM's TCDL is to catalogue most of the test materials that a W3C Working Group would provide.
It is intended to be used in a test lab “
to set up and run the test materials against one or more test subjects” and
supports automated setup of the system(s) used for testing, automated running of test cases, automated comparison of results, and automated cleanup of the system(s)”.
Like BenToWeb's TCDL, IBM's TCDL is an XML vocabulary,
so metadata can be tranformed in other formats for human or machine consumption.
An IBM TCDL catalogue contains a list a test cases, whereas a BenToWeb TCDL contains metadata for an individual test case only. BenToWeb's TCDL is also different because each test case references at least two specifications (WCAG 2.0 or another ruleset, and a specification of a technology such as XHTML or CSS), and one of these (WCAG 2.0) cannot be tested fully automatically.
Unfortunately, it is not possible to make a detailed comparison of the two languages because the XML Schema for IBM's TCDL submission is not available (the link to the Schema in Section 7.4 does not lead to a file).