Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add section: "Add or edit authority controlled metadata fields"

...

Step 3: Click on the “Save” button to continue saving changes or “Discard” to cancel changes made in the metadata fields. A success prompt confirming Metadata updates will appear as shown below.


Add or edit authority controlled metadata fields

Some metadata fields may be configured to use controlled authority values. When adding or editing metadata in fields configured with such authorities, the metadata input field adjusts to enable the selection of these controlled values.

Three different presentations are offered for editing/selecting authority-controlled metadata:

  • Dropdown field: for metadata fields controlled by a list of value-pairs defined in submission-form.xml.
  • Pop-up tree selector: for metadata fields controlled by Hierarchical Taxonomies or Controlled Vocabularies.
  • Autocomplete field: for authority-controlled metadata fields with authority keys.

See Authority Control of Metadata Values for more information.

The following sections show how these fields are presented when adding a new metadata. These fields will also be displayed similarly when editing an authority-controlled metadata field.

Metadata fields controlled by a list of value-pairs

When a metadata controlled by a list of value-pairs is created, a dropdown is displayed to select the value:

Image Added


After selecting a value and confirming it:

Image Added


The new metadata is added. Note that once the change is confirmed, it will display the value that is internally stored, whereas during editing, it shows the displayed value configured in the list of pairs.

Image Added

imagen.pngImage AddedAs with other fields, click on the “Save” button to continue saving changes or “Discard” to cancel changes made in the metadata fields.

Metadata fields controlled by Hierarchical Taxonomies or Controlled Vocabularies

When a metadata controlled by a taxonomy list or controlled vocabulary is created, a field is displayed as follows:

Image Added


Clicking on the field opens a pop-up to select the controlled value:

Image Added


Once selected, it will be displayed in the field:

Image Added


After confirming the value, the field is displayed again with the value that is internally stored once the changes are saved.

Image Added

As with other fields, click on the “Save” button to continue saving changes or “Discard” to cancel changes made in the metadata fields.

Authority controlled metadata fields with authority keys

When creating metadata controlled by an authority with authority keys, a group of fields with the following elements will be displayed as follows:

  • A main input field with the metadata value
  • A secondary field for the authority key
  • An attached icon to display the associated confidence level with the key

Image Added


Entering text in the main field will suggest options to select controlled values as shown in the image:

Image Added


When selecting one of the values, the selected value along with the associated key will be displayed in the corresponding fields, and the confidence value will display the icon to confirm that it is a value accepted by a user:

Image Added


Once the change is confirmed, the associated authority key will be displayed along with the icon showing the confidence value:

Image Added

Fields that have an associated authority key with a minimum confidence value will be displayed in the metadata list with the corresponding authority and confidence icon.

Editing or removing an authority key

It is possible to edit the authority key directly. To do so, first unlock the field for editing by clicking the button with the lock icon:

Image Added


Edit the field with the desired changes:

Image Added


To remove the authority key, empty the field. The field will be displayed without the key before saving:

Image Added


To change the authority key, edit the value. The key value will be modified, and the associated confidence value will be set as accepted by the user:

Image Added

Confidence values

The following table shows the possible confidence values and the icons used by default:

IconConfidence

Confidence value

(stored in metadatavalue)

DescriptionDisplayed when not editing

Image Added

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

Yes

Image Added

UNCERTAIN500Authority value is singular and valid but has not been seen and accepted by a human, so its provenance is uncertainYes

Image Added

AMBIGUOUS400There are multiple matching authority values of equal validityYes

Image Added

NOTFOUND300There are no matching answers from the authorityYes

Image Added

FAILED200The authority encountered an internal failure in trying to match the valueYes

Image Added

REJECTED100The authority recommends this submission be rejectedYes

Image Added

NOVALUE0No reasonable confidence value is availableNo

Image Added

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