Configuring the <components> element

Creating or configuring forms > Configuring the <components> element

6.1 Configuring the <components> element

To configure the components element

In the configurable XML file corresponding to the form you are creating, usually in the Viewpoint home directory, locate the <components> element.
For each input, insert a <component> element inside <components>. Assign the inserted component a unique id such as "priority". For example:

<components>
  ...
    <component id="priority">...</component>
  ...
</components>

Apply the description attribute of <component> to any string you want to use as a label in the user interface for the component. The default is an empty string.
Use the required attribute of <component> to specify whether the component is required. (The user must enter data to pass page validation.) The default is "false".

The <label> component does not support the required attribute.

Use the editable attribute of <component> to specify whether the component is editable by the user. The default is "true".

The <label> component does not support the editable attribute.

Use the permission attribute of <component> to specify which permissions are required to view the component. The value can be any permission. See Setting permissions.

<component id="priority" required="false" permission="power-user">
  <description>Priority</description>
  <number-value type="int">
    <default>0</default>
    <minimum inclusive="true">-10000</minimum>
    <maximum inclusive="true">10000</maximum>
    <step>1</step>
  </number-value>
</component>

The user must have the "power-user" permission to see the priority component.

Configure any of the following components:
- ACL (Access Control List) Editor (Configuring an access control list)
- Help Text
- Check Box (Configuring a checkbox)
- Date Box (Configuring a date box)
- Duration Components
  - Duration Text Box (Configuring a duration text box)
  - Duration Spinners (Configuring a duration spinner)
- File Upload (Configuring an upload file componenet)
- Inferred Value (Configuring an inferred values drop-down list)
- Label (Configuring a label)
- List Box (drop-down, single selection) (Configuring a list box)
- List Editor (Configuring a list editor)
- Multi-select List Box (Configuring a multi-select list box)
- Number Spinner (Configuring a number spinner)
- Radio Button Selector (Configuring a radio button selector)
- Script Upload (Configuring a script upload component)
- Suggest Box (Configuring a suggest box)
- Table Map (Configuring a table map)
- Text Box (Configuring a text box)
  - Password Text Box (Configuring a text box) Add Bookmark
Set any desired component rules. See Setting component rules.