VOID expressions return no value but are used to perform other work. The VOID ADD_DVAL_PROP expression adds dimension value attributes to a dimension value.

This expression is unique in that it does not modify the current record. The attributes are information for an Guided Search application's user interface; the attributes are not record processing information for Forge or the MDEX Engine. For example, you might use attributes to indicate the display color or location of a dimension value. See the MDEX Engine Development Guide for details.

The dimension to modify can be given in either a DIMENSION_NAME or a DIMENSION_ID expression node; the dimension value to modify can be given in either a DVAL_PATH or DVAL_ID expression node. The properties to be added are given by one or more PROPERTY sub-expressions.

By default, if the dimension value already has attributes attached, the new attributes are simply added. If the optional REPLACE expression node is set to TRUE, any duplicate attributes are removed prior to adding the new ones.

By default, the modifications are made to the dimension value immediately. In some cases (for example with AutoGen), the specified dimension value may not exist at the time the expression is evaluated, so Forge should wait and make the specified changes after all records have been processed. To do this, the optional DELAY expression node should be set to TRUE.

See the EXPRESSION element for DTD and attribute information.

<EXPRESSION TYPE="VOID" NAME="ADD_DVAL_PROP">
   <EXPRNODE NAME="DIMENSION_NAME" VALUE="Colors"/>
   <EXPRNODE NAME="DVAL_PATH" VALUE="Colors/Red"/>
   <EXPRESSION TYPE="PROPERTY" NAME="IDENTITY">
      <EXPRNODE NAME="PROP_NAME" VALUE="display"/>
   </EXPRESSION>
</EXPRESSION>