Versions Compared

Key

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

...

Files:

  • Wiki Markup
    {{\[dspace\]\/config/input-forms.xml}}

...

  • The <required> element contains the textual hint displayed to the submitter about why the field is required. Leave it empty for optional fields.
  • The <vocabulary> element is optional. It allows you to specify the controlled vocabulary (see Use Controlled Vocabularies for more information) that this field should select its values from. This field also has an optional closed attribute. If closed is set to true, a user can only select values from the controlled vocabulary. By default, closed is set to false, which allows a user to also enter in free text if he/she chooses. For example:
    Code Block
    <vocabulary closed="true">srsc</vocabulary>
    
  • Wiki Markup
    The name of the controlled vocabulary must correspond to the name of the XML file (without ".xml") which contains the vocabulary.  So, in the above example, {{srsc}} references the vocabulary specified in the file located at {{\[dspace\]/config/controlled-vocabularies/srsc.xml}}
  • Valid input types (for <input-type>) are:
    • "date"
    • "name" (two text boxes, labeled last and first name)
    • "onebox" (a one-line textbox)
    • "twobox" (two textboxes on a single line)
    • "dropdown" (for which you must specify a value-pairs-name attribute referring to the <value-pairs> list of allowed values, see Change a form value)
    • "qualdrop_value" (a textbox, which is preceded by a "qualifying" dropdown of values. Requires a value-pairs-name attribute, similar to "dropdown". Also requires <repeatable> is set to "true")
    • "textarea"
  • Setting the <repeatable> element to "true" creates an "Add more" button, which allows you to add multiple values into that particular field. Examples of this include the authors and keywords fields in the standard DSpace submission process.