Zthes

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.