Versions Compared

Key

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

...

  1. Not a replacement for text metadata value.Metadata fields still have text values.
    • The text value of a metadata field does not have to be derived from the authority, even if authority control is required for that field.
  2. Configured by field. The authority control status of each field is independently configured, but it affects all values of that field.
  3. Authority control can be optional or required. When optional, metadata values may take on values that did not come from the authority.
  4. Authority values are ubiquitous. Authority values are accessible by crosswalk

    Footnote

    Crosswalk in DSpace context is a functionality that allows DSpace metadata format to be translated to external formats.

    plugins, in the UI, through OAI-PMH, etc.

    • All of those context can detect whether a value is authority-controlled or not by testing for presence of an authority key.
  5. Text-based searching and indexing is unchanged. Since metadata values still have text values, the browse and search systems will work unchanged.
  6. Choice behavior decoupled. The selection and choice mechanisms can be invoked independently (e.g. in the submit UI) of authority control.

...

We will consider adding an administrative UI to detect and list these metadata problems.

Display and CrosswalkCrosswalk  

Every metadata value potentially includes values for an authority key, and an authority confidence. They are only present when the field is under authority control, and when there is an actual authority value, otherwise they are absent (e.g. in the DIM XML representation) or null.

The presentation UI can call on a generic method to get the canonical display string for an authority key, but it is welcome to interpret it in custom code to present a more detailed view. For example, one site may want to customize their Item display so a personal name appears with a link to their page on the institution's social networking site, which it obtains through the authority key.

Dissemination crosswalks will crosswalks will also receive the authority key so they can pass that knowledge on through OAI-PMH, exported packages, and any other dissemination vehicles.

...

There are symbolic constants (and corresponding String symblic names) for the confidence levels defined in the Choices class:

...

IconConfidenceConfidence value (stored in metadatavalue)DescriptionMirage 2 Glyphicon rendering

Image Added

ACCEPTED600This authority value has been confirmed as accurate by an interactive user or authoritative policy

thumbs-up

Image Added

UNCERTAIN

...

500Authority value is singular and valid but has not been seen and accepted by a human, so its provenance is uncertaincog

Image Added

AMBIGUOUS

...

400There are multiple matching authority values of equal validityquestion-sign

Image Added

NOTFOUND

...

300There are no matching answers from the authoritythumbs-down

Image Added

FAILED

...

200The authority encountered an internal failure in trying to match the valuewarning-sign

REJECTED

...

100The authority recommends this submission be rejected

Image Added

NOVALUE

...

0No reasonable confidence value is available

...

ban-circle

Image Added

UNSET-1No confidence value has been set (default value in the DB table)remove

The icon rendering in the XMLUI Mirage 2 theme takes place in choice-authority-control.xsl.

Separation of Choices from Authority Control

...

Since choice management and authority control affect the operation of the interactive submission pages, there is naturally some interdependence with that configuration as well. This table shows how the data type chosen for a metadata field affects choice and authority management:

input-type (from input-forms.xml)

'lookup' Presentation Style

'suggest' Presentation Style

'select' Presentation Style

Authority Control

onebox

yes

yes

yes

supported

twobox

yes

yes

yes

supported

textarea

yes

yes

yes

supported

name

yes

NO

NO

supported

date

NO

NO

NO

n/a

series

NO

NO

NO

not tested

dropdown

NO

NO

yes

NO

qualdrop_value

NO

NO

NO

NO

list

NO

NO

???

not tested

Other Restrictions

Plugins and "Select" Presentation Style

...

Code Block
plugin.named.org.dspace.content.authority.ChoiceAuthority = \
  org.dspace.content.authority.SampleAuthority = Sample, \
  org.dspace.content.authority.LCNameAuthority = LCNameAuthority, \
  org.dspace.content.authority.SHERPARoMEOPublisher = SRPublisher, \
  org.dspace.content.authority.SHERPARoMEOJournalTitle = SRJournalTitle, \
  org.dspace.content.authority.SolrAuthority = SolrAuthorAuthority

Automatic Choice Authority from Configurable Submission value-pairs

The default configuration also includes a special self-named plugin that picks up all the value-pairs elements defined in your input-forms.xml configuration and makes them available as choice authorities (especially suitable for the select presentation style(smile):

Code Block
plugin.selfnamed.org.dspace.content.authority.ChoiceAuthority = \
  org.dspace.content.authority.DCInputAuthority

Some of the ChoiceAuthority instances available in the default configuration are:

  • LCNameAuthority - Sample Library of Congress (USA) name authority - NOT for serious use.
  • SRPublisher - Journal Publisher names based on SHERPA/RoMEO database
  • SRJournalTitle - Journal Titles based on SHERPA/RoMEO database

...