SUNScholar/Submissions/Forms

Back to Submissions

Introduction
After defining the custom submission steps, you then define the forms to be used for your custom submission steps.

Step 1 - Define the custom form
Edit the "input-forms.xml" file: nano $HOME//dspace/config/input-forms.xml

For example:             

Step 2 - Design the custom form
This is where you define which dublin core elements are used per page per input field and in what order the input fields appear on the form.

Input fields have attributes, see example below and the notes at the bottom of this wiki page.

See example below:

dc title</dc-element> <dc-qualifier></dc-qualifier> true Title <input-type>onebox</input-type> Enter the main title of the item. Please enter a main title for this item. For a title in another language, click the "Add" button and submit.

dc</dc-schema> <dc-element>contributor</dc-element> <dc-qualifier>author</dc-qualifier> true Authors <input-type>name</input-type> Enter the names of the authors of this item. Please submit an author for this item.

dc</dc-schema> <dc-element>contributor</dc-element> <dc-qualifier>other</dc-qualifier> true Department <input-type>name</input-type> Enter the name of the department for this item.

dc</dc-schema> <dc-element>date</dc-element> <dc-qualifier>issued</dc-qualifier> false Date of Issue <input-type>date</input-type> Enter the date of publication or public distribution of this item.

dc</dc-schema> <dc-element>description</dc-element> <dc-qualifier>version</dc-qualifier> false Version <input-type>textarea</input-type> Enter a short description about the version of this item.

dc</dc-schema> <dc-element>identifier</dc-element> <dc-qualifier>citation</dc-qualifier> false Citation <input-type>onebox</input-type> Enter the standard citation for the previously issued instance of this item.

dc</dc-schema> <dc-element>description</dc-element> <dc-qualifier>uri</dc-qualifier> false URI <input-type>onebox</input-type> Enter description URI in this box.

dc</dc-schema> <dc-element>publisher</dc-element> <dc-qualifier></dc-qualifier> false Publisher <input-type>onebox</input-type> Enter the name of the publisher of the previously issued instance of this item.

dc</dc-schema> <dc-element>type</dc-element> <dc-qualifier></dc-qualifier> true Type <input-type value-pairs-name="common_types">dropdown</input-type> Select the type(s) of content of the item. To select more than one value in the list, you may have to hold down the "CTRL" or "Shift" key.

dc</dc-schema> <dc-element>subject</dc-element> <dc-qualifier></dc-qualifier> true Subject Keywords <input-type>twobox</input-type> Enter appropriate subject keywords or phrases below.

Setting the element to “true” creates an “Add more” button, which allows you to add multiple values into that particular field.

This is optional.

It allows you to specify the controlled vocabulary that this field should select its values from.

This field also has an optional  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: &lt;vocabulary closed=”true”&gt;srsc&lt;/vocabulary&gt;

The name of the controlled vocabulary must correspond to the name of the XML file (without “.xml”) which contains the vocabulary.

So  references the vocabulary specified in the file located at: <tt>$HOME//config/controlled-vocabularies/srsc.xml</tt>.

Valid input types 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  attribute referring to the   list of allowed values.
 * “qualdrop_value” (a textbox, which is preceded by a “qualifying” dropdown of values. Requires a   attribute, similar to “dropdown”.  Also requires   is set to “true”)
 * “textarea”

Contains the textual hint displayed to the submitter about why the field is required. Leave it empty for optional fields.

Definition of
To maintain uniformity of definitions for certain input fields it is possible to create custom lists to be used with a custom field.

