The Zthes context-set for CQL, v1.0.1

1st May 2006

(See The Zthes Context-Set for CQL for an overview of what this is and what it's used for.)

Indexes

Version 1.0.1 of the Zthes context-set is uniquely identified by the URI http://zthes.z3950.org/cql/1.0.1

It contains the following indexes:

Name	Equivalent Zthes-1 Access Point	Description
qual	1	searches in the `termQualifier` element of the top-level term record
type	2	searches in the `termType` element of the top-level term record
admin	3	Used for a variety of searches related to administrative details of thesaurus structure - see below.
nt	4 with semantic qualifier `NT`	searches for all narrower terms of the record whose `termID` is equal to the search term. For example, a search for `nt=abc123` finds all the narrower terms of the record whose `termID` is `abc123` - Note, not the records of those terms that have `abc123` as a narrower term.
bt	4 with semantic qualifier `BT`	searches for all broader terms of the record whose `termID` is equal to the search term.
use	4 with semantic qualifier `USE`	searches for the preferred term of the record whose `termID` is equal to the search term.
uf	4 with semantic qualifier `UF`	searches for all non-preferred terms of the record whose `termID` is equal to the search term.
rt	4 with semantic qualifier `RT`	searches for all ``related terms'' of the record whose `termID` is equal to the search term.
le	4 with semantic qualifier `LE`	searches for all linguistic equivalents of the record whose `termID` is equal to the search term - that is, preferred terms representing the same concept - or ``sufficiently close'' concepts - in different languages.
vocab	5	Searches in the `termVocabulary` element of the top-level term record.
cat	6	Searches in the `termCategory` element of the top-level term record.
status	7	Searches in the `termStatus` element of the top-level term record.
approval	8	Searches in the `termApproval` element of the top-level term record.
sortkey	9	Searches in the `termSortkey` element of the top-level term record. This is not a useful thing to search for, but the index may also more reasonably be used in CQL sort specifications, in queries such as: `dc.title=science sortby zthes.sortkey`

The admin index must be used with one of a small set of well-known strings as the search term. Servers may support the following values:

``start''	Searches for all records considered suitable as starting points for browsing.
``whole''	Searches for a special record describing the thesaurus as a whole, and containing material such as introductory text and revision history that might be front matter in a printed thesaurus. This record, when it exists at all, may not be found in any other search.

Sample queries

The following CQL queries are representative of what may be used to search Zthes databases, assuming that the zthes index-prefix has its conventional meaning.

zthes.type=PT: Finds all preferred terms in the database.
zthes.admin=whole: Finds the single ``whole thesaurus'' record - a self-describing XML record containing the equivalent of ``front matter'' in a printed thesaurus.
zthes.nt=sauropod and zthes.bt=macronaria: Finds records which are narrower terms of the record with termId=sauropod, and which are also broader terms of macronaria.