Create a Thesaurus
Any site-builder can create a simple Thesaurus (one which uses just the 'necessary' tags, as listed below). The creation of more complex Thesauri (which make use of the 'optional' tags), is best carried out with the assistance of Sitekit staff.
Thesaurus Format
<?xml version="1.0" encoding="ISO-8859-1"?>
<thesaurus>
<thesaurusID>33</thesaurusID>
<concept>
<descriptor>Your data 1</descriptor>
<TNR>01</TNR>
<STA>Provisional</STA>
<TYP>Descriptor</TYP>
</concept>
<concept>
<descriptor>Your Data 2</descriptor>
<TNR>02</TNR>
<STA>Provisional</STA>
<TYP>Descriptor</TYP>
</concept>
<concept>
</thesaurus>
Thesaurus Tags
Tag | Necessary | Possible Values | Default | Notes |
<thesaurus> | yes | encloses all items | n/a | defines start and end of thesaurus |
<thesaurusID> | yes | (integer) | n/a | *Explained fully below |
<concept>
| yes | Encloses an item/term | (none) | Encloses all other tags for an entry |
<descriptor> | Either descriptor or non-descriptor | (text) | (none) | Thesaurus entry/term |
<non-descriptor> |
| (text) | (none) | Link to thesaurus entry |
<BT> | no | (text) | (none) | Link to broader category (parent) |
<NT> | no | (text) | (none) | Link to narrower category (child) |
<USE> | no | (text) | (none) | Term to use instead of the current item |
<UF> | no | (text) | (none) | Term that you should use current item instead of |
<RT> | no | (text) | (none) | Related term. |
<SC> | no | (text) | (none) | Subject category |
<TNR> | no | (text) | (none) | Term number |
<STA> | no | (text) | (none) | Status |
<TYP> | no | (text) | (none) | Type |
Notes
- ThesaurusID is the id of an existing thesaurus for an update to an existing thesaurus. Note that if the descriptor (or non-descriptor) matches then the entry is updated. If the descriptor (or non-descriptor) is not found in the thesaurus, then the entry is added as a new Thesaurus. No entries are deleted.
- When you create a new Thesaurus, do NOT specify an ID Number. This will be created automatically when you ADD the thesaurus.
- Thesaurus Name should be entered manually. Thesaurus will not work correctly without the name added.
- Sitekit CMS will display a warning if it can’t find a field that is in the metadata scheme – or has a field which is not in the scheme. The warning message will explain the problem and how it can be resolved.
- You will be able to change the order of items in the metadata scheme and they will be displayed in admin in the order they are in the scheme – without problems of backward compatibility.
Example Simple Thesaurus
The example below shows a minimalist Thesaurus. It simply provides a list of three titles - Manager, Director and Consultant - which could be used as a picklist in a Metadata Scheme. Remember that you do not need to assign the thesaurusid, since this is created for you automatically when you Add the thesaurus to your site.
<?xml version="1.0" encoding="ISO-8859-1"?>
<thesaurus>
<thesaurusID>167</thesaurusID>
<concept>
<descriptor>Manager</descriptor>
</concept>
<concept>
<descriptor>Director</descriptor>
</concept>
<concept>
<descriptor>Consultant</descriptor>
</concept>
</thesaurus>