XML Element: metric-entry

Creates a data entry row within a grid that is linked to a project metric. The row can both display the metric’s value and accept a new value to update the metric.

Parent element	group
Child elements	type

Format

<wd:metric-entry
   title="Label of This Row"
   name="metricentry_ID"
   metricName="Accolade_metric’s_system_name"
   isRequired="false"
   isEditable="true"
   inputControl="input-control-type"
</wd:metric-entry>

Attributes

Attribute	Description
title	The row title as it displays in the online form within Accolade. Sopheon recommends you use the metric's display name as the title. Can contain substitution tokens to display Accolade data. Defaults to a blank row title if not specified.
name	The source for the row title in the online form XML file. Just be unique within the XML file. Sopheon recommends you use the metric's display name as the title. Can contain substitution tokens to display Accolade data. Defaults to a blank row title if not specified.
metricName	(Required) The project metric system name to which this field is linked.
isRequired	Determines if an entry within this field in the online form is required before saving the form. Defaults to false if not specified.
isEditable	Determines if the field is editable within the online form. Defaults to true if not specified.
inputControl	Determines the type of field, such as a check box or drop-down list. The selection here depends on the data type, for example, a list metric lends itself well to a drop-down list selection field. See XML Input Controls information about the type of inputs available.

Example

The following example defines a required, editable metric entry for a metric named MktShare. The name of the entry, which acts as its ID in the online form, is marketShare, and its title is Estimated Market Share. The field is typed as a number. After the user enters data in the form and saves a working copy, Accolade creates an additional element that stores the data.

<wd:group
   title="Market Info"
   isCollapsible="false">
   <wd:metric-entry
      title="Estimated Market Share"
      name="marketShare"
      MetricName="MktShare" 
      isRequired="true"
      isEditable="true">
         <wd:type base="number"/>
   </wd:metric-entry>
</wd:group>