VOID
expressions return no value but are used to
perform other work. The
VOID CLEAN_DVALS
expression removes ancestor
classifications from records.
CLEAN_DVALS
requires one or more
DIMENSION_ID
expression nodes to tell it which
dimensions to clean. You can also specify dimensions from more than one
DIMENSION_SOURCE
if necessary. One
DIMENSION_SOURCE
is required.
If a dimension value and one or more of its ancestors are assigned to
a record, a
CLEAN_DVALS
expression deletes the ancestor dimension
values, leaving only the child dimension value on the record. A dimension value
and one or more of its ancestors would be assigned to a record in a situation
where an ancestor and dimension leaf value are both properties of a single
record. This is the case in the following example for the properties “Blue” and
“Sky Blue”.
For example, suppose one navigation path within a “Colors” dimension
looked like this: Colors->Blue->Sky Blue. If a record has a property
value of “Blue” and a property value of “Sky Blue”, then both the parent
dimension value “Blue” and its child “Sky Blue” will be assigned to it. A
CLEAN_DVALS
expression would remove the dimension
value “Blue” from the record. If there were more levels of hierarchy (for
example, if the dimension value “Blue” were a grandparent or
great-grandparent), the
CLEAN_DVALS
expression would work in the same way;
only the child dimension value “Sky Blue” would remain on the record.
See the
EXPRESSION
element for DTD and attribute information.