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.
This expression adds an attribute named display to the Red dimension value.
<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>