Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The DSpace Submission forms, defined in the submission-forms.xml file, allows the inclusion of value pairs that can be organized in lists in order to populate dropdowns or other multiple choice elements. If you explore the default submission-forms.xml file, you can see that a number of such value pair lists are already pre defined.

Example

Code Block
languagehtml/xml
<value-pairs value-pairs-name="common_identifiers" dc-term="identifier">
    <pair>
        <displayed-value>Gov't Doc #</displayed-value>
        <stored-value>govdoc</stored-value>
    </pair>
    <pair>
        <displayed-value>URI</displayed-value>
        <stored-value>uri</stored-value>
    </pair>
    <pair>
        <displayed-value>ISBN</displayed-value>
        <stored-value>isbn</stored-value>
    </pair>
</value-pairs>

...

Code Block
titleauthority.cfg
plugin.selfnamed.org.dspace.content.authority.ChoiceAuthority = \
 org.dspace.content.authority.DCInputAuthority, \
 org.dspace.content.authority.DSpaceControlledVocabulary

It's also possible to disable just the "Browse by" menu for a specific vocabulary in the user interface. For details on that, see the "webui.browse.vocabularies.disabled" setting in the dspace.cfg documented at Configuration Reference#HierarchicalBrowseIndexes

Additional configurations for Hierarchical Controlled Vocabularies

Each hierarchical controlled vocabulary supports additional configurations in the "authority.cfg" file (or local.cfg).  These settings override the default behavior of a Controlled Vocabulary in the "org.dspace.content.authority.DSpaceControlledVocabulary" Java class.

Property:

vocabulary.plugin.[vocab-name].hierarchy.store

Example Value:vocabulary.plugin.srsc.hierarchy.store = true
Informational Note:

Store entire hierarchy along with selected value.  Default is true

Property:

vocabulary.plugin.[vocab-name].hierarchy.suggest

Example Value:vocabulary.plugin.srsc.hierarchy.suggest = false
Informational Note:

Display the entire hierarchy in the suggestion list. Default is false.

Property:

vocabulary.plugin.[vocab-name].hierarchy.delimiter

Example Value:vocabulary.plugin.srsc.hierarchy.delimiter = "::"
Informational Note:

Delimiter to use when building hierarchy string.  Default is "::" (double colon)

Property:

vocabulary.plugin.[vocab-name].hierarchy.preloadLevel

Example Value:vocabulary.plugin.srsc.hierarchy.preloadLevel = 1
Informational Note:

The number of levels of the hierarchy to load at once (e.g. in the "Browse by [ vocab-name ]" in the user interface).  The value "1" means to just load the top level members of the hierarchy.  The value "2" means to load the top level members and their children.  The value "3" means to load the top level members, their children and their grandchildren.  Keep in mind, the "Browse by" options in the User Interface may be slower when you load more levels at once. Default is "1".

How to invoke a controlled vocabulary from submission-forms.xml

...