Capturing fields and controlling the sequence of the XpressDox interview
In v14:
This article was written before the invention of the Manage Interview feature, introduced in v14. With Manage Interview, you can easily re-arrange fields on an interview with a drag-and-drop! And if you use the Question command, you can state that a field is for capture purposes only.
Before v14:
The commands in XpressDox which control the format of the interview do typically not appear on the interview unless they are required in the template being run. This mechanism allows, amongst others, the specification of all interview-layout commands in one template which is then included (with IncludeTemplate or IncludeCodeTemplate) by the templates requiring that layout; at the same time, only the data elements required for the creation of the merged document from the including template will be presented in the interview.
Forcing Capture
However, it may be that one or more data elements are required to be captured. The CaptureDataElement command will achieve this.
For example:
«ChooseFromRDBList(Gender,Male,Female)»
«CaptureDataElement(Gender)»
Controlling Sequence
The sequence of controls on an interview is determined by the first occurrence of the data element in the template. Thus:
«CaptureDataElement(BuyerGender)»
«ChooseFromRDBList(SellerGender,Male,Female)»
«ChooseFromRDBList(BuyerGender,Male,Female)»
will cause the radio button list for data element BuyerGender to appear in the interview before that for SellerGender.
Multiples
The CaptureDataElements variation of this command will permit the specification of more than one data element to be captured:
«CaptureDataElements(SellerGender,BuyerGender)»