Query Accessibility

Accessibility Query Window

The Accessibility Query window enables you to query the database for accessibility of HTML and XHTML documents. It also enables you to inpect the audit trail for a page, and to perform your own evaluation.

[screenshot: Accessibility Query]

The Query Form

At the top of the window is the accessibility query form, comprising two fields and a Query button.

Base

The Base field allows you to specify a base URL for a query. Only URLs that match the value of the base will be listed in the query results. For example, a value of http://www.example.com/abc/ will list only results under the path /abc/ at the domain www.example.com.

Limit

This field limits the number of query results returned. This can be used to work through results in manageable-sized chunks, as repeating the query will cycle through all results so long as the value of Base remains unchanged.

Query

The Query button executes the current query and shows results in the display area below the query form.

The Query Results

The query results are shown as a simple list of URLs, together with the current status. The status can be any of:

Unknown
No evaluation has been completed. So long as valetd is running, this condition is guaranteed to be transient.
Pass
The document is deemed to meet the guidelines in full.
Review
An evaluation has been completed, but no firm conclusion was reached. This is common when a document has been automatically assessed but requires human evaluation. It can also be generated by a human assessor.
Fail
The document fails to meet the guidelines, but no specific conclusion was reached. This outcome can only be generated by automatic assessment; a human will instead decide to Accept or Repair the document.
Accept
This records an informed decision to accept a document that violates some part of the guidelines. Only a human assessor can generate this result.
Repair
An assessment has identified specific repairs required to meet the guidelines. Only a human assessor can generate this result.

Accessibility Audit

Unlike validation, accessibility analysis is not a deterministic process with a uniquely correct outcome. Site Valet therefore provides for human evaluation as well as the automatic process. More than one evaluation may take place, and more than one conclusion may be reached, even if the document itself hasn't changed.

When any URL is selected in the Query Results, the Audit Trail for it is displayed, and you have the option to perform your own Evaluation.

Evaluation

The Evaluate button loads the selected URL into an evaluation window. This enables you to perform and record your own evaluation. According to local policy, this may be a privileged operation (see your system administrator if in doubt).

Audit Trail

Site Valet keeps an audit trail for every URL. This records all evaluations that have been performed on it. Whenever a URL is selected in the results list, a list of results is displayed in the lower part of the window. This shows:

  • Evaluator - who performed the evaluation. This can be Site Valet's automatic agent htnorm, or the identity of the logged in user who performed an evaluation.
  • Date
  • Guideline - the guidelines evaluated to.
  • Result - the outcome of the evaluation.
  • Report URL - the URL of a report documenting an evaluation. This is only available when a human assessor has elected to publish a report.