For example, we created a custom list for academic departments. See example below. <value-pairs value-pairs-name="common_departments" dc-term="description"> <displayed-value>Africa Centre for HIV/AIDS Management</displayed-value> <stored-value>Africa Centre for HIV/AIDS Management</stored-value> <displayed-value>African Languages</displayed-value> <stored-value>African Languages</stored-value> <displayed-value>Afrikaans and Dutch</displayed-value> <stored-value>Afrikaans and Dutch</stored-value> <displayed-value>Agricultural Economics</displayed-value> <stored-value>Agricultural Economics</stored-value> <displayed-value>Agronomy</displayed-value> <stored-value>Agronomy</stored-value> <displayed-value>Anaesthesiology and Critical Care</displayed-value> <stored-value>Anaesthesiology and Critical Care</stored-value> <displayed-value>Ancient Studies</displayed-value> <stored-value>Ancient Studies</stored-value> <displayed-value>Animal Sciences</displayed-value> <stored-value>Animal Sciences</stored-value> <displayed-value>Biochemistry</displayed-value> <stored-value>Biochemistry</stored-value> <displayed-value>Biomedical Sciences: Anatomy and Histology</displayed-value> <stored-value>Biomedical Sciences: Anatomy and Histology</stored-value> <displayed-value>Biomedical Sciences: Medical Physiology</displayed-value> <stored-value>Biomedical Sciences: Medical Physiology</stored-value> <displayed-value>Biomedical Sciences: Molecular Biology and Human Genetics</displayed-value> <stored-value>Biomedical Sciences: Molecular Biology and Human Genetics</stored-value> <displayed-value>Botany and Zoology</displayed-value> <stored-value>Botany and Zoology</stored-value> <displayed-value>Business Management</displayed-value> <stored-value>Business Management</stored-value> <displayed-value>Centre for Chinese Studies</displayed-value> <stored-value>Centre for Chinese Studies</stored-value> <displayed-value>Centre for Health Professions Education</displayed-value> <stored-value>Centre for Health Professions Education</stored-value> <displayed-value>Centre for Renewable and Sustainable Energy Studies</displayed-value> <stored-value>Centre for Renewable and Sustainable Energy Studies</stored-value> <displayed-value>Chemistry and Polymer Science</displayed-value> <stored-value>Chemistry and Polymer Science</stored-value> <displayed-value>Civil Engineering</displayed-value> <stored-value>Civil Engineering</stored-value> <displayed-value>Conservation Ecology and Entomology</displayed-value> <stored-value>Conservation Ecology and Entomology</stored-value> <displayed-value>Curriculum Studies</displayed-value> <stored-value>Curriculum Studies</stored-value> <displayed-value>Drama</displayed-value> <stored-value>Drama</stored-value> <displayed-value>Earth Sciences</displayed-value> <stored-value>Earth Sciences</stored-value> <displayed-value>Economics</displayed-value> <stored-value>Economics</stored-value> <displayed-value>Education Policy Studies</displayed-value> <stored-value>Education Policy Studies</stored-value> <displayed-value>Educational Psychology</displayed-value> <stored-value>Educational Psychology</stored-value> <displayed-value>Electrical and Electronic Engineering</displayed-value> <stored-value>Electrical and Electronic Engineering</stored-value> <displayed-value>English</displayed-value> <stored-value>English</stored-value> <displayed-value>Food Science</displayed-value> <stored-value>Food Science</stored-value> <displayed-value>Forest and Wood Science</displayed-value> <stored-value>Forest and Wood Science</stored-value> <displayed-value>General Linguistics</displayed-value> <stored-value>General Linguistics</stored-value> <displayed-value>Genetics</displayed-value> <stored-value>Genetics</stored-value> <displayed-value>Geography and Environmental Studies</displayed-value> <stored-value>Geography and Environmental Studies</stored-value> <displayed-value>History</displayed-value> <stored-value>History</stored-value> <displayed-value>Horticulture</displayed-value> <stored-value>Horticulture</stored-value> <displayed-value>Industrial Engineering</displayed-value> <stored-value>Industrial Engineering</stored-value> <displayed-value>Industrial Psychology</displayed-value> <stored-value>Industrial Psychology</stored-value> <displayed-value>Information Science</displayed-value> <stored-value>Information Science</stored-value> <displayed-value>Institute for Wine Biotechnology</displayed-value> <stored-value>Institute for Wine Biotechnology</stored-value> <displayed-value>Interdisciplinary Health Sciences: Centre for Evidence-Based Health Care</displayed-value> <stored-value>Interdisciplinary Health Sciences: Centre for Evidence-Based Health Care</stored-value> <displayed-value>Interdisciplinary Health Sciences: Centre for Rehabilitation Studies</displayed-value> <stored-value>Interdisciplinary Health Sciences: Centre for Rehabilitation Studies</stored-value> <displayed-value>Interdisciplinary Health Sciences: Community Health</displayed-value> <stored-value>Interdisciplinary Health Sciences: Community Health</stored-value> <displayed-value>Interdisciplinary Health Sciences: Emergency Medicine</displayed-value> <stored-value>Interdisciplinary Health Sciences: Emergency Medicine</stored-value> <displayed-value>Interdisciplinary Health Sciences: Family Medicine and Primary Care</displayed-value> <stored-value>Interdisciplinary Health Sciences: Family Medicine and Primary Care</stored-value> <displayed-value>Interdisciplinary Health Sciences: Human Nutrition</displayed-value> <stored-value>Interdisciplinary Health Sciences: Human Nutrition</stored-value> <displayed-value>Interdisciplinary Health Sciences: Nursing Science</displayed-value> <stored-value>Interdisciplinary Health Sciences: Nursing Science</stored-value> <displayed-value>Interdisciplinary Health Sciences: Occupational Therapy</displayed-value> <stored-value>Interdisciplinary Health Sciences: Occupational Therapy</stored-value> <displayed-value>Interdisciplinary Health Sciences: Physiotherapy</displayed-value> <stored-value>Interdisciplinary Health Sciences: Physiotherapy</stored-value> <displayed-value>Interdisciplinary Health Sciences: Speech-Language and Hearing Therapy</displayed-value> <stored-value>Interdisciplinary Health Sciences: Speech-Language and Hearing Therapy</stored-value> <displayed-value>Journalism</displayed-value> <stored-value>Journalism</stored-value> <displayed-value>Logistics</displayed-value> <stored-value>Logistics</stored-value> <displayed-value>Mathematical Sciences</displayed-value> <stored-value>Mathematical Sciences</stored-value> <displayed-value>Mechanical and Mechatronic Engineering</displayed-value> <stored-value>Mechanical and Mechatronic Engineering</stored-value> <displayed-value>Medical Imaging and Clinical Oncology: Medical Physics</displayed-value> <stored-value>Medical Imaging and Clinical Oncology: Medical Physics</stored-value> <displayed-value>Medical Imaging and Clinical Oncology: Nuclear Medicine</displayed-value> <stored-value>Medical Imaging and Clinical Oncology: Nuclear Medicine</stored-value> <displayed-value>Medical Imaging and Clinical Oncology: Radiation Oncology</displayed-value> <stored-value>Medical Imaging and Clinical Oncology: Radiation Oncology</stored-value> <displayed-value>Medical Imaging and Clinical Oncology: Radiodiagnosis</displayed-value> <stored-value>Medical Imaging and Clinical Oncology: Radiodiagnosis</stored-value> <displayed-value>Medicine: Cardiology</displayed-value> <stored-value>Medicine: Cardiology</stored-value> <displayed-value>Medicine: Clinical Pharmacology</displayed-value> <stored-value>Medicine: Clinical Pharmacology</stored-value> <displayed-value>Medicine: Dermatology</displayed-value> <stored-value>Medicine: Dermatology</stored-value> <displayed-value>Medicine: Endocrinology</displayed-value> <stored-value>Medicine: Endocrinology</stored-value> <displayed-value>Medicine: Gastroenterology</displayed-value> <stored-value>Medicine: Gastroenterology</stored-value> <displayed-value>Medicine: General Internal Medicine</displayed-value> <stored-value>Medicine: General Internal Medicine</stored-value> <displayed-value>Medicine: General Medicine</displayed-value> <stored-value>Medicine: General Medicine</stored-value> <displayed-value>Medicine: Infectious Diseases</displayed-value> <stored-value>Medicine: Infectious Diseases</stored-value> <displayed-value>Medicine: Nephrology</displayed-value> <stored-value>Medicine: Nephrology</stored-value> <displayed-value>Medicine: Neurology</displayed-value> <stored-value>Medicine: Neurology</stored-value> <displayed-value>Medicine: Pulmonology</displayed-value> <stored-value>Medicine: Pulmonology</stored-value> <displayed-value>Medicine: Rheumatology</displayed-value> <stored-value>Medicine: Rheumatology</stored-value> <displayed-value>Mercantile Law</displayed-value> <stored-value>Mercantile Law</stored-value> <displayed-value>Microbiology</displayed-value> <stored-value>Microbiology</stored-value> <displayed-value>Modern Foreign Languages</displayed-value> <stored-value>Modern Foreign Languages</stored-value> <displayed-value>Music</displayed-value> <stored-value>Music</stored-value> <displayed-value>Obstetrics and Gynaecology</displayed-value> <stored-value>Obstetrics and Gynaecology</stored-value> <displayed-value>Old and New Testament</displayed-value> <stored-value>Old and New Testament</stored-value> <displayed-value>Paediatrics and Child Health</displayed-value> <stored-value>Paediatrics and Child Health</stored-value> <displayed-value>Pathology: Anatomical Pathology</displayed-value> <stored-value>Pathology: Anatomical Pathology</stored-value> <displayed-value>Pathology: Chemical Pathology</displayed-value> <stored-value>Pathology: Chemical Pathology</stored-value> <displayed-value>Pathology: Forensic Medicine</displayed-value> <stored-value>Pathology: Forensic Medicine</stored-value> <displayed-value>Pathology: Haematological Pathology</displayed-value> <stored-value>Pathology: Haematological Pathology</stored-value> <displayed-value>Pathology: Medical Microbiology</displayed-value> <stored-value>Pathology: Medical Microbiology</stored-value> <displayed-value>Pathology: Medical Virology</displayed-value> <stored-value>Pathology: Medical Virology</stored-value> <displayed-value>Philosophy</displayed-value> <stored-value>Philosophy</stored-value> <displayed-value>Physics</displayed-value> <stored-value>Physics</stored-value> <displayed-value>Physiological Sciences</displayed-value> <stored-value>Physiological Sciences</stored-value> <displayed-value>Plant Pathology</displayed-value> <stored-value>Plant Pathology</stored-value> <displayed-value>Political Science</displayed-value> <stored-value>Political Science</stored-value> <displayed-value>Practical Theology and Missiology</displayed-value> <stored-value>Practical Theology and Missiology</stored-value> <displayed-value>Private Law</displayed-value> <stored-value>Private Law</stored-value> <displayed-value>Process Engineering</displayed-value> <stored-value>Process Engineering</stored-value> <displayed-value>Psychiatry</displayed-value> <stored-value>Psychiatry</stored-value> <displayed-value>Psychology</displayed-value> <stored-value>Psychology</stored-value> <displayed-value>Public Law</displayed-value> <stored-value>Public Law</stored-value> <displayed-value>School for Defence Organisation and Resource Management</displayed-value> <stored-value>School for Defence Organisation and Resource Management</stored-value> <displayed-value>School for Geospatial Studies and Information Systems</displayed-value> <stored-value>School for Geospatial Studies and Information Systems</stored-value> <displayed-value>School for Human Resource Management</displayed-value> <stored-value>School for Human Resource Management</stored-value> <displayed-value>School for Security and Africa Studies: Military History</displayed-value> <stored-value>School for Security and Africa Studies: Military History</stored-value> <displayed-value>School for Security and Africa Studies: Military Strategy</displayed-value> <stored-value>School for Security and Africa Studies: Military Strategy</stored-value> <displayed-value>School for Security and Africa Studies: Political Science (Mil)</displayed-value> <stored-value>School for Security and Africa Studies: Political Science (Mil)</stored-value> <displayed-value>School of Accounting</displayed-value> <stored-value>School of Accounting</stored-value> <displayed-value>School of Public Leadership</displayed-value> <stored-value>School of Public Leadership</stored-value> <displayed-value>School of Science and Technology</displayed-value> <stored-value>School of Science and Technology</stored-value> <displayed-value>Social Work</displayed-value> <stored-value>Social Work</stored-value> <displayed-value>Sociology and Social Anthropology</displayed-value> <stored-value>Sociology and Social Anthropology</stored-value> <displayed-value>Soil Science</displayed-value> <stored-value>Soil Science</stored-value> <displayed-value>Sport Science</displayed-value> <stored-value>Sport Science</stored-value> <displayed-value>Statistics and Actuarial Science</displayed-value> <stored-value>Statistics and Actuarial Science</stored-value> <displayed-value>Surgical Sciences: Cardiothoracic Surgery</displayed-value> <stored-value>Surgical Sciences: Cardiothoracic Surgery</stored-value> <displayed-value>Surgical Sciences: General Surgery</displayed-value> <stored-value>Surgical Sciences: General Surgery</stored-value> <displayed-value>Surgical Sciences: Neurosurgery</displayed-value> <stored-value>Surgical Sciences: Neurosurgery</stored-value> <displayed-value>Surgical Sciences: Ophthalmology</displayed-value> <stored-value>Surgical Sciences: Ophthalmology</stored-value> <displayed-value>Surgical Sciences: Orthopaedic Surgery</displayed-value> <stored-value>Surgical Sciences: Orthopaedic Surgery</stored-value> <displayed-value>Surgical Sciences: Otorhinolaryngology</displayed-value> <stored-value>Surgical Sciences: Otorhinolaryngology</stored-value> <displayed-value>Surgical Sciences: Paediatric Surgery</displayed-value> <stored-value>Surgical Sciences: Paediatric Surgery</stored-value> <displayed-value>Surgical Sciences: Plastic and Reconstructive Surgery</displayed-value> <stored-value>Surgical Sciences: Plastic and Reconstructive Surgery</stored-value> <displayed-value>Surgical Sciences: Surgery</displayed-value> <stored-value>Surgical Sciences: Surgery</stored-value> <displayed-value>Surgical Sciences: Urology</displayed-value> <stored-value>Surgical Sciences: Urology</stored-value> <displayed-value>Systematic Theology and Ecclesiology</displayed-value> <stored-value>Systematic Theology and Ecclesiology</stored-value> <displayed-value>University of Stellenbosch Business School</displayed-value> <stored-value>University of Stellenbosch Business School</stored-value> <displayed-value>Visual Arts</displayed-value> <stored-value>Visual Arts</stored-value> <displayed-value>Viticulture and Oenology</displayed-value> <stored-value>Viticulture and Oenology</stored-value> <displayed-value>Other</displayed-value> <stored-value>Other</stored-value> </value-pairs>