Files:
Instructions:
- By default, the controlled vocabulary functionality is disabled since it is not compatible with WAI Guidelines. To enable it, uncomment the following line in your dspace.cfg:#webui.controlledvocabulary.enable = true
- DSpace only has the license to redistribute the following controlled vocabularies:
- Norwegian Science Index (nsi.xml) - By default, this vocab is not used
- Swedish Research Subject Categories (srsc.xml) - When enabled, this vocab is used with the Subject (
) metadata field.Code Block dc.subject
- Each of the above controlled vocabularies is defined (in dspace/config/controlled-vocabularies/) via an XML with structure similar to:
Code Block <node id="acmccs98" label="ACMCCS98">
Code Block <isComposedBy>
Code Block <node id="A." label="General Literature">
Code Block <isComposedBy>
Code Block <node id="A.0" label="GENERAL"/>
Code Block <node id="A.1" label="INTRODUCTORY AND SURVEY"/>
Code Block ...
Code Block </isComposedBy>
Code Block </node>
Code Block ...
Code Block </isComposedBy>
Code Block </node>
- The above XML structure would generate a hierarchical controlled vocabulary with the following structure:
Code Block ACMCCS98
Code Block General Literature
Code Block GENERAL
Code Block INTRODUCTORY AND SURVEY
- Using this structure, if a submitter selected
in the above hierarchy, the item would be assigned a subject which is an aggregation of all terms above the selected term in the hierarchy, e.g.Code Block GENERAL
Code Block ACMCCS98::General Literature::GENERAL
- You may create your own custom controlled vocabulary by generating an XML structure for it similar to above. Once created, place your custom controlled vocabulary alongside the preexisting controlled vocabularies in dspace/config/controlled-vocabularies/
- There is a schema provided at dspace-source/docs/controlledvocabulary.xsd. The following fields are currently available in this XML Structure (optional attributes/fields are marked)
- represents a single term in the hierarchyCode Block <node>
(optional) - a unique identifier for this termCode Block id
- a label for this term. This is the actual controlled text displayed in DSpace and stored in the metadata for an item.Code Block label
(optional)- represents the "composed by" relationship between terms. So, in the example on the previous page,Code Block <isComposedBy>
is specified as being composed byCode Block General Literature
andCode Block GENERAL
Code Block INTRODUCTORY AND SURVEY
(optional) - similar toCode Block <isRelatedTo>
, but represents the "is related to" relationship between terms.Code Block <isComposedBy>
(optional) - specifies a note related to a term. This is never displayed but is useful for your own documentation/notes.Code Block <hasNote>
- To actually use a controlled vocabulary with the submission input forms (see image on previous page), you must specify the controlled vocabulary to use for a specific metadata field. This can be achieved using the
tag within input-forms.xml. For more information, see the notes on theCode Block <vocabulary>
tag in the section Alter submission input formsCode Block <vocabulary>
- Stop and restart Tomcat (See Quick Restart in Rebuild DSpace).