<setting> Element

This element describes a key/value configuration setting.

Parent Elements

settings

Attributes

Name	Type	Description	Required
name	string	The key name.	Yes
value	string	The value.	No

Child Elements

Name	Description	Required
value	The value, as string content. There can be, at most, one of these elements, as long as no value attribute is defined as well.	No
setting	Defines a nested key/value configuration setting. There can be any number of these elements.	No

Remarks

The setting value can be provided by either the value attribute or the value child element, but not both. Using the value child element can make it easier to configure complex settings. For example, it could be used to configure a setting that itself contains XML:

<setting name="Workstation:UnitWorkflow">
  <value><![CDATA[
    <Sequence xmlns="http://schemas.acuit.com/pinpoint/2020/xaml/workflows">
      <ScanComponent ComponentTypeName="Component 1" />
      <StartTestWorkflow TestTypeName="Test 1" WaitForCompletion="true" />
    </Sequence>]]>
  </value>
</setting>

Nested settings result in concatenated setting names, separated by colons. For example, consider the following XML:

<settings>
  <setting name="Section1">
    <setting name="Section2">
      <setting name="Name1" value="Value1" />
      <setting name="Name2" value="Value2" />
    </setting>
  </setting>
</settings>

The resulting settings will be:

• Section1:Section2:Name1 = Value1
• Section1:Section2:Name2 = Value2

See Key/Value Configuration Settings for more information about key/value configuration settings.