VOID expressions return no value but are used to perform other work. The VOID SPLIT expression splits the values of a single property into multiple values of a new property, or into multiple properties.

Configure the expression as follows:

After performing the split, Forge trims leading and trailing white space from the new property values, so leading or trailing spaces do not have to be included in the delimiter. For example, if the value of the “Colors” property for a certain record is “red, blue, green”, and you split that value on the comma delimiter, with a new name of “Hue”, the output is three separate properties: “Hue1”=“red”, “Hue2”=“blue”, “Hue3”=“green”.

The default value of the optional ENUMERATE expression node is TRUE. If ENUMERATE is set to FALSE, all of the new values are assigned to a single new property. In the previous example, the result would be a single “Hue” property with the values “red”, “blue”, and “green," instead of three separate properties.

See the EXPRESSION element for DTD and attribute information.

<EXPRESSION TYPE="VOID" NAME="SPLIT">
   <EXPRNODE NAME="OLD_NAME" VALUE="Colors"/>
   <EXPRNODE NAME="NEW_NAME" VALUE="Hue"/>
   <EXPRNODE NAME="SPLIT" VALUE=","/>
   <EXPRNODE NAME="ENUMERATE" VALUE="TRUE"/>
</EXPRESSION>