A pluralising example
Suppose you have a need to create an XpressDox Variable which will contain either a singular or plural from a data element. Using the example of a Will in Working with repeated elements, we might want to use the word “child” or “children” in many places, and not want to use <<When(count(Child)…>> everywhere, but rather use a variable, e.g. <<GetV(‘childword’)>>.
There are a number of ways of setting the variable “childword” to the required value, but here is one that makes use of the concat function inside a <<SetV>> to concatenate the suffix “ren” to the word “child” when the number of Child data elements is greater than one:
<<If(count(Child) > 1)>>
Thereafter any execution of
<<GetV('childword')>> will put the correct variation of “child” or “children” into the merged document.
A file path example
Another use of the concat function would be to construct a file path given its constitutents. For example, suppose the drive, folder and file name are located in three separate data elements. Setting a variable to contain the full file path would look like this: