Creating or configuring forms > Configuring the <components> element > Configuring a table map

6.1.15 Configuring a table map

A table map is a component that allows users to add an arbitrary amount of key-value pairs. It is configured using the <table-map> element. This component consists of a table with three columns and an Add button at the bottom for adding more rows to the table. The first column is an icon to remove existing rows from the table. The component in the second column is the "key" component. All key components must have a unique value for the table map to be considered valid. The component in the last column is the "value" component.

To add a new key-value pair to the table, the user clicks Add. This adds a new row to the table with the three columns explained earlier. The user can then fill in the values for these components as desired. A user who wants to remove the key and its corresponding value from the table, clicks the Remove icon to remove that row.

To add/delete/modify a table map

  1. Open the appropriate XML file located in the Viewpoint home directory. Locate the <components> element.
  2. Create the <component> with a unique id.
  3. Insert the <table-map> element.
  4. Configure the key component by inserting <key-component> within <table-map>. Give the component a unique id and set it up as you would if the component stood alone.

    5. The table accepts any component except components that contain lists or are tables themselves. For example, a table map cannot contain a key component of a table map.

  5. Configure the value component by inserting <value-component> within <table-map>. Give the component a unique id and set it up as you would if the component stood alone.

    The table accepts any component except components that contain lists or are tables themselves. For example, a table map cannot contain a key component of a table map.

    <component id="genericResources" required="false">
  <description>Generic Resources</description>
  <table-map>
    <key-component id="genericResourcesKey">
      <select-values>
        <select-value api-value="fastio" display-value="Fast I/O" />
        <select-value api-value="san" display-value="Extra Storage" />
        <select-value api-value="matlab" display-value="MATLAB Licenses" />
        <select-value api-value="matlab" display-value="MATLAB Licenses" />
        <select-value api-value="bandwidth" display-value="Bandwidth" />
      </select-values>
    </key-component>
    <value-component id="genericResourcesValue">
      <number-value type="int">
        <default>0</default>
        <minimum inclusive="true">0</minimum>
        <maximum inclusive="true">10000</maximum>
        <step>1</step>
      </number-value>
    </value-component>
  </table-map>
</component>

    The key is a list of generic resources and the value is the amount requested for each resource.

Related topics 

 

© 2012 Adaptive Computing