SetRepeaterQualifier - XpressDox

When XpressDox builds an interview and there are repeating elements in the data set, those repeating elements are normally shown in a treeview with the name of the element (or the Caption which might have been set) followed by the value of the first data element in the form for that repeater.

For example, a repeating element Child might have three subordinate data elements, viz. Gender, Firstnames and Lastname.  If Gender were the first data element to be captured for each Child element, then the nodes in the treeview would look like:

Child F
Child F
Child M

for three children, being two girls and a boy. This is obviously not very useful.

SetRepeatQualifier can be used to make something more sensible appear in the treeview, for example:

«SetRepeaterQualifier(Child,<Firstnames> <Lastname>)»

The above three nodes would then look something like:

Child Mary Smith
Child Jane Smith
Child Harry Smith

A further embellishment is provided via the PositionInRepeater pseudo data element:
SetRepeatQualifier can be used to make something more sensible appear in the treeview, for example:

«SetRepeaterQualifier(Child,<PositionInRepeater>. <Firstnames> <Lastname>)»

The above nodes would then look something like:

Child 1. Mary Smith
Child 2. Jane Smith
Child 3. Harry Smith

Note the use of < and > to enclose the names of the data elements to be used to build up the qualifier. This is consistent with usage in other commands.

This command is only available in XpressDox version 4 and later.